Saltar al contenido principal

Documentación

CENTRO DE APRENDIZAJE

Domina la moderación de contenido con guías completas, tutoriales y documentación de API

Pago por solicitud con x402

Puedes llamar a la API de Discuse sin una cuenta. Cada solicitud se paga en USDC en el momento en que la envías, con el protocolo de pago x402. No hay registro, ni clave de API, ni plan, ni cuota mensual.

Usa x402 para agentes de AI y llamadas ocasionales. Para tráfico constante, una clave de API con un plan es más barata y tiene límites más altos.

¿Cómo funciona una solicitud de pago?

  1. Envía la solicitud sin un encabezado X-API-Key.
  2. La API responde 402 Payment Required. El encabezado de respuesta payment-required y el cuerpo JSON describen el precio y los pagos aceptados.
  3. Tu cliente x402 firma un pago en USDC por ese importe.
  4. Envía de nuevo la misma solicitud con el pago firmado en el encabezado PAYMENT-SIGNATURE.
  5. El pago se verifica y se liquida, y la API devuelve la respuesta normal.

Cualquier cliente x402 versión 2 puede realizar los pasos 2 a 4 por ti.

¿Cómo es el desafío de pago?

{
  "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á en unidades atómicas de USDC (6 decimales), así que 10000 equivale a $0.01. accepts incluye una entrada por cada red.

¿Qué redes y tokens se aceptan?

Red Id. de cadena Token
Base eip155:8453 USDC
Polygon eip155:137 USDC

¿Cuánto cuesta cada solicitud?

Endpoint Precio por solicitud
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

El precio es fijo por solicitud. No depende del tamaño del contenido.

¿Qué límites se aplican a las solicitudes de pago?

Una solicitud de pago realiza más trabajo del que cubre su precio si no se limita, por eso las solicitudes de pago tienen límites más bajos que las claves de API:

Endpoint Límite por solicitud de pago
/api/v2/check Texto, además de como máximo 2 imágenes o GIFs, 1 documento y 5 enlaces. Los vídeos no están disponibles.
/api/v2/scan 1 archivo, mediante file_url (hasta 50 MiB) o file_data (hasta 10 MiB)
/api/v2/ocr 1 archivo
/api/v2/summarize Texto, o 1 archivo

Una solicitud que supere un límite se rechaza con 400 y un mensaje que empieza por x402 pay-per-request limit. Cada wallet que pague puede enviar hasta 60 solicitudes por minuto. Por encima de eso, la API responde 429.

Las solicitudes de pago usan la configuración de moderación predeterminada. La configuración del proyecto, como los umbrales personalizados, requiere una clave de API.

¿Cómo evito pagar si tengo una clave de API?

Envía el encabezado X-API-Key. A una solicitud con ese encabezado nunca se le solicita el pago; en su lugar, se factura a tu plan. Una clave en el cuerpo JSON no cuenta: sin el encabezado, la solicitud recibe el desafío de pago.

Escrito por Equipo de Discuse · Última actualización June 2026