메인 콘텐츠로 건너뛰기
이 페이지는 DGrid의 추론당 결제 요청에 대한 x402 전용 엔드포인트 세부 정보를 설명합니다. OpenAI 호환 또는 Claude 호환 페이로드처럼 공급자 스타일 요청 패턴을 찾고 있다면 Model API를 참고하세요. 공급자별 호출 예시는 해당 참조 문서가 가장 좋은 출처입니다. 이 페이지는 x402 결제 흐름과 x402 엔드포인트에서 노출되는 공통 추론 필드에 초점을 맞춥니다.

​
x402 AI 추론 API

x402 결제 요구사항과 함께 DGrid 추론을 호출합니다. 첫 번째 요청은 결제 지침을 반환하고, 두 번째 요청은 서명된 x-payment 헤더를 포함해 실제 추론을 실행합니다. 
POST /x402/v1
기본 URLhttps://api.dgrid.ai
AuthorizationContent-Type: application/json; x-payment: <x402-payment-payload>
요청application/json
응답402 / 200 · application/json or text/event-stream

​
결제 및 인증

이 엔드포인트는 계정 잔액 방식 대신 x402 결제 프로토콜을 사용합니다. 유료 요청에 필요한 헤더: 
Content-Type: application/json
x-payment: <x402-payment-payload>

​
요청 본문

필드타입필수기본값설명
messagesarray예-role 과 content 를 포함한 UIMessage 배열입니다.
modelstring아니오anthropic/claude-opus-4.5대상 모델 이름입니다.
streamboolean아니오true스트리밍 응답 반환 여부입니다.
temperaturenumber아니오1샘플링 온도입니다.
topPnumber아니오1Top-p 샘플링 파라미터입니다.
topKnumber아니오40Top-k 샘플링 파라미터입니다.

​
응답 모드

​
stream = true (기본값)

AI SDK 스타일 UIMessageChunk 이벤트를 사용하는 UIMessageStream SSE (text/event-stream)를 반환합니다. 일반적인 이벤트 유형은 다음과 같습니다.
  • start
  • text-start
  • text-delta
  • text-end
  • finish
최종 finish 이벤트에는 다음과 같은 messageMetadata가 포함됩니다.
  • totalTokens
  • allowanceLeft
  • calculatedPriceWei
  • realPriceWei

​
stream = false

choices 와 usage 를 포함하는 DGrid 표준 완료 형식의 단일 JSON 응답을 반환합니다.

​
오류

상태의미
402결제 검증 실패. 보통 첫 요청에 x-payment 가 없었거나 결제 서명이 유효하지 않은 경우입니다.
400잘못된 요청 또는 업스트림 검증 오류
500서버 측 또는 업스트림 제공자 오류

​
정산 참고

  • 엔드포인트는 실제 사용량을 기준으로 정산합니다.
  • 실제 비용이 승인된 상한을 초과하면 정산은 그 승인 한도에서 상한 처리됩니다.
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
    }
  ]
}