DeepSeek のパラメーターとプロトコルの違い
互換プロトコルにおける DeepSeek のパラメーターの違いと使い方を確認します。
DeepSeek は本ページに従って選択したプロトコルのパラメーターを調整してください。完全な構造は Chat Completions、Responses、Messages を参照してください。
| モデル | 適用範囲 |
|---|
| deepseek-flash | Chat、Responses、Messages。画像入力対応 |
| deepseek-v4-pro | Chat、Responses、Messages。画像入力非対応、Responses はサーバー側検索対応 |
| フィールド | 差分の説明 |
|---|
thinking.type | 両モデルとも既定で思考が有効。enabled/disabled に対応 |
reasoning_effort | none で思考を無効化、low/high/max で有効化。既定値は high。互換値は minimal→low、medium/xhigh→high、ultra→max |
temperature | 範囲 0～2。思考モードでは指定値を無視 |
top_p | Flash：思考時は範囲 0.95～1、0.95 未満は 0.95 として処理。非思考時は 1 固定。Pro：思考時は指定値を無視し、tools ありで 0.95、それ以外は 1。非思考時は有効 |
max_tokens | DeepSeek は引き続き使用し、非推奨ではない。範囲 1～393216。既定値は非思考 8192、思考 65536、深度 max では 131072 |
presence_penalty、frequency_penalty | 公式に非推奨。指定しても無効 |
stop | 文字列または文字列配列。停止文字列は最大 16 個 |
response_format.type | text/json_object に対応。JSON モードはプロンプトでも JSON 出力を明示 |
tools、tool_choice | Function Tool のみ。思考時の required または関数指定は 400。先に思考を無効化 |
過去の reasoning_content | 思考時に tools を指定する場合、ツール未使用ターンも含むすべての assistant 思考を再送。tools がなければ履歴思考は無視 |
stream_options.include_usage | stream: true とだけ併用可能。有効・無効にかかわらず最後の本文チャンクに全 Usage が入り、別の choices: [] チャンクはない。有効時、先行チャンクの usage は null |
user_id | DeepSeek 拡張。最大 512 文字、英数字、アンダースコア、ハイフンのみ。利用者、キャッシュ、スケジューリングを分離し、個人情報を含めない |
| フィールド | 差分の説明 |
|---|
input、instructions | 少なくとも一方を指定。instructions は先頭 system メッセージとなり、developer は user として扱う |
reasoning.effort | 既定値 high、対応値 none/low/high/max。互換値は上表どおり。none で思考を無効化 |
temperature、top_p | 値と思考モードの動作は上表と同じ。Flash と Pro の違いに注意 |
previous_response_id、conversation、store | ステートレス。指定値は無視。入出力履歴を再送。応答は previous_response_id: null、store: false 固定 |
text.format | text/json_object/json_schema に対応。JSON Schema は name と schema が必須 |
text.verbosity、reasoning.summary | 前者は無効、後者は要約を生成しない。過去の reasoning は平文 content のみで、summary/encrypted_content は非対応 |
tools | Function Tool に対応。Custom Tool 名は apply_patch のみで、他の名前は 400。web_search は Pro のみ有効、Flash は無視。file_search、code_interpreter、computer_use、mcp は無視 |
tool_choice | none/auto/required と Function Tool の指定に対応 |
parallel_tool_calls、max_tool_calls | 指定値は無視。並列ツール呼び出しは常時有効で、応答の parallel_tool_calls は true 固定 |
truncation | 無視。自動切り詰めなし。コンテキスト超過は 400 |
background、metadata、include、prompt | 指定値は無視 |
service_tier、safety_identifier、context_management、stream_options | 指定値は無視 |
| フィールド | 差分の説明 |
|---|
anthropic-version | DeepSeek はこの Header を無視し、Anthropic のバージョン日付でルールを切り替えない |
thinking、output_config.effort | 思考は既定で有効。thinking.type は enabled/disabled に対応し、budget_tokens は無視。深度は low/high/max、既定値 high。互換値は Chat 表どおり。output_config は effort のみ |
temperature、top_p | 値と思考時の動作は Chat 表と同じ。top_k は無視 |
tool_choice.type | none/auto/any/tool に対応。disable_parallel_tool_use は無視 |
metadata | user_id のみ対応。他のフィールドは無視 |
container、mcp_servers、service_tier | 指定値は無視 |
| テキストとツール結果 | テキストの citations とツール結果の is_error は無視。キャッシュマーカーは下表を参照 |
| コンテンツブロック | document、search_result、redacted_thinking、code_execution_tool_result、mcp_tool_use、mcp_tool_result、container_upload は非対応 |
| フィールド | 差分の説明 |
|---|
| 自動プレフィックスキャッシュ | 既定で有効、設定不要。保存済みプレフィックス単位が完全一致すればヒット可能。任意の一致断片では保証されない |
Responses の prompt_cache_key、prompt_cache_retention | 指定値は無視し、システムがキャッシュを自動管理 |
Messages の cache_control | コンテンツブロックとツール定義のマーカーは無視 |
| キャッシュ使用量 | Chat は usage.prompt_cache_hit_tokens と usage.prompt_cache_miss_tokens、Responses は usage.input_tokens_details.cached_tokens を確認 |
画像は deepseek-flash のみ対応し、deepseek-v4-pro は非対応です。
MODEL_ID をプラットフォームの完全なモデル ID に置換し、自分の API Key を使用してください。
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API のタイムアウトの調査方法を三点で説明してください"}],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"max_tokens": 4096
}'