Aller au contenu principal

Documentation

Centre d’apprentissage

Maîtrisez la modération de contenu grâce à des guides complets, des tutoriels et une documentation API

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 ?

  1. Envoyez la requête sans en-tête X-API-Key.
  2. L’API répond 402 Payment Required. L’en-tête de réponse payment-required et le corps JSON décrivent le prix et les moyens de paiement acceptés.
  3. Votre client x402 signe un paiement en USDC pour ce montant.
  4. Envoyez à nouveau la même requête avec le paiement signé dans l’en-tête PAYMENT-SIGNATURE.
  5. 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.

Rédigé par Équipe Discuse · Dernière mise à jour June 2026