API para agentes: pagamento por chamada com x402
Conheça a porta paga da RN para agentes sem cadastro. Veja o desafio 402, a autorização de gasto e a diferença para uma chave de organização.
Rota Nacional · Publicado · Revisado
Descubra o preço antes de autorizar o gasto
Um agente pode consultar o catálogo e escolher uma rota que ofereça pagamento por chamada. Sem pagamento, essa porta responde 402 com as condições aceitas. O cliente precisa interpretar a oferta e obter autorização para o valor antes de pagar.
A RN usa x402 com USDC na Base nas rotas que oferecem essa opção. Nem toda operação administrativa ou conexão privada vira uma chamada pública paga. Confira a autorização específica do endpoint em /openapi.json.
Pagamento e organização resolvem problemas diferentes
O pagamento autoriza o recurso vendido naquela rota. Ele não concede acesso a arquivos privados de outra organização, não cadastra conexões e não muda políticas de privacidade. Para usar um pool privado, o consumidor continua precisando do escopo e das permissões exigidos.
No chat pago por uso, a reserva cobre o teto autorizado e a liquidação considera o consumo informado. Um job assíncrono retorna os dados para acompanhar sua execução. Guarde o identificador e consulte o estado; não trate um timeout como autorização para comprar o mesmo trabalho de novo.
Integre o cliente com orçamento explícito
Use um cliente que compreenda o desafio e o comprovante de pagamento da versão oferecida pelo servidor. Defina um teto por ação e uma política para recusas. Uma mensagem de um modelo pedindo pagamento não é autoridade suficiente para movimentar a carteira.
No MCP, consulte as ferramentas e seu contrato. O transporte direto pode representar o desafio de pagamento dentro do resultado da ferramenta. Não presuma que o formato do HTTP é idêntico ao do MCP. O painel com conta, teste grátis e Pix continua sendo a entrada para pessoas.
Perguntas frequentes
Preciso criar conta para toda chamada de agente?
As rotas que oferecem x402 permitem comprar a chamada sem cadastro. Conexões privadas e administração mantêm suas exigências próprias de autorização.
Pagar permite acessar o pool de qualquer organização?
Não. Pagamento não substitui isolamento, permissões, consentimentos ou a exigência de privacidade da organização.
Continue a leitura
Como acompanhar custo, limites e recibos de inferência
Diferencie reserva, uso medido e cobrança. Saiba consultar um recibo da RN, interpretar estados pendentes e evitar repetir uma chamada paga.
Crédito de IA por Pix: como continuar depois do teste
Entenda a compra de crédito na RN, o saldo da organização e a cobrança por uso. O pagamento abre sobre a tarefa e mantém o contexto do trabalho.
Como conectar clientes OpenAI e Anthropic à RN
Escolha entre o catálogo protegido e o gateway nativo antes de configurar um cliente de IA ou agente de código. Modelo, endpoint e chave precisam combinar.