--- title: 'API x402: pague por requisição modelos de IA em USDC, sem API key | RunAPI' description: Chame modelos de imagem, vídeo, música e áudio na RunAPI com x402. Seu agente paga cada requisição em USDC na Base, sem cadastro, API key ou créditos. url: https://runapi.ai/pt-BR/x402.md canonical: https://runapi.ai/pt-BR/x402 locale: pt-BR updated: '2026-09-24' date: '2026-09-24' site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/x402 zh-CN: https://runapi.ai/zh-CN/x402 es: https://runapi.ai/es/x402 ja: https://runapi.ai/ja/x402 de: https://runapi.ai/de/x402 fr: https://runapi.ai/fr/x402 pt-BR: https://runapi.ai/pt-BR/x402 ko: https://runapi.ai/ko/x402 it: https://runapi.ai/it/x402 nl: https://runapi.ai/nl/x402 pl: https://runapi.ai/pl/x402 tr: https://runapi.ai/tr/x402 zh-TW: https://runapi.ai/zh-TW/x402 zh-HK: https://runapi.ai/zh-HK/x402 ar: https://runapi.ai/ar/x402 x-default: https://runapi.ai/x402 --- > HTML version: https://runapi.ai/pt-BR/x402 > Site index for agents: https://runapi.ai/llms.txt # 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. _Atualizado September 24, 2026 · 6 min de leitura_ ## Key takeaways - Os endpoints elegíveis da RunAPI cobrados por chamada, com preço de até 10 USDC, respondem a uma requisição não autenticada com uma cotação x402 v2 padrão. - O pagamento é liquidado em USDC na Base através do facilitador Coinbase CDP. Quem paga assina uma autorização EIP-3009 e não paga gas. - Uma requisição paga retorna a resposta normal mais um poll_url somente leitura, para que um agente possa buscar a tarefa concluída sem conta. - **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 1. **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. 2. **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. 3. **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. 4. **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. ## Como é a troca A primeira requisição não carrega credenciais. Para um endpoint pagável, a RunAPI responde com um 402 e os requisitos de pagamento: ```shell 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: ``` Entregue a resposta a qualquer cliente x402 v2 conectado à wallet do agente. O cliente cuida da assinatura e da nova tentativa: ```text 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 # => 200 response.headers["PAYMENT-RESPONSE"] # settlement receipt response.json["poll_url"] # read-only task result URL ``` ## Exemplos 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 ## 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. ## 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 que é HTTP 402?](https://runapi.ai/pt-BR/http-402.md) - O código de status por trás do x402, e por que as APIs o retornam. - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - Todos os modelos e endpoints disponíveis na RunAPI. - [Documentação para desenvolvedores](https://runapi.ai/pt-BR/docs/guides) - Formatos de requisição, consulta de tarefas e códigos de erro. - [CLI](https://runapi.ai/pt-BR/cli.md) - Execute modelos a partir de um terminal ou de um shell de agente. Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only. ## 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. - [Explorar modelos](https://runapi.ai/pt-BR/models.md) - [Ler a documentação](https://runapi.ai/pt-BR/docs/guides) --- ## More from RunAPI - [Home](https://runapi.ai/pt-BR/.md) ### Produto - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models#all-models) ### Desenvolvedores - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) ### Guias - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [API x402](https://runapi.ai/pt-BR/x402.md) ### Empresa - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) ### Legal - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Article", "headline": "API x402: pague por requisição modelos de IA em USDC, sem API key", "description": "Chame modelos de imagem, vídeo, música e áudio na RunAPI com x402. Seu agente paga cada requisição em USDC na Base, sem cadastro, API key ou créditos.", "datePublished": "2026-09-24", "dateModified": "2026-09-24", "author": { "@type": "Organization", "name": "RunAPI" }, "publisher": { "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR" }, "mainEntityOfPage": "https://runapi.ai/pt-BR/x402" }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "HowTo", "name": "Como pagar uma requisição da RunAPI com x402", "description": "Um agente paga uma requisição da RunAPI com USDC na Base usando o protocolo x402 v2.", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "Envie a requisição sem uma key", "text": "Envie um POST com o mesmo corpo JSON que enviaria com uma API key, mas sem o cabeçalho Authorization.", "url": "https://runapi.ai/pt-BR/x402#four-step-getting-started-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Leia a cotação 402", "text": "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.", "url": "https://runapi.ai/pt-BR/x402#four-step-getting-started-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Assine e tente novamente", "text": "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.", "url": "https://runapi.ai/pt-BR/x402#four-step-getting-started-step-3" }, { "@type": "HowToStep", "position": 4, "name": "Consulte a tarefa", "text": "A RunAPI liquida o pagamento, inicia a tarefa e retorna 200 com um recibo PAYMENT-RESPONSE e um poll_url para o resultado.", "url": "https://runapi.ai/pt-BR/x402#four-step-getting-started-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "O que é x402?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Preciso de uma conta RunAPI para pagar com x402?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "O que o facilitador do x402 faz?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Quanto custa uma requisição?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Os agentes conseguem descobrir a RunAPI pelo x402 Bazaar?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "O que acontece se eu pagar e a requisição falhar antes de a tarefa começar?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Início", "item": "https://runapi.ai/pt-BR" }, { "@type": "ListItem", "position": 2, "name": "API x402", "item": "https://runapi.ai/pt-BR/x402" } ] } ] ```