Passer au contenu principal
Cette page documente les détails des points de terminaison spécifiques à x402 pour les requêtes d’inférence payée à l’usage de DGrid. Si vous recherchez des modèles de requête de type fournisseur tels que les charges utiles compatibles OpenAI ou compatibles Claude, consultez Model API. Ces références restent la meilleure source d’exemples d’invocation spécifiques aux fournisseurs. Cette page se concentre sur le flux de paiement x402 ainsi que sur les champs d’inférence partagés exposés au point de terminaison x402.

​
x402 AI Inference API

Appelez l’inférence DGrid avec les exigences de paiement x402. La première requête renvoie les instructions de paiement ; la seconde requête inclut un en-tête x-payment signé et exécute l’inférence. 
POST /x402/v1
URL de basehttps://api.dgrid.ai
AuthorizationContent-Type: application/json; x-payment: <x402-payment-payload>
Requêteapplication/json
Réponse402 / 200 · application/json or text/event-stream

​
Paiement et authentification

Ce point de terminaison utilise le protocole de paiement x402 au lieu d’un flux basé sur un solde de compte. En-têtes de requête requis pour la requête payée : 
Content-Type: application/json
x-payment: <x402-payment-payload>

​
Corps de la requête

ChampTypeRequisPar défautDescription
messagesarrayOui-Tableau UIMessage contenant role et content.
modelstringNonanthropic/claude-opus-4.5Nom du modèle cible.
streambooleanNontrueIndique si une réponse en flux continu doit être renvoyée.
temperaturenumberNon1Température d’échantillonnage.
topPnumberNon1Paramètre d’échantillonnage top-p.
topKnumberNon40Paramètre d’échantillonnage top-k.

​
Modes de réponse

​
stream = true (par défaut)

Renvoie un UIMessageStream SSE (text/event-stream) utilisant les événements de type UIMessageChunk du style AI SDK. Les types d’événements courants incluent :
  • start
  • text-start
  • text-delta
  • text-end
  • finish
L’événement final finish inclut un messageMetadata tel que :
  • totalTokens
  • allowanceLeft
  • calculatedPriceWei
  • realPriceWei

​
stream = false

Renvoie une seule réponse JSON dans le format de complétion standard de DGrid, avec choices et usage.

​
Erreurs

StatutSignification
402Échec de la validation du paiement, généralement parce que la première requête a omis x-payment ou que la signature de paiement était invalide
400Requête invalide ou erreur de validation en amont
500Erreur côté serveur ou du fournisseur en amont

​
Remarques sur le règlement

  • Le point de terminaison effectue le règlement en fonction de l’usage réel.
  • Si le coût réel dépasse le plafond autorisé, le règlement est limité à cette limite autorisée.
curl -i 'https://api.dgrid.ai/x402/v1/responses' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "anthropic/claude-opus-4.5",
    "stream": true,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

HTTP/1.1 402 Payment Required
Content-Type: application/json
X-PAYMENT-RESPONSE: <base64>

{
  "x402Version": 1,
  "error": "Payment required",
  "accepts": [
    {
      "scheme": "upto",
      "network": "eip155:56",
      "maxAmountRequired": "990000000000000000",
      "resource": "https://api.dgrid.ai/x402/v1",
      "payTo": "0x...",
      "asset": "0x8d0D000Ee44948FC98c9B98A4FA4921476f08B0d",
      "maxTimeoutSeconds": 86400
    }
  ]
}