채팅
채팅 API는 Claude 호환 대화, Gemini 네이티브 멀티모달 메시징, OpenAI 호환 Chat Completions, 최신 Responses API를 포함합니다.
네이티브 Claude 형식
Anthropic 호환 페이로드, 도구 호출, 시스템 프롬프트가 필요할 때 Claude Messages API를 사용합니다.
https://api.dgrid.ai
POST
/v1/messages요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
model | string | 예 | 모델 ID, 예: claude-3-5-sonnet-20241022. |
max_tokens | integer | 예 | 최대 출력 token 수입니다. |
messages | array | 예 | 대화 메시지 목록입니다. |
messages[].role | string | 예 | user 또는 assistant. |
messages[].content | string 또는 array | 예 | 메시지 내용 또는 콘텐츠 블록입니다. |
system | string | 아니오 | 시스템 지시문입니다. |
temperature | number | 아니오 | 샘플링 온도입니다. |
top_p | number | 아니오 | Top-p 샘플링입니다. |
top_k | integer | 아니오 | Top-k 샘플링입니다. |
stop_sequences | array | 아니오 | 중지 시퀀스입니다. |
stream | boolean | 아니오 | 스트리밍 활성화 여부입니다. |
tools | array | 아니오 | 도구 정의입니다. |
tool_choice | object | 아니오 | 도구 선택 전략입니다. |
응답 본문
| 필드 | 타입 | 설명 |
|---|---|---|
id | string | 메시지 식별자입니다. |
type | string | 항상 message 입니다. |
role | string | 항상 assistant 입니다. |
content | array | 반환된 콘텐츠 블록입니다. |
content[].type | string | text 또는 tool_use. |
content[].text | string | type이 text일 때의 텍스트입니다. |
model | string | 응답을 생성한 모델입니다. |
stop_reason | string | end_turn, max_tokens, stop_sequence, tool_use. |
usage | object | token 사용량 정보입니다. |
Gemini 미디어 인식
이미지, 오디오, 비디오, 혼합 미디어를 단일 요청으로 분석하려면 Gemini 네이티브 멀티모달 parts를 사용합니다.
https://api.dgrid.ai
POST
/v1/models/{model}:generateContentPath 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
model | string | 예 | 모델 ID, 예: gemini-1.5-pro. |
요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
body | object | 예 | 현재 예시는 빈 JSON 객체 {} 만 전송합니다. |
응답 본문
| 필드 | 타입 | 설명 |
|---|---|---|
candidates | array | 모델이 반환한 후보 응답 목록입니다. |
candidates[].content | object | 후보 콘텐츠 객체입니다. |
candidates[].content.role | string | 응답 콘텐츠 역할입니다. |
candidates[].content.parts | array | 반환된 콘텐츠 파트 목록입니다. |
candidates[].finishReason | string | 생성 종료 이유입니다. |
candidates[].safetyRatings | array | 안전 평가 결과입니다. |
usageMetadata | object | token 사용량 메타데이터입니다. |
usageMetadata.promptTokenCount | integer | 입력 token 수입니다. |
usageMetadata.candidatesTokenCount | integer | 출력 token 수입니다. |
usageMetadata.totalTokenCount | integer | 총 token 수입니다. |
Gemini 텍스트 채팅
텍스트 전용 대화가 필요하면서도 Gemini 네이티브 형식을 유지하고 싶다면 이 경량 채팅 형식을 사용하세요.
https://api.dgrid.ai
POST
/v1/models/{model}:generateContent요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
body | object | 예 | 현재 예시는 빈 JSON 객체 {} 만 전송합니다. |
응답 본문
| 필드 | 타입 | 설명 |
|---|---|---|
candidates | array | 모델이 반환한 후보 응답 목록입니다. |
candidates[].content | object | 후보 콘텐츠 객체입니다. |
candidates[].content.role | string | 응답 콘텐츠 역할입니다. |
candidates[].content.parts | array | 반환된 콘텐츠 파트 목록입니다. |
candidates[].finishReason | string | 생성 종료 이유입니다. |
candidates[].safetyRatings | array | 안전 평가 결과입니다. |
usageMetadata | object | token 사용량 메타데이터입니다. |
usageMetadata.promptTokenCount | integer | 입력 token 수입니다. |
usageMetadata.candidatesTokenCount | integer | 출력 token 수입니다. |
usageMetadata.totalTokenCount | integer | 총 token 수입니다. |
Chat Completions
표준 멀티턴 대화, 구조화된 출력, 도구 호출이 필요할 때 OpenAI 호환 Chat Completions 형식을 사용합니다.
https://api.dgrid.ai
POST
/v1/chat/completions요청 본문
| 필드 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 예 | - | 대상 모델 ID입니다. |
messages | array | 예 | - | 현재 예시는 단일 메시지 객체 배열을 전송합니다. |
messages[].role | string | 예 | - | 현재 예시는 system 역할을 사용합니다. |
messages[].content | string | 예 | - | 현재 예시 메시지 텍스트입니다. |
응답 본문
| 필드 | 타입 | 설명 |
|---|---|---|
id | string | completion 식별자입니다. |
object | string | 항상 chat.completion 입니다. |
created | integer | 생성 타임스탬프입니다. |
model | string | 응답을 생성한 모델입니다. |
choices | array | 반환된 choice 목록입니다. |
choices[].message | object | 어시스턴트 메시지 객체입니다. |
choices[].message.role | string | 응답 역할입니다. |
choices[].message.content | string | 응답 텍스트입니다. |
choices[].message.tool_calls | array | 도구 호출 데이터입니다. |
choices[].finish_reason | string | stop, length, content_filter, tool_calls. |
usage | object | token 사용량 정보입니다. |
Responses
상태 기반 플로우, reasoning 옵션, 최신 OpenAI 도구 패턴이 필요할 때 Responses API를 사용하세요.
https://api.dgrid.ai
POST
/v1/responses요청 본문
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
model | string | 예 | 대상 모델 ID입니다. |
body.model | string | 예 | 현재 예시는 요청 본문에 model 필드만 전송합니다. |
응답 본문
| 필드 | 타입 | 설명 |
|---|---|---|
id | string | 응답 식별자입니다. |
object | string | 항상 response 입니다. |
created_at | integer | 생성 타임스탬프입니다. |
status | string | 응답 상태입니다. |
model | string | 사용된 모델입니다. |
output | array | 출력 항목 목록입니다. |
output[].type | string | 보통 message 입니다. |
output[].role | string | 출력 역할입니다. |
output[].content | array | 출력 콘텐츠 블록입니다. |
output[].content[].type | string | 텍스트 출력일 때 output_text 입니다. |
output[].content[].text | string | 출력 텍스트입니다. |
usage | object | token 사용량 요약입니다. |
