Claude API 2026-10-21: removes temperature, top_p and top_k sampling params
The new Messages API returns 400 if any sampling parameter is sent, using default sampling instead; message validation is stricter, and the 2023-06-01 version still works.
刚刚，Anthropic发布了新版Claude API规格，把temperature、top_p、top_k三个采样参数一起删了。 版本号是2026-10-21，这是Claude API自2023年以来首次推出新的正式版本号。 这次更新涉及采样控制、消息格式、SDK和鉴权方式，做Agent、Harness和模型网关的，升级前需要检查一下自己的格式。 最直接的影响：用新版Messages API时，只要请求里还带着这三个参数中的任何一个，就会返回400错误。 连temperature=1这样的默认值也不能传。 新版统一使用默认采样配置，其中temperature为1.0。 原本依赖低温度减少输出波动的应用，迁移后会失去这项调节能力，官方文档明确写了，没有其他设置可以替代。 此外，新版收紧了消息格式校验：assistant消息里直接放document块、user文本块里携带非空citations数组，都会报错。部分管理和企业分析接口的旧字段也被替换。 旧版2023-06-01目前仍未弃用，可以继续使用。 不过，升级SDK也可能把请求一起切到新版本，例如Python SDK 2.0默认就会使用新接口。 做Agent和Harness的，升级前得检查一下请求头封装：如果还在自动塞temperature之类的参数，这次就需要一起改了。
This post quotes another post: x.com/claudedevs/status/2113013247209021918