API x402 para modelos de IA: pague por requisição em USDC
A RunAPI aceita pagamentos x402 em seus endpoints cobrados por chamada. Um agente envia uma requisição normal, recebe uma cotação 402, assina com sua wallet e obtém o resultado. Sem conta, sem API key, sem créditos pré-pagos.
curl -i -X POST "https://runapi.ai/api/v1/z_image/text_to_image" \ -H 'Content-Type: application/json' \ --data @request.json # HTTP/2 402# PAYMENT-REQUIRED: <base64 JSON with accepts: scheme, network, asset, amount, payTo>- 155 recursos pagáveis com x402
- Base rede de liquidação
- USDC ativo de pagamento
- 0 API keys exigidas
Quatro passos, da requisição ao resultado
-
Envie a requisição sem uma key
Envie um POST com o mesmo corpo JSON que enviaria com uma API key, mas sem o cabeçalho Authorization.
-
Leia a cotação 402
A RunAPI responde 402 com um cabeçalho PAYMENT-REQUIRED que lista o valor exato, o ativo, a rede e o destinatário. A cotação é válida por 300 segundos.
-
Assine e tente novamente
Seu cliente x402 v2 assina uma autorização EIP-3009 com a wallet do agente e reenvia a requisição com um cabeçalho PAYMENT-SIGNATURE.
-
Consulte a tarefa
A RunAPI liquida o pagamento, inicia a tarefa e retorna 200 com um recibo PAYMENT-RESPONSE e um poll_url para o resultado.
O que saber antes de pagar
Sem cadastro, sem chave de API
A wallet que paga é a única identidade. Não há conta para criar, chave para guardar nem saldo para recarregar.
Pagamentos em USDC sem gas
O pagador assina uma autorização EIP-3009 e o facilitador da Coinbase CDP envia a transferência, então a wallet precisa de USDC, mas não de ETH.
Obtendo o resultado
A maioria das tarefas de mídia termina de forma assíncrona. A resposta 200 inclui um poll_url com um token de acesso à tarefa somente leitura. O token abre apenas aquela tarefa e nada mais, e permanece válido por 30 dias após a conclusão da tarefa.
Se uma tarefa falhar
O x402 não tem reembolsos embutidos. Quando uma tarefa paga termina em estado de falha, a RunAPI registra uma obrigação de reembolso pelo valor total recebido. Depois, um operador devolve o valor à wallet pagadora por meio de uma transferência USDC separada; o reembolso não é automático.
Quais endpoints se qualificam
O x402 funciona em endpoints REST com preço fixo por chamada. Modelos cobrados por token, segundo ou caractere, incluindo os endpoints de LLM, ainda precisam de API key e créditos. O servidor MCP não aceita pagamentos x402.
As API keys continuam funcionando
O x402 é uma forma extra de pagar. Requisições que enviam uma API key válida continuam usando os créditos da conta exatamente como antes, e uma requisição com key inválida recebe um 401 em vez de uma cotação de pagamento.
Como é a troca
Entregue a resposta a qualquer cliente x402 v2 conectado à wallet do agente. O cliente cuida da assinatura e da nova tentativa:
request = {method: "POST", url: task_url, json: payload}response = x402_client.send(request, wallet: agent_wallet)# The x402 v2 client reads PAYMENT-REQUIRED, signs an EIP-3009# authorization, and replays the request with PAYMENT-SIGNATURE.response.status # => 200response.headers["PAYMENT-RESPONSE"] # settlement receiptresponse.json["poll_url"] # read-only task result URLExemplos de preços
O menor preço por chamada de alguns modelos que aceitam x402 hoje. Os preços vêm do catálogo ao vivo, e cada cotação 402 informa o valor exato daquela requisição.
| Modelo | Endpoint | Preço por chamada |
|---|---|---|
| Z Image Text to image z-image | POST /api/v1/z_image/text_to_image | $0.01 |
| Flux Text to image flux-2-klein | POST /api/v1/flux/text_to_image | $0.03 |
| Suno Stitch audio suno-v4 | POST /api/v1/suno/stitch_audio | $0.01 |
| Suno Stitch audio suno-v4.5 | POST /api/v1/suno/stitch_audio | $0.01 |
| Recraft Upscale image recraft-crisp-upscale | POST /api/v1/recraft/upscale_image | $0.01 |
| Recraft Remove background recraft-remove-background | POST /api/v1/recraft/remove_background | $0.01 |
Detalhes do pagamento
A RunAPI segue o esquema exact do x402 v2 e só aceita os valores abaixo. Qualquer outra coisa é rejeitada antes de a RunAPI pedir ao facilitador que liquide.
| Rede | Base mainnet (eip155:8453) |
|---|---|
| Ativo | USDC, contrato 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 6 casas decimais |
| Facilitador | Coinbase CDP |
| Autorização | EIP-3009, então quem paga precisa de USDC mas não de ETH para gas |
| Limite | até 10 USDC por requisição; as cotações expiram após 300 segundos |
FAQ sobre x402
O que é x402?
x402 é um protocolo de pagamento aberto construído sobre o código de status HTTP 402 Payment Required. Um servidor responde 402 com os requisitos de pagamento, o cliente paga com uma autorização de stablecoin assinada, e a requisição é reenviada. É mantido pela x402 Foundation.
Preciso de uma conta RunAPI para pagar com x402?
Não. A wallet que paga é a identidade. A RunAPI só cria um perfil de wallet interno depois da primeira liquidação bem-sucedida e nunca pede e-mail ou API key.
O que o facilitador do x402 faz?
O facilitador verifica o pagamento assinado e envia a transferência USDC na Base. A RunAPI usa o facilitador Coinbase CDP, então quem paga não precisa pagar gas.
Quanto custa uma requisição?
Cada endpoint tem um preço fixo por chamada. A cotação 402 mostra o valor exato em USDC antes de você assinar, e o catálogo de modelos lista os preços atuais.
Os agentes conseguem descobrir a RunAPI pelo x402 Bazaar?
Cada cotação 402 inclui uma declaração de descoberta do Bazaar com o schema de entrada e um exemplo, para que clientes e diretórios x402 possam listar o endpoint.
O que acontece se eu pagar e a requisição falhar antes de a tarefa começar?
Uma requisição que falha na validação é rejeitada antes de o pagamento ser liquidado, então nada é cobrado. Depois que o pagamento é liquidado, uma tarefa que falha em seguida gera uma obrigação de reembolso integral.
Páginas relacionadas
O código de status por trás do x402, e por que as APIs o retornam.
Todos os modelos e endpoints disponíveis na RunAPI.
Formatos de requisição, consulta de tarefas e códigos de erro.
Execute modelos a partir de um terminal ou de um shell de agente.
Deixe seu agente pagar pelas próprias chamadas de API
Explore os modelos, escolha um endpoint cobrado por chamada e envie sua primeira requisição sem uma key.