Saltar al contenido principal
Esta página documenta los detalles del endpoint específico de x402 para las solicitudes de pago por inferencia en DGrid. Si está buscando patrones de solicitud al estilo proveedor como cargas compatibles con OpenAI o compatibles con Claude, consulte Model API. Esas referencias siguen siendo la mejor fuente para ejemplos de invocación específicos de cada proveedor. Esta página se centra en el flujo de pago x402 y en los campos de inferencia compartidos expuestos en el endpoint x402.

​
x402 AI Inference API

Llame a la inferencia de DGrid con requisitos de pago x402. La primera solicitud devuelve instrucciones de pago; la segunda incluye un encabezado x-payment firmado y ejecuta la inferencia. 
POST /x402/v1
URL basehttps://api.dgrid.ai
AuthorizationContent-Type: application/json; x-payment: <x402-payment-payload>
Solicitudapplication/json
Respuesta402 / 200 · application/json or text/event-stream

​
Pago y autenticación

Este endpoint usa el protocolo de pago x402 en lugar de un flujo basado en saldo de cuenta. Encabezados requeridos para la solicitud pagada: 
Content-Type: application/json
x-payment: <x402-payment-payload>

​
Cuerpo de la solicitud

CampoTipoObligatorioPredeterminadoDescripción
messagesarraySí-Matriz UIMessage que contiene role y content.
modelstringNoanthropic/claude-opus-4.5Nombre del modelo objetivo.
streambooleanNotrueIndica si se debe devolver una respuesta en streaming.
temperaturenumberNo1Temperatura de muestreo.
topPnumberNo1Parámetro de muestreo top-p.
topKnumberNo40Parámetro de muestreo top-k.

​
Modos de respuesta

​
stream = true (predeterminado)

Devuelve UIMessageStream SSE (text/event-stream) usando eventos UIMessageChunk al estilo AI SDK. Los tipos de evento comunes incluyen:
  • start
  • text-start
  • text-delta
  • text-end
  • finish
El evento final finish incluye messageMetadata como:
  • totalTokens
  • allowanceLeft
  • calculatedPriceWei
  • realPriceWei

​
stream = false

Devuelve una única respuesta JSON en el formato estándar de completions de DGrid con choices y usage.

​
Errores

EstadoSignificado
402La validación del pago falló, normalmente porque la primera solicitud omitió x-payment o la firma de pago no era válida
400Solicitud no válida o error de validación upstream
500Error del servidor o del proveedor upstream

​
Notas de liquidación

  • El endpoint liquida según el uso real.
  • Si el costo real supera el límite superior autorizado, la liquidación se limita a ese máximo autorizado.
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
    }
  ]
}