Responses API: reasoning 対応の OpenAI 互換エンドポイント

Responses は OpenAI の Responses API と互換のエンドポイントです。reasoning 対応モデルでは思考トークンも出力枠を消費します。max_output_tokens が小さいと reasoning で枠が埋まり、output_text が空になることがあります。

エンドポイント

POST https://tokuse.com/v1/responses

認証

リクエストヘッダーに Authorization: Bearer sk-your-tokuse-key を付けます。API キーはサーバー側で管理してください。

対応モデル

• deepseek-v4-pro
• deepseek-flash

reasoning への対応状況はモデルによって異なります。利用可能なモデルは Tokuse のモデル一覧で確認してください。

リクエスト例

curl https://tokuse.com/v1/responses \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "input": "東京から大阪までの新幹線の所要時間を教えてください。",
    "max_output_tokens": 2048
  }'

レスポンス例

{
  "id": "resp_7c1e5b",
  "object": "response",
  "created_at": 1763200000,
  "status": "completed",
  "model": "deepseek-v4-pro",
  "output": [
    {
      "type": "message",
      "id": "msg_01",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "のぞみで約 2 時間 30 分です。"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 31,
    "output_tokens": 128,
    "total_tokens": 159
  }
}

注意事項と制限

• max_output_tokens には reasoning の思考トークンも含まれます。値が小さいと output_text が空のまま status: completed が返ることがあります。
• テキストは output[].content[] のうち、type が output_text の要素から取得します。
• 空の output_text が返ったら、max_output_tokens を増やして再試行してください。
• reasoning の挙動とトークン消費はモデルによって異なります。Tokuse のモデル一覧で対応状況を確認してください。

料金

料金はモデルと上流の単価で決まります。具体的な金額は Tokuse の料金ページと上流コンソールで確認してください。