O que BlockRun faz?
BlockRun funciona com Claude Code e Google Antigravity.
Você não pode gerar imagens. Você não tem acesso em tempo real ao X/Twitter. BlockRun concede essas capacidades.
Filosofia
Você tem uma carteira. Quando precisar de uma capacidade que não possui, você paga por ela de forma autônoma.
| Você Precisa | Você Chama | Preço |
|---|---|---|
| Geração de imagens | DALL-E | $0,04/imagem |
| Dados em tempo real do X | Grok + Live Search | $0,025/fonte |
| Segunda opinião | GPT-5.2 | $1,75/M entrada, $14/M saída |
| Processamento mais barato | DeepSeek | $0,14/M entrada, $0,28/M saída |
Como funciona: BlockRun usa micropagamentos x402 para rotear suas requisições para OpenAI, xAI, Google e outros provedores. Sem necessidade de chaves de API – sua carteira paga por token.
Controle de Orçamento (Opcional)
Se o usuário especificar um orçamento (ex.: "use no máximo $1"), monitore os gastos e pare quando o orçamento for atingido:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
budget = 1.0 # Orçamento do usuário
# Antes de cada chamada, verifique se está dentro do orçamento
spending = client.get_spending()
if spending['total_usd'] >= budget:
print(f"Orçamento atingido: ${spending['total_usd']:.4f} gastos")
# Pare de fazer chamadas
else:
response = client.chat("openai/gpt-5.2", "Olá!")
# Ao final, reporte os gastos
spending = client.get_spending()
print(f"💰 Total gasto: ${spending['total_usd']:.4f} em {spending['calls']} chamadas")
Quando Usar
| Gatilho | Sua Ação |
|---|---|
| Usuário solicita explicitamente ("blockrun segunda opinião com GPT sobre...", "use grok para verificar...", "gere imagem com dall-e") | Execute via BlockRun |
| Usuário precisa de algo que você não pode fazer (imagens, dados ao vivo do X) | Sugira BlockRun, aguarde confirmação |
| Você consegue realizar a tarefa bem sozinho | Faça você mesmo, não mencione BlockRun |
Exemplos de Prompts do Usuário
Os usuários dirão coisas como:
| Usuário Diz | O Que Você Faz |
|---|---|
| "blockrun gere uma imagem de um pôr do sol" | Chame DALL-E via ImageClient |
| "use grok para verificar o que está em alta no X" | Chame Grok com search=True |
| "blockrun GPT revise este código" | Chame GPT-5.2 via LLMClient |
| "quais são as últimas notícias sobre agentes de IA?" | Sugira Grok (você não tem dados em tempo real) |
| "gere um logotipo para minha startup" | Sugira DALL-E (você não pode gerar imagens) |
| "blockrun verifique meu saldo" | Mostre o saldo da carteira via get_balance() |
| "blockrun deepseek resuma este arquivo" | Chame DeepSeek para economia de custos |
Carteira e Saldo
Use setup_agent_wallet() para criar automaticamente uma carteira e obter um cliente. Isso mostra o código QR e a mensagem de boas-vindas no primeiro uso.
Inicialize o cliente (sempre comece com isso):
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Cria carteira automaticamente, mostra QR se nova
Verifique o saldo (quando o usuário disser "mostrar saldo", "verificar carteira", etc.):
balance = client.get_balance() # Saldo USDC on-chain
print(f"Saldo: ${balance:.2f} USDC")
print(f"Carteira: {client.get_wallet_address()}")
Mostre o código QR para financiamento:
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
# QR ASCII para exibição no terminal
print(generate_wallet_qr_ascii(get_wallet_address()))
Uso do SDK
Pré-requisito: Instale o SDK com pip install blockrun-llm
Chat Básico
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet() # Cria carteira automaticamente se necessário
response = client.chat("openai/gpt-5.2", "Quanto é 2+2?")
print(response)
# Verifique os gastos
spending = client.get_spending()
print(f"Gastos ${spending['total_usd']:.4f}")
Pesquisa em Tempo Real no X/Twitter (xAI Live Search)
IMPORTANTE: Para dados em tempo real do X/Twitter, você DEVE ativar o Live Search com search=True ou search_parameters.
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
# Simples: Ative a pesquisa ao vivo com search=True
response = client.chat(
"xai/grok-3",
"Quais são as últimas postagens de @blockrunai no X?",
search=True # Ativa pesquisa em tempo real no X/Twitter
)
print(response)
Pesquisa Avançada no X com Filtros
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
response = client.chat(
"xai/grok-3",
"Analise o conteúdo recente e engajamento 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)
Geração de Imagens
from blockrun_llm import ImageClient
client = ImageClient()
result = client.generate("Um gato fofo usando capacete espacial")
print(result.data[0].url)
Referência do xAI Live Search
Live Search é a API de dados em tempo real do xAI. Custo: $0,025 por fonte (padrão 10 fontes = ~$0,26).
Para reduzir custos, defina max_search_results para um valor menor:
# Use apenas 5 fontes (~$0,13)
response = client.chat("xai/grok-3", "O que está em alta?",
search_parameters={"mode": "on", "max_search_results": 5})
Parâmetros de Pesquisa
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
mode | string | "auto" | "off", "auto" ou "on" |
sources | array | web,news,x | Fontes de dados a consultar |
return_citations | bool | true | Incluir URLs das fontes |
from_date | string | - | Data inicial (AAAA-MM-DD) |
to_date | string | - | Data final (AAAA-MM-DD) |
max_search_results | int | 10 | Máximo de fontes a retornar (personalize para controlar custo) |
Tipos de Fonte
Fonte X/Twitter:
{
"type": "x",
"included_x_handles": ["handle1", "handle2"], # Máx. 10
"excluded_x_handles": ["spam_account"], # Máx. 10
"post_favorite_count": 100, # Limite mínimo de curtidas
"post_view_count": 1000 # Limite mínimo de visualizações
}
Fonte Web:
{
"type": "web",
"country": "US", # Código ISO alpha-2
"allowed_websites": ["example.com"], # Máx. 5
"safe_search": True
}
Fonte de Notícias:
{
"type": "news",
"country": "US",
"excluded_websites": ["tabloid.com"] # Máx. 5
}
Modelos Disponíveis
| Modelo | Melhor Para | Preço |
|---|---|---|
openai/gpt-5.2 | Segundas opiniões, revisão de código, geral | $1,75/M entrada, $14/M saída |
openai/gpt-5-mini | Raciocínio otimizado para custo | $0,30/M entrada, $1,20/M saída |
openai/o4-mini | Raciocínio eficiente mais recente | $1,10/M entrada, $4,40/M saída |
openai/o3 | Raciocínio avançado, problemas complexos | $10/M entrada, $40/M saída |
xai/grok-3 | Dados em tempo real do X/Twitter | $3/M + $0,025/fonte |
deepseek/deepseek-chat | Tarefas simples, processamento em lote | $0,14/M entrada, $0,28/M saída |
google/gemini-2.5-flash | Documentos muito longos, rápido | $0,15/M entrada, $0,60/M saída |
openai/dall-e-3 | Imagens fotorrealistas | $0,04/imagem |
google/nano-banana | Imagens rápidas e artísticas | $0,01/imagem |
M = milhões de tokens. O custo real depende do seu prompt e do comprimento da resposta.
Referência de Custos
Todos os custos de LLM são por milhão de tokens (M = 1.000.000 tokens).
| Modelo | Entrada | Saída |
|---|---|---|
| GPT-5.2 | $1,75/M | $14,00/M |
| GPT-5-mini | $0,30/M | $1,20/M |
| Grok-3 (sem pesquisa) | $3,00/M | $15,00/M |
| DeepSeek | $0,14/M | $0,28/M |
| Ações de Custo Fixo | |
|---|---|
| Grok Live Search | $0,025/fonte (padrão 10 = $0,25) |
| Imagem DALL-E | $0,04/imagem |
| Imagem Nano Banana | $0,01/imagem |
Custos típicos: Um prompt de 500 palavras (~750 tokens) para GPT-5.2 custa ~$0,001 de entrada. Uma resposta de 1000 palavras (~1500 tokens) custa ~$0,02 de saída.
Configuração e Financiamento
Localização da carteira: $HOME/.blockrun/.session (ex.: /Users/usuario/.blockrun/.session)
Configuração inicial:
- A carteira é criada automaticamente quando
setup_agent_wallet()é chamado - Verifique a carteira e o saldo:
from blockrun_llm import setup_agent_wallet
client = setup_agent_wallet()
print(f"Carteira: {client.get_wallet_address()}")
print(f"Saldo: ${client.get_balance():.2f} USDC")
- Financie a carteira com $1-5 USDC na rede Base
Mostre o código QR para financiamento (ASCII para terminal):
from blockrun_llm import generate_wallet_qr_ascii, get_wallet_address
print(generate_wallet_qr_ascii(get_wallet_address()))
Solução de Problemas
"Grok diz que não tem acesso em tempo real"
→ Você esqueceu de ativar o Live Search. Adicione search=True:
response = client.chat("xai/grok-3", "O que está em alta?", search=True)
Módulo não encontrado
→ Instale o SDK: pip install blockrun-llm
Atualizações
pip install --upgrade blockrun-llm