BridgeNode

Inferência de IA via x402. Pague com Solana USDC. Sem registro. Sem chaves de API.

Ver em bridgenode.ccExperimente este MCPPatrocinado

Documentação

BridgeNode — Guia Completo do Agente

Ponte de inferência de IA para agentes de IA. Sem chaves de API, sem registro, sem assinaturas. Modelos gratuitos estão incluídos, e as primeiras chamadas em modelos pagos são gratuitas — depois disso você paga por requisição com USDC da Solana via x402 (HTTP 402). Taxas de transação são patrocinadas — o agente só precisa de USDC para pagar.

Acesso gratuito (comece aqui — sem carteira necessária)

  • Modelos gratuitos: gpt-oss-20b, gpt-oss-120b, glm-4.7-flash, glm-4.5-flash, glm-4.6v-flash — servidos gratuitamente, sem carteira, sem gas. Notas sobre modelos gratuitos (leia antes de escolher um):
  • glm-4.7-flash — ⚠️ temporariamente não confiável: modelo gratuito z.ai: mais lento que os modelos gratuitos Groq — uma resposta pode levar até um minuto, e o provedor às vezes está sobrecarregado. Se retornar um erro (limite de taxa / sobrecarga temporária), tente novamente uma vez ou mude para gpt-oss-20b, o modelo gratuito mais confiável.
  • glm-4.5-flash — ⚠️ temporariamente não confiável: modelo gratuito z.ai: mais lento que os modelos gratuitos Groq — uma resposta pode levar até um minuto, e o provedor às vezes está sobrecarregado. Se retornar um erro (limite de taxa / sobrecarga temporária), tente novamente uma vez ou mude para gpt-oss-20b, o modelo gratuito mais confiável.
  • glm-4.6v-flash: modelo gratuito z.ai: mais lento que os modelos gratuitos Groq — uma resposta pode levar até um minuto, e o provedor às vezes está sobrecarregado. Se retornar um erro (limite de taxa / sobrecarga temporária), tente novamente uma vez ou mude para gpt-oss-20b, o modelo gratuito mais confiável.
  • Testes gratuitos em modelos pagos: as primeiras 2 chamada(s) para QUALQUER modelo pago são gratuitas por cliente, para que você possa experimentar uma resposta completa antes de pagar. Respostas de teste carregam X-Bridgenode-Free-Trial: 1 e X-Bridgenode-Free-Trials-Remaining: <n>.
  • Quando os testes acabam, uma requisição não paga retorna 402 cujo objeto extensions.bridgenode diz exatamente o que fazer em seguida: free_models (lista), free_trials_remaining, how_to_pay, docs.
  • Cada 402 também carrega request_hint. Para uma requisição válida, ele lista os fatos pelos quais você pagaria (modelo, context_window, max_output_tokens, clamping). Se a requisição não puder ser bem-sucedida, o 402 avisa antes de você assinar: request_hint.ok = false com problem e message (por exemplo unknown_model, empty_messages, invalid_json, unknown_mode) — corrija isso e tente novamente, nenhuma assinatura é desperdiçada em uma requisição que seria rejeitada.

Limites (publicados — contados por cliente, e aplicados exatamente assim)

  • Um cliente = uma carteira com histórico de pagamento, caso contrário sua rede (orçamento diário: /24 IPv4, /64 IPv6; testes: /16 IPv4, /48 IPv6).
  • Testes gratuitos: 2 chamadas em modelos PAGOS (únicos, por cliente).
  • Orçamento gratuito diário: 200 chamadas e 100.000 tokens por cliente por dia (MODELOS GRATUITOS E TESTES juntos, reinicia às 00:00 UTC). Acima disso → 429 free_daily_quota_exhausted com Retry-After.
  • Por modelo gratuito, nosso próprio teto diário: gpt-oss-120b 160.000, gpt-oss-20b 160.000 tokens/dia (compartilhado por todos os clientes). Atingido → 429 free_budget_exhausted nomeando um modelo que ainda funciona — paramos antes do provedor.
  • Taxa: 30 requisições gratuitas/minuto por cliente; 10 desafios de pagamento/minuto.
  • Concorrência: 20 chamadas gratuitas simultâneas em todos os clientes. Acima disso → 503 free_path_busy + Retry-After (nunca uma fila silenciosa).
  • Cada resposta gratuita carrega os números: X-Bridgenode-Free-Quota-Limit, X-Bridgenode-Free-Quota-Remaining, X-Bridgenode-Free-Quota-Reset, X-Bridgenode-Free-Quota-Tokens-Limit, X-Bridgenode-Free-Quota-Tokens-Remaining, X-Bridgenode-Free-Trials-Remaining.
  • Requisições pagas (x402) nunca são afetadas por nenhum desses limites — elas não esperam tráfego gratuito nem compartilham seus orçamentos.
  • Modelos gratuitos e testes gratuitos compartilham um limite de taxa por cliente; requisições pagas não.
  • Você não precisa enviar um cabeçalho especial para usar um teste — basta enviar uma requisição normal com um modelo pago e sem cabeçalho de pagamento. Testes e o orçamento gratuito diário (X-Bridgenode-Free-Quota-* em cada resposta gratuita) são contados por identidade de cliente: um cliente anônimo é sua rede (/24 IPv4, /64 IPv6), e uma carteira (SIGN-IN-WITH-X, sem pagamento) torna-se sua própria identidade uma vez que tenha histórico de pagamento conosco — uma carteira nova não compra um orçamento novo, mas um cliente que pagou nunca é punido por seus vizinhos.

