用 Claude API 的开发者注意一下,Anthropic 发了新的 API 版本:2026-10-21。
这是 2023 年以来第一次正式版本更新。上一个版本号 2023-06-01 用了三年多,很多人的代码里那行 anthropic-version 头大概从来没改过。
新版改动不多,但每一条都会让旧代码报错:
temperature、top_p、top_k 三个采样参数被直接移除,请求里再带上就返回 400。认证头改成了标准的 Authorization: Bearer。官方 SDK 和 ant 命令行工具默认已经切到新版本。
最容易踩坑的是第一条。不少项目为了让输出稳定,习惯性地写一句 temperature=0,做分类、抽取、评测的尤其多。升级 SDK 之后不改代码,这些请求会全部失败。
好消息是旧版本没有被弃用。如果暂时不想动,把版本头固定在 2023-06-01 就能继续跑;SDK 升级时记得检查一下默认值是不是被改了。
为什么要拿掉采样参数?Anthropic 这次没在更新说明里多解释。比较合理的猜测是,现在的模型自带扩展思考,采样温度这类旋钮对输出的影响越来越难预测,调了也未必是开发者以为的效果,干脆不让调。
这个方向有人会不舒服,尤其是写创意文本、需要控制随机性的场景。但从平台方角度看,少一组参数就少一类“为什么我调了温度结果更差”的工单。
建议今天就去搜一遍代码库里的 temperature。
© 版权声明
文章版权归作者所有,未经允许请勿转载。





Claude API出了2023年后第一个新版本,传temperature直接报400