Responses API: OpenAI 호환 추론 응답

Responses는 OpenAI Responses API 형식을 따르는 엔드포인트입니다. 추론(reasoning) 모델을 호출할 때 사용하며, 결과는 output_text에서 읽습니다. 요금은 입력·출력 토큰 기준이고 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
메서드	POST
엔드포인트	/v1/responses
인증	Authorization: Bearer sk-your-tokuse-key
추론	지원

지원 모델

아래 별칭은 요청 예시용입니다. 모델에 따라 추론 동작과 지원 파라미터가 다르므로 Tokuse 콘솔의 목록을 확인하세요.

• deepseek-v4-pro
• deepseek-v4-1-flash
• deepseek-flash

요청 예시

curl https://tokuse.com/v1/responses \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash",
    "input": "파이썬에서 안정적인 정렬을 구현하는 방법을 설명해 줘.",
    "max_output_tokens": 2048
  }'

응답 예시

{
  "id": "resp_01j...",
  "object": "response",
  "model": "deepseek-v4-1-flash",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {"type": "output_text", "text": "파이썬의 sorted()는 안정 정렬입니다..."}
      ]
    }
  ],
  "usage": {
    "input_tokens": 31,
    "output_tokens": 428
  }
}

주의 사항과 제한

• 추론 모델은 답변을 만들기 전에 추론 토큰을 사용합니다. max_output_tokens가 너무 작으면 추론만으로 한도가 차서 output_text가 비어 있을 수 있습니다.
• output_text가 비어 있다면 max_output_tokens를 늘려 다시 호출하세요.
• OpenAI Responses SDK를 사용할 때 base URL은 https://tokuse.com/v1입니다.
• 응답의 output 배열 구조는 모델과 요청 옵션에 따라 달라질 수 있습니다. 텍스트는 output_text 파트에서 읽는 편이 안전합니다.

요금

과금은 입력 토큰과 출력 토큰을 기준으로 계산됩니다. 추론에 사용된 토큰도 출력 사용량에 포함될 수 있으므로 긴 추론이 필요한 작업은 한도를 넉넉하게 잡으세요. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.