Skip to main content
This page documents the x402-specific endpoint details for DGrid pay-per-inference requests. If you are looking for provider-style request patterns such as OpenAI-compatible or Claude-compatible payloads, see Model API. Those references remain the best source for provider-specific invocation examples. This page focuses on the x402 payment flow plus the shared inference fields exposed at the x402 endpoint.

​
x402 AI Inference API

Call DGrid inference with x402 payment requirements. The first request returns payment instructions; the second request includes a signed x-payment header and executes inference. 
POST /x402/v1
Base URLhttps://api.dgrid.ai
AuthorizationContent-Type: application/json; x-payment: <x402-payment-payload>
Requestapplication/json
Response402 / 200 · application/json or text/event-stream

​
Payment and Authentication

This endpoint uses the x402 payment protocol instead of an account balance workflow. Required request headers for the paid request: 
Content-Type: application/json
x-payment: <x402-payment-payload>

​
Request Body

FieldTypeRequiredDefaultDescription
messagesarrayYes-UIMessage array containing role and content.
modelstringNoanthropic/claude-opus-4.5Target model name.
streambooleanNotrueWhether to return a streaming response.
temperaturenumberNo1Sampling temperature.
topPnumberNo1Top-p sampling parameter.
topKnumberNo40Top-k sampling parameter.

​
Response Modes

​
stream = true (default)

Returns UIMessageStream SSE (text/event-stream) using AI SDK style UIMessageChunk events. Common event types include:
  • start
  • text-start
  • text-delta
  • text-end
  • finish
The final finish event includes messageMetadata such as:
  • totalTokens
  • allowanceLeft
  • calculatedPriceWei
  • realPriceWei

​
stream = false

Returns a single JSON response in DGrid’s standard completion format with choices and usage.

​
Errors

StatusMeaning
402Payment validation failed, usually because the first request omitted x-payment or the payment signature was invalid
400Invalid request or upstream validation error
500Server-side or upstream provider error

​
Settlement Notes

  • The endpoint settles based on actual usage.
  • If actual cost exceeds the authorized upper bound, settlement is capped at that authorized limit.
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
    }
  ]
}