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?
- Envía la solicitud sin un encabezado
X-API-Key. - La API responde
402 Payment Required. El encabezado de respuestapayment-requiredy el cuerpo JSON describen el precio y los pagos aceptados. - Tu cliente x402 firma un pago en USDC por ese importe.
- Envía de nuevo la misma solicitud con el pago firmado en el encabezado
PAYMENT-SIGNATURE. - 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.