Endpoints

Modelos e Preços

Preços em USDC por token (6 decimais). Preços ao vivo: GET https://bridgenode.cc/v1/models.

ModeloEntrada / tokenSaída / tokenJanela de contextoSaída máximaFerramentas
gpt-oss-20b 🆓$0.00000000$0.000000008.0008.000✅
gpt-oss-120b 🆓$0.00000000$0.000000008.0008.000✅
glm-4.7-flash 🆓$0.00000000$0.00000000131.0728.192✅
glm-4.5-flash 🆓$0.00000000$0.00000000131.0728.192✅
glm-4.6v-flash 🆓$0.00000000$0.00000000131.0728.192✅
deepseek-flash$0.00000018$0.000000701.048.5768.192✅
glm-4.7-flashx$0.00000008$0.000000471.048.5768.192✅
glm-5.2$0.00000164$0.000005151.048.5768.192✅
glm-5.1$0.00000164$0.000005151.048.5768.192✅
glm-5$0.00000117$0.000003741.048.5768.192✅
glm-5-turbo$0.00000122$0.00000453200.0008.192✅
glm-4.7$0.00000070$0.000002571.048.5768.192✅
glm-4.6$0.00000070$0.000002571.048.5768.192✅
glm-4.5$0.00000070$0.000002571.048.5768.192✅
glm-4.5-x$0.00000257$0.000010411.048.5768.192✅
glm-4.5-air$0.00000023$0.000001291.048.5768.192✅
glm-4.5-airx$0.00000129$0.000005271.048.5768.192✅
glm-4-32b-0414-128k$0.00000012$0.00000012131.0728.192✅
glm-5v-turbo$0.00000122$0.00000453200.0008.192✅
glm-4.6v$0.00000035$0.000001051.048.5768.192✅
glm-4.6v-flashx$0.00000005$0.000000471.048.5768.192✅
glm-4.5v$0.00000070$0.000002111.048.5768.192✅
kimi-k2.7-code$0.00000111$0.00000468262.14432.768✅
kimi-k2.7-code-highspeed$0.00000222$0.00000936262.14432.768✅
kimi-k2.6$0.00000111$0.00000468262.14432.768✅
MiniMax-M2.7$0.00000035$0.000001401.048.5768.192✅
MiniMax-M2.7-highspeed$0.00000070$0.000002811.048.5768.192✅
MiniMax-M2.5$0.00000035$0.000001401.048.5768.192✅
MiniMax-M2.5-highspeed$0.00000070$0.000002811.048.5768.192✅
MiniMax-M2.1$0.00000035$0.000001401.048.5768.192✅
MiniMax-M2.1-highspeed$0.00000070$0.000002811.048.5768.192✅
MiniMax-M2$0.00000035$0.000001401.048.5768.192✅
deepseek-v4-pro$0.00000077$0.000002321.048.5768.192✅
kimi-k3$0.00000351$0.000017551.048.57632.768✅
glm-5.3$0.00000164$0.000005151.048.5768.192✅
minimax-m3$0.00000035$0.000001401.048.5768.192✅

Modelo de preço: esquema exato — o agente paga por input tokens + max_tokens antes do processamento. Cobrança mínima por requisição: 2000 unidades atômicas = $0.002 USDC.

Chamada de ferramentas (function calling)

Envie tools no estilo OpenAI (+ tool_choice opcional) com a requisição — eles são encaminhados ao modelo sem alterações, em modelos gratuitos e pagos, via HTTP e MCP, streaming e não-streaming. A resposta é a própria resposta do provedor: texto ou choices[0].message.tool_calls com finish_reason: "tool_calls".

Continue o loop do jeito OpenAI: envie o turno do assistente de volta com content: null e seu tool_calls, seguido por uma mensagem role: "tool" por chamada carregando tool_call_id. (Um turno de chamada de ferramenta não tem conteúdo de texto — isso é normal, não um erro.)

Duas coisas para saber antes de enviar uma lista grande de ferramentas:

  • O schema da ferramenta é token de entrada — é contado no preço e no ajuste da janela de contexto exatamente como suas mensagens. Encurte descrições que você não precisa.
  • Modelos gratuitos têm um orçamento pequeno de tokens (veja a tabela acima): uma lista grande de ferramentas não caberá. Use um modelo pago para loops agênticos.

