POST /v1/messages 接口调用,模型 ID 为 claude-opus-5-5。
模型规格
相比 Opus 5 的接入变化
- Thinking 始终开启 — 省略
thinking,或将其设为{"type":"adaptive"}。disabled和手动enabled模式都会返回400。 - 默认 effort 变更 — 未填写
output_config.effort时使用medium,而 Opus 5 的默认值是high。 - 不支持强制工具调用 —
tool_choice仅支持auto和none。使用any或指定名称的tool会返回400。 - Thinking 块需要保留 — 工具调用和多轮对话中,应保持对话前缀不变,并原样回传之前返回的 Thinking 块。
- 需要检查拒绝结果 — 安全策略拒绝可能返回 HTTP
200,同时将stop_reason设为"refusal",具体信息位于stop_details。
快速示例
核心参数
Adaptive Thinking 始终开启。使用
output_config.effort 平衡推理深度、延迟和 Token 使用量。在 xhigh 或 max 档位下,应为 Thinking 和可见回答预留足够的 max_tokens。工具调用
将tool_choice 保持为默认的 auto,或使用 none 禁止工具调用。准确描述工具用途与输入 Schema,并在提示词中说明何时应调用工具。在工具循环中,应根据内容块的 type 处理结果,不要假设第一个内容块一定是文本。
多轮对话
当 Assistant 消息包含 Thinking 块时,应原样回传完整消息。系统提示词、工具定义和更早的消息都应视为只追加内容。修改 Opus 5.5 Thinking 块之前的内容可能使该块失效并返回400。
从 Opus 5 迁移
- 将模型 ID 从
claude-opus-5改为claude-opus-5-5。 - 删除
thinking: {"type":"disabled"}和手动budget_tokens配置。 - 如果需要跨模型保持相近行为,请显式设置
output_config.effort。 - 将强制
tool_choice模式替换为auto或none。 - 即使 HTTP 状态码是
200,也要检查stop_reason和stop_details。
API 参考
查看请求字段、响应内容块和交互式 API Playground。