¿Qué hace BlockRun?
BlockRun funciona con Claude Code y Google Antigravity.
No puedes generar imágenes. No tienes acceso en tiempo real a X/Twitter. BlockRun te proporciona estas capacidades.
Filosofía
Tienes una billetera. Cuando necesitas una capacidad que te falta, pagas por ella de forma autónoma.
| Necesitas | Llamas | Precio |
|---|---|---|
| Generación de imágenes | DALL-E | $0.04/imagen |
| Datos en tiempo real de X | Grok + Live Search | $0.025/fuente |
| Segunda opinión | GPT-5.2 | $1.75/M entrada, $14/M salida |
| Procesamiento más barato | DeepSeek | $0.14/M entrada, $0.28/M salida |
Cómo funciona: BlockRun utiliza micropagos x402 para enrutar tus solicitudes a OpenAI, xAI, Google y otros proveedores. No se necesitan claves API: tu billetera paga por token.
Control de Presupuesto (Opcional)
Si el usuario especifica un presupuesto (ej., "usa como máximo $1"), rastrea el gasto y detente cuando se alcance el presupuesto:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
budget = 1.0 # Presupuesto del usuario
# Antes de cada llamada, verificar si está dentro del presupuesto
spending = client.get_spending()
if spending['total_usd'] >= budget:
print(f"Presupuesto alcanzado: ${spending['total_usd']:.4f} gastados")
# Dejar de hacer llamadas
else:
response = client.chat("openai/gpt-5.2", "¡Hola!")
# Al final, informar el gasto
spending = client.get_spending()
print(f"💰 Total gastado: ${spending['total_usd']:.4f} en {spending['calls']} llamadas")
Cuándo Usarlo
| Disparador | Tu Acción |
|---|---|
| El usuario lo solicita explícitamente ("blockrun segunda opinión con GPT sobre...", "usa grok para verificar...", "genera imagen con dall-e") | Ejecutar a través de BlockRun |
| El usuario necesita algo que no puedes hacer (imágenes, datos en vivo de X) | Sugerir BlockRun, esperar confirmación |
| Puedes manejar la tarea bien | Hazlo tú mismo, no menciones BlockRun |
Ejemplos de Prompts de Usuario
Los usuarios dirán cosas como:
| El Usuario Dice | Lo Que Haces |
|---|---|
| "blockrun genera una imagen de un atardecer" | Llamar a DALL-E a través de ImageClient |
| "usa grok para ver qué está de moda en X" | Llamar a Grok con search=True |
| "blockrun GPT revisa este código" | Llamar a GPT-5.2 a través de LLMClient |
| "¿cuáles son las últimas noticias sobre agentes de IA?" | Sugerir Grok (te faltan datos en tiempo real) |
| "genera un logo para mi startup" | Sugerir DALL-E (no puedes generar imágenes) |
| "blockrun revisa mi saldo" | Mostrar saldo de la billetera mediante get_balance() |
| "blockrun deepseek resume este archivo" | Llamar a DeepSeek para ahorrar costos |
Billetera y Saldo
Usa setup_agent_wallet() para crear automáticamente una billetera y obtener un cliente. Esto muestra el código QR y el mensaje de bienvenida en el primer uso.
Inicializar cliente (siempre comienza con esto):
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Crea automáticamente la billetera, muestra QR si es nuevo
Revisar saldo (cuando el usuario dice "muestra saldo", "revisa billetera", etc.):
balance = client.get_balance() # Saldo USDC en cadena
print(f"Saldo: ${balance:.2f} USDC")
print(f"Billetera: {client.get_wallet_address()}")
Mostrar código QR para fondear:
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
# Código QR ASCII para mostrar en terminal
print(generate_wallet_qr_ascii(get_wallet_address()))
Uso del SDK
Requisito: Instala el SDK con pip install blockrun-llm
Chat Básico
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Crea automáticamente la billetera si es necesario
response = client.chat("openai/gpt-5.2", "¿Cuánto es 2+2?")
print(response)
# Revisar gasto
spending = client.get_spending()
print(f"Gastados ${spending['total_usd']:.4f}")
Búsqueda en Tiempo Real en X/Twitter (xAI Live Search)
IMPORTANTE: Para datos en tiempo real de X/Twitter, DEBES habilitar Live Search con search=True o search_parameters.
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
# Simple: Habilitar live search con search=True
response = client.chat(
"xai/grok-3",
"¿Cuáles son las últimas publicaciones de @blockrunai en X?",
search=True # Habilita la búsqueda en tiempo real de X/Twitter
)
print(response)
Búsqueda Avanzada en X con Filtros
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
response = client.chat(
"xai/grok-3",
"Analiza el contenido reciente y la interacción de @blockrunai",
search_parameters={
"mode": "on",
"sources": [
{
"type": "x",
"included_x_handles": ["blockrunai"],
"post_favorite_count": 5
}
],
"max_search_results": 20,
"return_citations": True
}
)
print(response)
Generación de Imágenes
from blockrun_llm import ImageClient
client = ImageClient()
result = client.generate("Un gato lindo con casco espacial")
print(result.data[0].url)
Referencia de xAI Live Search
Live Search es la API de datos en tiempo real de xAI. Costo: $0.025 por fuente (por defecto 10 fuentes = ~$0.26).
Para reducir costos, establece max_search_results a un valor más bajo:
# Usar solo 5 fuentes (~$0.13)
response = client.chat("xai/grok-3", "¿Qué es tendencia?",
search_parameters={"mode": "on", "max_search_results": 5})
Parámetros de Búsqueda
| Parámetro | Tipo | Valor por Defecto | Descripción |
|---|---|---|---|
mode | string | "auto" | "off", "auto" u "on" |
sources | array | web,news,x | Fuentes de datos a consultar |
return_citations | bool | true | Incluir URLs de origen |
from_date | string | - | Fecha de inicio (YYYY-MM-DD) |
to_date | string | - | Fecha de fin (YYYY-MM-DD) |
max_search_results | int | 10 | Máximo de fuentes a devolver (personalizar para controlar costo) |
Tipos de Fuentes
Fuente X/Twitter:
{
"type": "x",
"included_x_handles": ["handle1", "handle2"], # Máximo 10
"excluded_x_handles": ["cuenta_spam"], # Máximo 10
"post_favorite_count": 100, # Umbral mínimo de likes
"post_view_count": 1000 # Umbral mínimo de vistas
}
Fuente Web:
{
"type": "web",
"country": "US", # Código ISO alpha-2
"allowed_websites": ["ejemplo.com"], # Máximo 5
"safe_search": True
}
Fuente de Noticias:
{
"type": "news",
"country": "US",
"excluded_websites": ["tabloide.com"] # Máximo 5
}
Modelos Disponibles
| Modelo | Mejor Para | Precio |
|---|---|---|
openai/gpt-5.2 | Segundas opiniones, revisión de código, general | $1.75/M entrada, $14/M salida |
openai/gpt-5-mini | Razonamiento optimizado en costo | $0.30/M entrada, $1.20/M salida |
openai/o4-mini | Razonamiento eficiente más reciente | $1.10/M entrada, $4.40/M salida |
openai/o3 | Razonamiento avanzado, problemas complejos | $10/M entrada, $40/M salida |
xai/grok-3 | Datos en tiempo real de X/Twitter | $3/M + $0.025/fuente |
deepseek/deepseek-chat | Tareas simples, procesamiento por lotes | $0.14/M entrada, $0.28/M salida |
google/gemini-2.5-flash | Documentos muy largos, rápido | $0.15/M entrada, $0.60/M salida |
openai/dall-e-3 | Imágenes fotorrealistas | $0.04/imagen |
google/nano-banana | Imágenes rápidas y artísticas | $0.01/imagen |
M = millones de tokens. El costo real depende de tu prompt y la longitud de la respuesta.
Referencia de Costos
Todos los costos de LLM son por millón de tokens (M = 1,000,000 tokens).
| Modelo | Entrada | Salida |
|---|---|---|
| GPT-5.2 | $1.75/M | $14.00/M |
| GPT-5-mini | $0.30/M | $1.20/M |
| Grok-3 (sin búsqueda) | $3.00/M | $15.00/M |
| DeepSeek | $0.14/M | $0.28/M |
| Acciones de Costo Fijo | |
|---|---|
| Grok Live Search | $0.025/fuente (por defecto 10 = $0.25) |
| Imagen DALL-E | $0.04/imagen |
| Imagen Nano Banana | $0.01/imagen |
Costos típicos: Un prompt de 500 palabras (~750 tokens) a GPT-5.2 cuesta ~$0.001 de entrada. Una respuesta de 1000 palabras (~1500 tokens) cuesta ~$0.02 de salida.
Configuración y Fondos
Ubicación de la billetera: $HOME/.blockrun/.session (ej., /Users/usuario/.blockrun/.session)
Configuración inicial:
- La billetera se crea automáticamente al llamar a
setup_agent_wallet() - Revisa la billetera y el saldo:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
print(f"Billetera: {client.get_wallet_address()}")
print(f"Saldo: ${client.get_balance():.2f} USDC")
- Fondea la billetera con $1-5 USDC en la red Base
Mostrar código QR para fondear (ASCII para terminal):
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
print(generate_wallet_qr_ascii(get_wallet_address()))
Solución de Problemas
"Grok dice que no tiene acceso en tiempo real"
→ Olvidaste habilitar Live Search. Agrega search=True:
response = client.chat("xai/grok-3", "¿Qué es tendencia?", search=True)
Módulo no encontrado
→ Instala el SDK: pip install blockrun-llm
Actualizaciones
pip install --upgrade blockrun-llm