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

x402 AI 추론 API

x402 결제 요구사항과 함께 DGrid 추론을 호출합니다. 첫 번째 요청은 결제 지침을 반환하고, 두 번째 요청은 서명된 x-payment 헤더를 포함해 실제 추론을 실행합니다.

결제 및 인증

이 엔드포인트는 계정 잔액 방식 대신 x402 결제 프로토콜을 사용합니다. 유료 요청에 필요한 헤더:

요청 본문

응답 모드

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

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

오류

정산 참고

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