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": "用三点说明如何排查接口超时"}],
"max_tokens": 4096,
"thinking": {"type": "adaptive", "display": "summarized"},
"output_config": {"effort": "medium"}
}'