Ir para o conteúdo principal

Documentação

CENTRO DE APRENDIZAGEM

Domine a moderação de conteúdo com guias completos, tutoriais e documentação da API

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?

  1. Envie a requisição sem o cabeçalho X-API-Key.
  2. A API responde com 402 Payment Required. O cabeçalho de resposta payment-required e o corpo JSON descrevem o preço e os pagamentos aceitos.
  3. Seu cliente x402 assina um pagamento em USDC nesse valor.
  4. Envie a mesma requisição novamente com o pagamento assinado no cabeçalho PAYMENT-SIGNATURE.
  5. 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.

Escrito por Equipe Discuse · Última atualização em June 2026