チャット補完の作成 - DeepSeek v3.1 思考レベル制御 (ストリーミング)

本エンドポイントは、DeepSeek v3.1 モデルとのチャット対話を作成するために使用されます。ストリーミング出力（SSE）およびモデルの深い思考能力（Thinking）の詳細な制御をサポートしています。

エンドポイント詳細

• ステータス: リリース済み (Released)
• HTTPメソッド: POST
• エンドポイントURL: https://api.codingplanx.ai/v1/chat/completions

---

リクエストヘッダー (Headers)

(注：現在 X-Forwarded-Host ヘッダーは無効化されています)

---

リクエストボディ (Request Body)

Content-Type: application/json

リクエスト例

{
  "model": "deepseek-v3-1-250821",
  "max_tokens": 1000,
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "temperature": 1.0,
  "stream": true,
  "stream_options": {
    "include_usage": true
  },
  "thinking": {
    "type": "enabled"
  }
}

---

レスポンス (Response)

HTTP ステータスコード: 200 OK Content-Type: application/json

(注：stream: true の場合、戻り値のフォーマットは SSE データストリームとなり、各データチャンクは以下の構造を持つ JSON 文字列になります。以下は非ストリーミング、またはストリーミングを組み立てた後の標準的な JSON 構造です)

レスポンス例 (JSON)

{
    "id": "chatcmpl-123",
    "object": "chat.completion",
    "created": 1677652288,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "\r
\r
Hello there, how may I assist you today?"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 9,
        "completion_tokens": 12,
        "total_tokens": 21
    }
}

---

よくある質問 (FAQ)

Q1: ストリーミング (SSE) リクエストでトークンの消費量（Usage）を取得するにはどうすればよいですか？ A1: リクエストボディで stream を true に設定し、同時に stream_options: {"include_usage": true} を構成する必要があります。これにより、SSE ストリームの終了マーカー data: [DONE] が送信される前に、サーバーが追加のデータチャンクをプッシュします。このデータチャンクの choices 配列は空ですが、usage フィールドには完全なトークン統計情報が含まれます。

Q2: thinking パラメータの enabled と auto の違いは何ですか？ A2:

• enabled: 最終的な回答を返す前に、モデルに「深い思考（Chain of Thought）」を行うことを強制します。これにより通常、より高品質な推論結果が得られますが、応答時間（初回トークン生成までの遅延）や出力トークンの消費量が増加する可能性があります。
• auto: 決定権をモデルに委ねます。モデルは messages 内の質問の複雑さに応じて、深い思考が必要かどうかを自動的に判断します。

Q3: リクエストが 401 Unauthorized エラーを返したのはなぜですか？ A3: これは通常、認証の失敗が原因です。リクエストヘッダーの Authorization フィールドが Bearer {{YOUR_API_KEY}} の形式で正しく入力されているか確認し、APIキーが有効であり、期限切れでないことを確認してください。

Q4: thinking（深い思考）を有効にした後、思考プロセスの内容は返されますか？ A4: OpenAI 互換フォーマットの標準的な実装によれば、ストリーミング出力の場合、深い思考の内容は特定の識別子（例: <think>...</think> タグ）内に含まれて返されるか、あるいは特定のチャンクフィールドを通じて返される可能性があります。フロントエンドでストリーミングデータを解析する際は、ユーザーに「思考中」のUIエフェクトを表示できるように、content 内の思考プロセスの内容を適切に処理することに留意してください。

Q5: finish_reason: "length" が返された場合、どういう意味ですか？ A5: これは、モデルの出力が設定した max_tokens の制限に達したか、モデル自体の最大コンテキストウィンドウの制限に触れたため、回答が切り捨てられたことを意味します。回答が不完全な場合は、max_tokens の値を大きくして再試行してください。