Claude API 三年首更砍掉 temperature：聚合层的参数翻译表要从一维改成二维
三年零四个月，第二个版本号
2026 年 10 月 21 日，Anthropic 发布 Claude API 版本 2026-10-21。这是 2023-06-01 之后的第一次正式版本更新，间隔 1238 天。官方迁移文档列出的改动清单不算长，但几乎每一条都打在聚合与分发层身上。
三条硬 400：连默认值都不放过
temperature、top_p、top_k 三个采样参数被整体移除。关键细节是：只要请求里出现这三个字段，即便值是默认的 1.0，也一律返回 400。文档的原话是 even at the parameter default value。这意味着把 temperature 当注释写进代码（显式写 1.0 表明意图）的工程习惯，在这一版上直接失效。
另外两条同样是 400：document 块直接放在 assistant 消息里要拒绝，必须挪到 user 消息；user 消息的 text 块带非空 citations 数组也要拒绝。token counting 与 Message Batch 里的每个请求同样适用。
Anthropic 没有提供替代开关。想保留低 temperature 的行为，只有两条路：不传，或者继续钉在 2023-06-01。官方明确表示旧版本不废弃。
七门 SDK 同时跳大版本，迁移不只在参数上
Python 2.0.0、TypeScript 1.0.0、Go 2.0.0（模块路径改为 /v2）、Java 3.0.0、C# 13.0.0、PHP 1.0.0、Ruby 2.0.0，ant CLI 到 2.0.0。SDK 默认就带新版本号，也就是说升级 SDK 等于被迫升级 API 版本，两件事绑在一起。
鉴权头也动了：新版 SDK 改为用 Authorization: Bearer 发送密钥。迁移指南提醒，任何读取或改写 X-Api-Key 的 proxy 与 gateway 都要同步改，否则鉴权会在网关层被截断。对做 API 聚合分发的平台，这是比 temperature 更致命的改动，因为它落在基础设施字段上。
还有一条容易踩空：Amazon Bedrock 上 2026-10-21 只对 Claude 4.7 及以后模型可用。老模型必须留在原 SDK 或原版本号，同一套代码里要出现版本分叉。
为什么聚合层最疼：翻译表从一维变二维
聚合平台的核心资产是一张参数方言翻译表：把 OpenAI 风格的统一请求翻译成各家能收的字段。过去这张表按供应商做一维映射就够用。现在不够了——同一家供应商内部要按 API 版本与模型代际做二维判定，Bedrock 这类渠道还要再叠一层渠道维度。
temperature 恰恰是这张表里最老、覆盖率最高的字段。几乎每个 SDK 示例、Agent 框架、评测脚本都显式带着它。换成白话：存量代码的默认状态就是会 400。
算一笔账：400 不扣 token，扣的是重试预算
失败的 400 请求本身不计入 token 账单，所以很多人默认成本为零。真实成本落在三层。
第一层，重试白跑。设一个中型聚合平台月请求 200 万次，其中 6% 带着 temperature（Agent 框架默认配置残留），就是每月 12 万次、日均 4000 次失败。按平均输入 2500 tokens、三次指数退避重试计，每月无效载荷约 3 亿 tokens；若这些重试落到兜底模型上，按 Claude Sonnet 5.5 输入价每百万 2 美元算，单轮尝试 600 美元/月，三轮 1800 美元/月；换成 GPT-6 Luna（每百万 0.10 美元）只是把数字压到 30 与 90 美元。
第二层，延迟。每次失败调用按 2.5 秒链路耗时计，12 万次失败各重试三次，就是每月 250 小时的排队时间，摊到用户侧就是 P99 抖动。
第三层，Agent 循环放大。Agent 把 400 当工具调用失败处理时会重新规划，一次失败可能触发整段上下文重发，这部分的 token 是真扣钱的，也是三个成本里唯一进真金账单的一项。
选型结论：双版本并行加能力位建模
短期最省事的做法是双版本并行：新版本走新模型，存量带参数的调用钉住 2023-06-01，把迁移拆成模型升级与 API 升级两件事，不要一起做。
中期参数能力不能硬编码，要建能力位：每个渠道、模型、API 版本组成的三元组挂一张能力表，请求构造时先查表再决定转发、剥离还是直接拒绝。这样下一次版本变更只是一次配置更新，不是一次发版。
还有一个时间窗要盯：Anthropic 表示会提高版本发布频率，而 Claude Sonnet 4.5 将在 11 月 30 日从 API 退役，距新版本发布只有 40 天。版本节奏变快叠加模型退役变密，聚合层能吃到的兼容链会越来越短，把版本号写死在代码里的做法，成本会逐季上升。
来源：Anthropic Claude Platform 官方迁移文档与版本说明（2026-10-21）；Gate News 转 PANews、OneSignalDesk、byteiota 报道。