Paiement à la requête avec x402
Vous pouvez appeler l’API Discuse sans compte. Chaque requête est payée en USDC au moment de son envoi, avec le protocole de paiement x402. Il n’y a ni inscription, ni clé API, ni forfait, ni quota mensuel.
Utilisez x402 pour les agents AI et les appels occasionnels. Pour un trafic régulier, une clé API associée à un forfait revient moins cher et offre des limites plus élevées.
Comment fonctionne une requête payante ?
- Envoyez la requête sans en-tête
X-API-Key. - L’API répond
402 Payment Required. L’en-tête de réponsepayment-requiredet le corps JSON décrivent le prix et les moyens de paiement acceptés. - Votre client x402 signe un paiement en USDC pour ce montant.
- Envoyez à nouveau la même requête avec le paiement signé dans l’en-tête
PAYMENT-SIGNATURE. - Le paiement est vérifié et réglé, puis l’API renvoie la réponse normale.
Tout client x402 version 2 peut effectuer les étapes 2 à 4 pour vous.
À quoi ressemble la demande de paiement ?
{
"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 exprimé en unités atomiques USDC (6 décimales), donc 10000 correspond à 0,01 $. accepts contient une entrée par réseau.
Quels réseaux et tokens sont acceptés ?
| Réseau | Chain id | Token |
|---|---|---|
| Base | eip155:8453 |
USDC |
| Polygon | eip155:137 |
USDC |
Combien coûte chaque requête ?
| Endpoint | Prix par requête |
|---|---|
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 $ |
Le prix est fixe par requête. Il ne dépend pas de la taille du contenu.
Quelles limites s’appliquent aux requêtes payantes ?
Une requête payante peut demander plus de travail que son prix ne couvre si elle n’est pas limitée ; les requêtes payantes ont donc des limites plus basses que les clés API :
| Endpoint | Limite par requête payante |
|---|---|
/api/v2/check |
Texte, plus au maximum 2 images ou GIFs, 1 document et 5 liens. Les vidéos ne sont pas disponibles. |
/api/v2/scan |
1 fichier, via file_url (jusqu’à 50 MiB) ou file_data (jusqu’à 10 MiB) |
/api/v2/ocr |
1 fichier |
/api/v2/summarize |
Texte, ou 1 fichier |
Une requête dépassant une limite est refusée avec 400 et un message qui commence par x402 pay-per-request limit. Chaque portefeuille payeur peut envoyer jusqu’à 60 requêtes par minute. Au-delà, l’API répond 429.
Les requêtes payantes utilisent les paramètres de modération par défaut. Les paramètres de projet, comme les seuils personnalisés, nécessitent une clé API.
Comment éviter de payer quand j’ai une clé API ?
Envoyez l’en-tête X-API-Key. Une requête contenant cet en-tête ne se voit jamais demander de paiement et est plutôt facturée à votre forfait. Une clé dans le corps JSON ne compte pas : sans l’en-tête, la requête reçoit la demande de paiement.