메인 콘텐츠로 건너뛰기
DGrid API Reference는 각기 고유한 인증 모델과 목적을 가진 세 가지 API 영역으로 구성됩니다.

Model API

채팅, 완성, 임베딩, 이미지, 오디오, 모더레이션을 위한 OpenAI, Claude, Gemini 호환 엔드포인트입니다.

Management API

Model API 키를 프로그래밍 방식으로 관리하고 Management API Key로 계정 잔액을 조회합니다.

x402 API

사전 충전된 계정 잔액 없이 x402 결제 프로토콜을 사용한 추론 단위 결제 방식 접근입니다.
HTTPS 수신 서버로 이벤트를 받으려면 Webhook 가이드를 참고하세요. 이메일과 Lark는 알림 설정을 참고하세요.
모든 Model API 참조 페이지에는 대화형 플레이그라운드가 제공됩니다. API 키와 매개변수를 입력한 후 Send를 눌러 https://api.dgrid.ai에 대해 엔드포인트를 실시간으로 테스트해 보세요.

​
Model API

Model API는 200개 이상의 주요 AI 모델에 대한 단일 게이트웨이를 제공합니다. 모든 엔드포인트는 OpenAI, Claude, Gemini 등 생태계 표준과 호환되므로, 기존 SDK와 도구를 변경 없이 그대로 사용할 수 있습니다. 요청 단위 비용을 대조해야 한다면 DGrid-Request-ID 응답 헤더를 저장하고 요청 결제 세부 정보 조회를 사용하여 토큰 사용량, 가격, USD 비용 세부 정보를 확인하세요.

​
Base URL

​
인증

모든 Model API 엔드포인트는 베어러 토큰으로 인증합니다.
Claude 호환 POST /v1/messages 엔드포인트는 추가로 다음을 요구합니다.
키 생성 가이드를 따라 API 키를 발급받거나, Management API Keys 영역을 사용하여 프로그래밍 방식으로 키 생명주기를 관리할 수 있습니다.

​
모델 명명 규칙

model 매개변수는 provider/model-name 형식(예: openai/gpt-4o)을 사용하며, DGrid가 지원하는 모든 모델에서 동일하게 적용됩니다. 사용 가능한 모델 ID를 확인하려면 모델 목록 조회를 호출하세요.

​
엔드포인트 패밀리

​
모범 사례

  1. DGrid API 키는 서버 측에 저장하고, 퍼블릭 클라이언트나 저장소에 절대 노출하지 마세요.
  2. 가능한 최소한의 마이그레이션으로 가장 광범위한 SDK 호환성을 얻으려면 OpenAI 호환 형식을 사용하세요.
  3. Gemini의 멀티모달 파트나 Claude의 도구 페이로드와 같은 제공자별 페이로드 기능이 필요한 경우에만 제공자 네이티브 형식을 사용하세요.
  4. OpenAI, Claude, Gemini 스타일 간에 매개변수 이름이 다르므로, 요청 및 응답 예시를 대상 모델 패밀리에 맞게 일치시키세요.

​
Management API

Management API Keys는 Model API 키 생명주기 관리와 계정 잔액 조회를 위한 관리용 자격 증명입니다. Model API 추론 엔드포인트를 호출할 수 없습니다. 키 생성, 인증 경계, 생명주기 엔드포인트는 Management API Keys를 참고하세요. Management API Key로 총 잔액, 구독 잔액, 충전 잔액을 조회하려면 계정 잔액 조회를 참고하세요.

​
x402 API

x402 API는 DGrid의 추론 단위 결제 접근 방식입니다. 계정을 생성하거나 잔액을 미리 충전하는 대신, x402 결제 프로토콜을 사용하여 호출별로 요청이 승인되고 정산됩니다 — 자율 에이전트 및 온디맨드 통합에 적합합니다. 결제 흐름은 x402 API를, 엔드포인트 세부 정보는 x402 API Reference를 참고하세요.