Skip to main content
POST
Chat Completions

POST /v1/chat/completions

OpenAI Chat Completions API와 100% 호환되는 엔드포인트입니다. 기존 OpenAI SDK에서 base_url만 변경하면 바로 사용할 수 있습니다.

헤더

Authorization
string
required
Bearer kr-your-api-key
Content-Type
string
required
application/json

요청 본문

model
string
required
모델 ID. kr/gpt54, kr/claude-sonnet-46, auto-smart 등.
messages
array
required
메시지 배열. 각 메시지는 role (system, user, assistant)과 content (문자열)를 포함합니다. 최대 100개.
stream
boolean
default:"false"
true 시 SSE 스트리밍 응답.
temperature
number
default:"1.0"
0~2. 낮을수록 결정적, 높을수록 창의적.
max_tokens
integer
최대 출력 토큰 수. 최대 128,000.
top_p
number
default:"1.0"
Nucleus sampling 파라미터.
fallback
array
(고급) 폴백 모델 목록. 주 모델 실패 시 순서대로 시도합니다. 대부분의 경우 원하는 모델을 직접 지정하는 것으로 충분합니다. 예: ["kr/gpt41", "kr/claude-sonnet-46"]

응답

200 - 성공

SSE 스트리밍

stream: true 설정 시:

예시