Chat Completions API: OpenAI 호환 채팅 완성

By Tokuse
APIChat CompletionsOpenAI
다른 언어로 읽기:English日本語

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-flash
  • deepseek-v4-pro
  • doubao-seed-2-1-lite-260915
  • deepseek-v4-1-flash
  • kimi-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)와 업스트림 콘솔에서 확인한 값을 기준으로 판단하세요.