Claude API 发布 2023-06-01 之后的首个新版本 2026-10-21：temperature、top_p、top_k 一律报错，新版 SDK 改用 Apache 2.0
这是一次真正的破坏性升级。这一条讲哪些请求会直接 400、SDK 换了哪些默认行为，以及哪些请求应该先留在旧版本。
// 要点
- 用 2026-10-21 时，请求里带 temperature、top_p 或 top_k 会返回 400，哪怕填的是默认值；Claude 4.7 及之后的模型本来就只接受默认值，采样不变，但在 Claude Sonnet 4.6 这类模型上调低 temperature 的效果会消失，没有替代设置。
- 直接放在 assistant 消息里的 document 块、user 消息里带非空 citations 的 text 块，也都改为返回 400。
- Python SDK 2.0.0、TypeScript SDK 1.0.0、Go SDK 2.0.0、Java SDK 3.0.0 与 ant CLI 2.0.0 等新版本默认发送 2026-10-21，许可证从 MIT 改为 Apache 2.0。
- 新版 SDK 改用 Authorization: Bearer 发送 API key，不再用 X-Api-Key；读取或设置 X-Api-Key 的代理和网关需要跟着改。依赖非默认采样值的请求可以继续用 2023-06-01。
开发者视角我会先锁住 SDK 的大版本，别让依赖自动升级把线上打挂；然后全仓搜一遍 temperature 和 X-Api-Key。智能面试的评分接口当初为了稳定压低过 temperature，这类请求要么暂时留在 2023-06-01，要么改用 JSON Schema 和评分细则来约束输出，再用固定题目回归一遍分数分布。