A coluna Tools acima marca modelos verificados para aceitar chamada de ferramentas (verificados ao vivo por nós). Um modelo não marcado é não verificado, não necessariamente não suportado — se um modelo recusar ferramentas, o erro nomeia a causa.

Fluxo de Pagamento (x402 V2, esquema exato)

  1. Envie a requisição sem cabeçalhos de pagamento.
  2. O servidor responde 402 Payment Required com um cabeçalho PAYMENT-REQUIRED (JSON base64): preço, endereço payTo, mint USDC, memo, blockhash recente.
  3. O agente constrói uma transação parcial: USDC TransferChecked (valor = necessário) + instrução Memo, assina com sua própria carteira. O pagador de taxa NÃO é assinado pelo agente.
  4. O agente tenta novamente a requisição com o cabeçalho PAYMENT-SIGNATURE (payload JSON base64 com a transação assinada).
  5. O servidor verifica o pagamento e processa a requisição (taxas patrocinadas — sem gas para o agente).
  6. A resposta é 200 com o cabeçalho PAYMENT-RESPONSE (recibo de liquidação).
  • Rede: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (Solana mainnet)
  • Ativo: USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  • O agente deve ter um ATA USDC existente; ele não precisa de SOL (BridgeNode patrocina as taxas).
  • Use SDKs oficiais x402 (@x402/svm, x402[svm]) ou qualquer cliente compatível com x402 — eles lidam com 402 → assinar → tentar novamente automaticamente.

Conformidade (x402 v2, exact)

Fatos que você pode verificar, não um selo:

  • x402Version 2, esquema exact, rede solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (Solana mainnet, CAIP-2).
  • Ativo: USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (6 decimais). amount é uma string atômica — "2000" é 0.002 USDC.
  • payTo = BHMDv3ri3LBEZjEzJgDZeUiguVX7LmsCstTXbM3dL8rN; extra.feePayer = o mesmo endereço, então o agente precisa de nenhum SOL (sem gas).
  • O corpo do 402 é um envelope PaymentRequired — o validador é o SDK oficial x402 (x402 2.22.0) e a verificação ao vivo passa 17/17 (envelope, semântica /supported, /verify, e uma liquidação real verificada on-chain).
  • Autofacilitado: não há terceiros entre você e nós — GET /supported, POST /verify, POST /settle são servidos pelo próprio BridgeNode, declarados em https://bridgenode.cc/.well-known/x402.
  • /verify segue a especificação: um pagamento que não verifica é respondido 200 com {"isValid": false, "invalidReason": ...}; um corpo de requisição malformado é o único 400.

Início Rápido (curl)

Passo 0 — primeira chamada, gratuita (copie esta): sem carteira, sem 402, e mantenha max_tokens >= 200 — um limite menor pode ser consumido pelo raciocínio e retornar uma resposta vazia:

curl https://bridgenode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-oss-20b","messages":[{"role":"user","content":"hello"}],"max_tokens":200}'

Resposta: 200 diretamente.

Passo 1 — um modelo PAGO (mesmo endpoint, mesmo corpo):

curl https://bridgenode.cc/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"hello"}],"max_tokens":200}'

Resposta: 402 com cabeçalho PAYMENT-REQUIRED. Assine a transação parcial com um cliente compatível com x402 e tente novamente com o cabeçalho PAYMENT-SIGNATURE. Resposta: 200 com a conclusão.

SDKs

Todos os SDKs lidam com o handshake de pagamento x402 automaticamente, com limites de gasto fail-closed (BRIDGENODE_MAX_PER_CALL, BRIDGENODE_DAILY_CAP).

Uso MCP

  • Instalação em uma linha: claude mcp add bridgenode -s user -- npx -y @bridgenode/mcp@latest
  • URL do servidor: https://bridgenode.cc/mcp (streamable-http)
  • Ferramenta: chat_completions (modelo, modo, mensagens, max_tokens)
  • Pagamento: handshake x402 por chamada de ferramenta; sempre verifique o valor real na resposta 402 antes de assinar.

Erros

StatusSignificado
400Requisição inválida (modelo desconhecido, corpo inválido). Um max_tokens não-stream acima do non_stream_max_tokens do modelo é LIMITADO a ele, nunca rejeitado.
402Pagamento necessário — veja o cabeçalho PAYMENT-REQUIRED
413Corpo da requisição muito grande (limite de 2 MB)
429Muitas requisições (limite de fila)
503Serviço ocupado — tente novamente com backoff

Descoberta

Notas

  • Reembolsos: se o provedor falhar antes de qualquer conteúdo ser entregue, o pagamento é reembolsado automaticamente (transferência USDC reversa).
  • Modelos de raciocínio/pensamento: use max_tokens >= 200 (tokens de raciocínio compartilham o orçamento de max_tokens; um limite muito pequeno pode produzir uma resposta VAZIA — tentamos novamente uma vez com um orçamento maior e reembolsamos integralmente se continuar vazia). O pensamento está desativado em: glm-4.7-flash, deepseek-flash, deepseek-v4-pro.