Chat Completions API: OpenAI 호환 채팅 완성
By Tokuse
APIChat CompletionsOpenAI
Chat Completions는 Tokuse에서 가장 기본이 되는 엔드포인트입니다. 기존 OpenAI SDK에서 base URL을 https://tokuse.com/v1로 바꾸면 대화형 앱과 에이전트를 거의 그대로 실행할 수 있습니다. 요금은 입력·출력 토큰 기준이며, 최신 단가는 Tokuse 요금 페이지에서 확인하세요.
엔드포인트와 인증
| 항목 | 값 |
|---|---|
| 메서드 | POST |
| 엔드포인트 | /v1/chat/completions |
| 인증 | Authorization: Bearer sk-your-tokuse-key |
| 스트리밍 | 지원 (stream: true) |
| 도구 호출 | 지원 |
| 이미지 입력 | 지원 |
지원 모델
호출 예시로 사용할 수 있는 모델 별칭입니다. 실제 사용 가능한 목록은 Tokuse 콘솔에서 확인하세요.
deepseek-flashdeepseek-v4-prodoubao-seed-2-1-lite-260915deepseek-v4-1-flashkimi-k3-1-pro
요청 예시
curl https://tokuse.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-tokuse-key" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-flash",
"messages": [
{"role": "user", "content": "Tokuse API 사용법을 두 문장으로 알려 줘."}
],
"stream": true
}'
응답 예시
stream: true이면 서버가 SSE 형식으로 토큰을 보냅니다. 마지막 이벤트는 data: [DONE]입니다.
data: {"id":"chatcmpl-01j...","object":"chat.completion.chunk","model":"deepseek-flash","choices":[{"index":0,"delta":{"role":"assistant","content":"Tokuse는 "},"finish_reason":null}]}
data: {"id":"chatcmpl-01j...","object":"chat.completion.chunk","model":"deepseek-flash","choices":[{"index":0,"delta":{"content":"OpenAI 호환 API를 제공합니다."},"finish_reason":"stop"}]}
data: [DONE]
주의 사항과 제한
- 스트리밍을 쓰지 않으면 완성된 응답을 한 번에 받습니다. 응답 구조는 OpenAI Chat Completions와 같습니다.
- 도구 호출은
tools와tool_choice를 OpenAI와 같은 형식으로 보냅니다. - 이미지 입력은 메시지의
content에image_url파트를 넣어 전달합니다. - 모델마다 지원 기능과 컨텍스트 길이가 다릅니다. 긴 입력을 보내기 전에 해당 모델의 한도를 확인하세요.
요금
과금은 입력 토큰과 출력 토큰을 기준으로 계산됩니다. 캐시 적중 여부와 모델별 단가가 다를 수 있으므로, 실제 비용은 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인한 값을 기준으로 판단하세요.