Claude 參數與協定差異
了解 Claude 系列模型在相容協定下的參數差異與使用方式。
Claude 原生使用 Messages。使用 Chat Completions 時，可參考下方 Anthropic 官方兼容層的欄位限制；平台的協定轉換以所選模型入口為準。
| 模型 | 思考預設值與開關 |
|---|
| claude-haiku-5-5 | 預設開啟，努力程度為 medium；僅在 low/medium/high 下可用 disabled 關閉 |
| claude-sonnet-5-5 | 預設開啟，努力程度為 high；不接受 disabled，可在 low/medium/high 下使用 between_tools 關閉回答前的思考 |
| claude-opus-5-5 | 預設開啟，努力程度為 medium；不能關閉 |
| claude-fable-5-1 | 預設開啟，努力程度為 high；不能關閉 |
| claude-opus-5 | 預設開啟，努力程度為 high；僅在 low/medium/high 下可用 disabled 關閉 |
| claude-sonnet-5 | 預設開啟，努力程度為 high；可用 disabled 關閉 |
| claude-fable-5 | 預設開啟，努力程度為 high；不能關閉 |
| claude-opus-4-8 | 預設關閉，努力程度為 high；使用 adaptive 開啟 |
| 欄位 | 差異說明 |
|---|
thinking.type | 八款模型均支援 adaptive，不接受舊式 enabled 與 budget_tokens。能否關閉思考見上表，不要將 disabled 套用於所有模型 |
between_tools | 僅 Sonnet 5.5 支援；關閉回答前的思考，工具間進度仍通過 thinking 塊回傳。設定物件只能包含 type，不能再傳 display 或 budget_tokens |
output_config.effort | 八款均支援 low/medium/high/xhigh/max，預設值見上表；adaptive 是思考類型，不是努力程度。max_tokens 同時限制思考與最終回答 |
thinking.display | 開啟思考後，八款均預設 omitted：回傳空思考文字及 signature；需要可讀摘要時設為 summarized。空文字不代表沒有思考 |
tool_choice | Opus 5.5、Sonnet 5.5、Fable 5.1 不接受 any 或指定 tool，可用 auto/none；其餘五款支援強制呼叫，但強制呼叫會跳過該次思考。Fable 5 不適用 Fable 5.1 的強制呼叫限制 |
| 歷史思考與簽名 | 工具呼叫後完整回傳上一輪 thinking/redacted_thinking 和工具內容區塊，包括空思考文字；不要編輯、重排或重建簽名。Haiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.1 還會校驗原系統提示、工具和此前歷史，修改歷史後不能直接復用原思考塊 |
| assistant 預填充 | 八款均不支援以未完成的 assistant 消息結尾，傳入會回傳 400；需要約束輸出時使用指令或 output_config.format |
temperature/top_p/top_k | 範例中應省略。2023-06-01 也受新模型採樣限制；2026-10-21 下任何模型傳入任一欄位均回傳 400，不是切換版本後可以恢復自定義採樣 |
| Computer 工具版本 | 在 Claude API 中，Haiku 5.5、Sonnet 5.5、Opus 5.5 使用 computer_toolset_20260801；不能繼續使用舊 Computer 工具類型。其他雲平台的版本規則參閱官方說明 |
以下規則來自 Anthropic 的 OpenAI SDK 兼容層，用於區別原生 Messages 能力；不代表所有平台渠道採用相同轉換方式。
| 欄位 | 差異說明 |
|---|
n | 只接受 1 |
reasoning_effort | 被忽略；需要控制思考深度或讀取思考內容時，使用 Messages 的 output_config.effort |
response_format、tools[].function.strict | 被忽略；不能借此啟用原生結構化輸出或嚴格工具校驗 |
presence_penalty/frequency_penalty/logit_bias/seed | 被忽略，不產生對應採樣控制 |
logprobs/top_logprobs | 被忽略，不回傳相應 Token 概率 |
system/developer | 合併至開頭的系統提示，按換行連接；不保留在對話中間的原位置 |
tool_choice | required 與指定函數同樣受上述三款模型的強制呼叫限制 |
| 快取與其他設定 | 不提供原生提示快取設定；store/service_tier/metadata/prediction/user/audio/modalities 等欄位被忽略，不據此啟用同名能力 |
| 欄位 | 差異說明 |
|---|
cache_control | 使用 Messages 的 type: ephemeral；可在頂層自動選取斷點，也可在內容區塊中顯式標記，最多四個快取斷點 |
ttl | 預設 5m，可選 1h；不是 Chat 的 prompt_cache_options 設定 |
| 最小快取前綴 | Haiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.1、Opus 5、Fable 5 為 512 個輸入 Token；Sonnet 5、Opus 4.8 為 1024 個。仍需前綴一致，低於門檻不會寫入快取 |
| 思考塊 | 不能直接在 thinking 塊上設置斷點；隨歷史回傳的思考可作為此前 assistant 內容的一部分被快取 |
| 快取用量 | 查看 usage.cache_creation_input_tokens 與 usage.cache_read_input_tokens，分別確認寫入和讀取，不以請求中設置了快取判斷命中 |
將 MODEL_ID 替換為平台提供的完整模型 ID。Messages 範例顯式開啟自適應思考並回傳摘要；Chat 範例只展示基本文字呼叫。
curl 'https://api.agtcloud.ai/v1/messages' \
-H 'x-api-key: your-api-key' \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "用三點說明如何排查 API 逾時"}],
"max_tokens": 4096,
"thinking": {"type": "adaptive", "display": "summarized"},
"output_config": {"effort": "medium"}
}'