Pagamento por requisição com x402
Você pode chamar a API da Discuse sem uma conta. Cada requisição é paga em USDC no momento do envio, usando o protocolo de pagamento x402. Não há cadastro, chave de API, plano nem cota mensal.
Use x402 para agentes de AI e chamadas ocasionais. Para tráfego constante, uma chave de API em um plano é mais barata e tem limites maiores.
Como funciona uma requisição paga?
- Envie a requisição sem o cabeçalho
X-API-Key. - A API responde com
402 Payment Required. O cabeçalho de respostapayment-requirede o corpo JSON descrevem o preço e os pagamentos aceitos. - Seu cliente x402 assina um pagamento em USDC nesse valor.
- Envie a mesma requisição novamente com o pagamento assinado no cabeçalho
PAYMENT-SIGNATURE. - O pagamento é verificado e liquidado, e a API retorna a resposta normal.
Qualquer cliente x402 versão 2 pode executar as etapas 2 a 4 para você.
Como é o desafio de pagamento?
{
"x402Version": 2,
"error": "PAYMENT-SIGNATURE header is required",
"resource": {
"url": "https://api.discuse.com/api/v2/scan",
"description": "File virus scan"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:8453",
"amount": "10000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x66Bd239CC81664622BD8d528aa8c14f9FE46e36c",
"maxTimeoutSeconds": 60,
"extra": { "assetTransferMethod": "permit2", "name": "USD Coin", "version": "2" }
}
]
}
amount está em unidades atômicas de USDC (6 casas decimais), portanto 10000 equivale a $0.01. accepts lista uma entrada por rede.
Quais redes e tokens são aceitos?
| Rede | Chain id | Token |
|---|---|---|
| Base | eip155:8453 |
USDC |
| Polygon | eip155:137 |
USDC |
Quanto custa cada requisição?
| Endpoint | Preço por requisição |
|---|---|
POST /api/v2/check |
$0.005 |
POST /api/v2/scan |
$0.01 |
POST /api/v2/ocr |
$0.02 |
POST /api/v2/summarize |
$0.03 |
POST /api/v2/demo/check |
$0.005 |
O preço é fixo por requisição. Ele não depende do tamanho do conteúdo.
Quais limites se aplicam às requisições pagas?
Uma requisição paga realiza mais trabalho do que o preço cobre se não for limitada, por isso requisições pagas têm limites menores do que chaves de API:
| Endpoint | Limite por requisição paga |
|---|---|
/api/v2/check |
Texto, mais no máximo 2 imagens ou GIFs, 1 documento e 5 links. Vídeos não estão disponíveis. |
/api/v2/scan |
1 arquivo, por file_url (até 50 MiB) ou file_data (até 10 MiB) |
/api/v2/ocr |
1 arquivo |
/api/v2/summarize |
Texto, ou 1 arquivo |
Uma requisição acima de um limite é recusada com 400 e uma mensagem que começa com x402 pay-per-request limit. Cada carteira pagante pode enviar até 60 requisições por minuto. Acima disso, a API responde com 429.
Requisições pagas usam as configurações padrão de moderação. Configurações de projeto, como limites personalizados, precisam de uma chave de API.
Como evito pagar quando tenho uma chave de API?
Envie o cabeçalho X-API-Key. Uma requisição com esse cabeçalho nunca recebe uma solicitação de pagamento e, em vez disso, é cobrada do seu plano. Uma chave no corpo JSON não conta: sem o cabeçalho, a requisição recebe o desafio de pagamento.