Skip to main content

Caso de uso · Gasto com compute e API

Orçamentos para as APIs e o compute que seus agentes compram.

Defina um teto por chamada e um orçamento por mês, para que um loop ou um prompt ruim não estoure a conta.

As chaves de teste são gratuitas.

Agent run · chamada de inferência pagademo

"resumir este contrato no endpoint de inferência aprovado"

Chamar o endpointinference.example responde 402 · preço US$ 0,40 em USDCcom preço
Checar o mandatoEndpoint na lista · teto de US$ 1,00 por chamada · US$ 12,40 de US$ 20,00 neste mêspermitido
Pagar via x402USDC na Base Sepolia · modo de teste−US$ 0,40pago
Recibo assinadorcpt_demo_41c2 · ed25519 · qualquer pessoa pode verificarassinado
Chamada atendidaO endpoint responde à requisição paga · lançamento no ledger da wallet200
Teto mensal · outubroUS$ 12,80 de US$ 20,00
saldo US$ 49,60recibo rcpt_demo_41c2 · assinado

Agent run · demo data

O que o agente faz

Do pedido ao recibo, sob um orçamento.

O agente faz a chamada e paga por ela. As regras ficam entre cada chamada e o dinheiro.

  1. 01

    Pedido

    O agente chama um endpoint com preço x402. O endpoint responde 402 com o preço em USDC.

    402 · US$ 0,40 em USDC

  2. 02

    Regras

    Teto por chamada, teto mensal e endpoint aprovado são verificados antes de qualquer pagamento.

    teto US$ 1,00 · mês US$ 20,00

  3. 03

    Pagamento

    Dentro dos tetos, a chamada é paga em USDC e segue. Acima deles, é recusada e nada é pago.

    −US$ 0,40 · x402 · USDC

  4. 04

    Recibo

    Cada chamada paga recebe um recibo assinado e um lançamento no ledger, ambos na trilha de auditoria.

    rcpt_demo_41c2 · assinado

Por trás

As partes que fazem isso rodar.

Uma chamada do agente. O resto é a plataforma: mandato, wallet, pagamento, recibo.

Mandato e regrasTeto por chamada, teto mensal e endpoints aprovados, assinados pelo consumidor e verificados antes de qualquer pagamento.Abrir
WalletO saldo em USDC que paga as chamadas; cada débito é um lançamento no ledger.Abrir
PayEnvia o pagamento sob o mandato.Abrir
Recibo e trilha de auditoriaUm recibo assinado para cada chamada paga; toda ação governada na trilha de auditoria.Abrir
GateO outro lado do x402: cobre por chamada na sua própria API.Abrir
TypeScript · @codespar/sdk 0.16.11SDK real
const cs = new CodeSpar();const res = await cs.api.response("post", "/v1/consumers/mandates/{id}/spend", { path: { id: "mnd_demo_cmp" }, body: { amount_minor: 100, payee: "https://inference.example/v1/summarize" } });if (res.ok) console.log(res.data.receipt?.id);// pago em USDC dentro dos tetos · rcpt_demo_41c2 assinado

Sandbox run · demo data

Mandato · mnd_demo_cmp demo
Teto por chamadaUS$ 1,00
Teto mensalUS$ 20,00 / mês
Endpoint aprovadoinference.example
Trilhox402 · USDC · modo de teste
Validade31/12/2026

Demo

Teste uma chamada contra estas regras.

Pague uma chamada dentro do teto, tente uma com preço acima dele, depois assine um novo mandato com teto maior e tente de novo. Saldo e teto mensal acompanham.

Simulated demo · no real money
Atividade demo2 entradas
Chamada de US$ 1,50Acima do teto de US$ 1,00 por chamada · nada pago−US$ 1,50recusado
Chamada de US$ 0,40Dentro das regras · pagamento de teste · recibo assinado−US$ 0,40pago
Resultado simulado: recusado: acima do teto por chamada. Nada foi pago.
Wallet e teto mensal demo

Saldo da wallet

US$ 49,60

Teto por chamadaUS$ 1,00
Usado no mêsUS$ 12,80 / US$ 20,00
Endpoint aprovadoinference.example
Chamadas pagas1

Pagamento de teste a um endpoint genérico de teste. Nada é chamado nem pago.

Cookbook

Pagar por chamada sob um orçamento, em poucas linhas.

O consumidor assina o mandato na página de consentimento; o agente faz uma chamada REST por requisição paga. A mesma receita roda em modo de teste com uma chave de teste.

  1. Uma chave de testeNo Dashboard. Chaves de teste são gratuitas; nada movimenta dinheiro real.
  2. Um mandatoTeto por chamada, teto mensal e o endpoint aprovado. O Dashboard abre a página de consentimento; o consumidor assina.
  3. Uma fonte de recursos em USDCEm modo de teste as chamadas liquidam na Base Sepolia; a mainnet vem desligada por padrão.
@codespar/sdk 0.16.11SDK real
// 1 · o consumidor assinou mnd_demo_cmp na página de consentimento: US$ 1,00 por chamada, US$ 20,00 por mês, um endpointimport { CodeSpar } from "@codespar/sdk";const cs = new CodeSpar(); // 2 · pagar uma chamada ao endpoint com preço x402, no máximo o teto por chamadaconst res = await cs.api.response("post", "/v1/consumers/mandates/{id}/spend", {  path: { id: "mnd_demo_cmp" },  body: { amount_minor: 100, payee: "https://inference.example/v1/summarize", attempt_id: "call_0001" },}); // 3 · dentro dos tetos: pago em USDC, recibo assinado · acima deles: recusado, nada pagoif (res.ok) console.log(res.data.receipt?.id, res.data.payment.amountMinor); // rcpt_… 40else console.log(res.status); // 422

Sandbox run · demo data

Casos de uso relacionados

Caso de uso

Gasto de máquina com x402

Chamadas pagas com preço por requisição.

Caso de uso

Recarga automática da wallet

Mantenha a wallet abastecida sob regras.

Caso de uso

Compras autônomas

Boletos de fornecedores que o agente paga sob um mandato.

Dê aos seus agentes um jeito de pagar e receber.

Construir é grátis: MCP hospedado, SDK e sandbox.

As chaves de teste são gratuitas.

REST · api.codespar.devAPI REST
$ curl https://api.codespar.dev/v1/consumers/mandates/mnd_demo_cmp/spend \    -H "Authorization: Bearer $CODESPAR_API_KEY" \    -H "Content-Type: application/json" \    -d '{"amount_minor":100,"payee":"https://inference.example/v1/summarize"}'  teto de US$ 1,00 por chamada · US$ 12,40 de US$ 20,00 neste mês  200 · pago US$ 0,40 em USDC (Base Sepolia, modo de teste) · rcpt_demo_41c2

Sandbox run · demo data

Gasto com compute e API · CodeSpar