Skip to content

채팅

채팅 API는 Claude 호환 대화, Gemini 네이티브 멀티모달 메시징, OpenAI 호환 Chat Completions, 최신 Responses API를 포함합니다.

네이티브 Claude 형식

Anthropic 호환 페이로드, 도구 호출, 시스템 프롬프트가 필요할 때 Claude Messages API를 사용합니다.

POST
https://api.dgrid.ai
POST/v1/messages
Authorization
Authorization: Bearer <DGRID_API_KEY>; anthropic-version: 2023-06-01
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
modelstring모델 ID, 예: claude-3-5-sonnet-20241022.
max_tokensinteger최대 출력 token 수입니다.
messagesarray대화 메시지 목록입니다.
messages[].rolestringuser 또는 assistant.
messages[].contentstring 또는 array메시지 내용 또는 콘텐츠 블록입니다.
systemstring아니오시스템 지시문입니다.
temperaturenumber아니오샘플링 온도입니다.
top_pnumber아니오Top-p 샘플링입니다.
top_kinteger아니오Top-k 샘플링입니다.
stop_sequencesarray아니오중지 시퀀스입니다.
streamboolean아니오스트리밍 활성화 여부입니다.
toolsarray아니오도구 정의입니다.
tool_choiceobject아니오도구 선택 전략입니다.

응답 본문

필드타입설명
idstring메시지 식별자입니다.
typestring항상 message 입니다.
rolestring항상 assistant 입니다.
contentarray반환된 콘텐츠 블록입니다.
content[].typestringtext 또는 tool_use.
content[].textstringtype이 text일 때의 텍스트입니다.
modelstring응답을 생성한 모델입니다.
stop_reasonstringend_turn, max_tokens, stop_sequence, tool_use.
usageobjecttoken 사용량 정보입니다.

Gemini 미디어 인식

이미지, 오디오, 비디오, 혼합 미디어를 단일 요청으로 분석하려면 Gemini 네이티브 멀티모달 parts를 사용합니다.

POST
https://api.dgrid.ai
POST/v1/models/{model}:generateContent
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

Path 파라미터

파라미터타입필수설명
modelstring모델 ID, 예: gemini-1.5-pro.

요청 본문

필드타입필수설명
bodyobject현재 예시는 빈 JSON 객체 {} 만 전송합니다.

응답 본문

필드타입설명
candidatesarray모델이 반환한 후보 응답 목록입니다.
candidates[].contentobject후보 콘텐츠 객체입니다.
candidates[].content.rolestring응답 콘텐츠 역할입니다.
candidates[].content.partsarray반환된 콘텐츠 파트 목록입니다.
candidates[].finishReasonstring생성 종료 이유입니다.
candidates[].safetyRatingsarray안전 평가 결과입니다.
usageMetadataobjecttoken 사용량 메타데이터입니다.
usageMetadata.promptTokenCountinteger입력 token 수입니다.
usageMetadata.candidatesTokenCountinteger출력 token 수입니다.
usageMetadata.totalTokenCountinteger총 token 수입니다.

Gemini 텍스트 채팅

텍스트 전용 대화가 필요하면서도 Gemini 네이티브 형식을 유지하고 싶다면 이 경량 채팅 형식을 사용하세요.

POST
https://api.dgrid.ai
POST/v1/models/{model}:generateContent
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
bodyobject현재 예시는 빈 JSON 객체 {} 만 전송합니다.

응답 본문

필드타입설명
candidatesarray모델이 반환한 후보 응답 목록입니다.
candidates[].contentobject후보 콘텐츠 객체입니다.
candidates[].content.rolestring응답 콘텐츠 역할입니다.
candidates[].content.partsarray반환된 콘텐츠 파트 목록입니다.
candidates[].finishReasonstring생성 종료 이유입니다.
candidates[].safetyRatingsarray안전 평가 결과입니다.
usageMetadataobjecttoken 사용량 메타데이터입니다.
usageMetadata.promptTokenCountinteger입력 token 수입니다.
usageMetadata.candidatesTokenCountinteger출력 token 수입니다.
usageMetadata.totalTokenCountinteger총 token 수입니다.

Chat Completions

표준 멀티턴 대화, 구조화된 출력, 도구 호출이 필요할 때 OpenAI 호환 Chat Completions 형식을 사용합니다.

POST
https://api.dgrid.ai
POST/v1/chat/completions
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수기본값설명
modelstring-대상 모델 ID입니다.
messagesarray-현재 예시는 단일 메시지 객체 배열을 전송합니다.
messages[].rolestring-현재 예시는 system 역할을 사용합니다.
messages[].contentstring-현재 예시 메시지 텍스트입니다.

응답 본문

필드타입설명
idstringcompletion 식별자입니다.
objectstring항상 chat.completion 입니다.
createdinteger생성 타임스탬프입니다.
modelstring응답을 생성한 모델입니다.
choicesarray반환된 choice 목록입니다.
choices[].messageobject어시스턴트 메시지 객체입니다.
choices[].message.rolestring응답 역할입니다.
choices[].message.contentstring응답 텍스트입니다.
choices[].message.tool_callsarray도구 호출 데이터입니다.
choices[].finish_reasonstringstop, length, content_filter, tool_calls.
usageobjecttoken 사용량 정보입니다.

Responses

상태 기반 플로우, reasoning 옵션, 최신 OpenAI 도구 패턴이 필요할 때 Responses API를 사용하세요.

POST
https://api.dgrid.ai
POST/v1/responses
Authorization
Authorization: Bearer <DGRID_API_KEY>
Request
application/json
Response
200 · application/json

요청 본문

필드타입필수설명
modelstring대상 모델 ID입니다.
body.modelstring현재 예시는 요청 본문에 model 필드만 전송합니다.

응답 본문

필드타입설명
idstring응답 식별자입니다.
objectstring항상 response 입니다.
created_atinteger생성 타임스탬프입니다.
statusstring응답 상태입니다.
modelstring사용된 모델입니다.
outputarray출력 항목 목록입니다.
output[].typestring보통 message 입니다.
output[].rolestring출력 역할입니다.
output[].contentarray출력 콘텐츠 블록입니다.
output[].content[].typestring텍스트 출력일 때 output_text 입니다.
output[].content[].textstring출력 텍스트입니다.
usageobjecttoken 사용량 요약입니다.