Claude API 发布 2023 年来首个正式新版本 2026-10-21：移除 temperature 等采样参数，各语言 SDK 同步升大版本

核心背景与行业痛点

Claude API 自 2023 年起一直沿用 anthropic-version: 2023-06-01，三年间 Messages、工具调用、Managed Agents 等能力都是在这一版本上“只加不减”地叠加，历史包袱越来越重。10 月 21 日 Anthropic 发布 API 版本 2026-10-21，这是 2023 年以来第一次正式版本发布。官方表示今后会更频繁地发版本，让开发者在新模型强制要求之前就能提前处理破坏性变更；2023-06-01 目前未被弃用，老代码不会立即失效。

架构亮点与底层机制

新版本的核心是清理：Messages API 中 temperature、top_p、top_k 三个采样参数被移除，传入任何一个都会在所有模型上返回 400；assistant 消息里直接放 document 块、user 消息里带非空 citations 的文本块也会报 400。Admin API 与 Enterprise Analytics API 删除旧字段名（如 roles→role_ids、API key 的 workspace_id→scope.workspace_id）。配套 SDK 大版本同步发布：Python 2.0.0、TypeScript @anthropic-ai/sdk 1.0.0、Go 2.0.0（模块路径加 /v2）、Java 3.0.0、C# 13.0.0、Ruby 2.0.0、PHP 1.0.0，ant CLI 2.0.0。SDK 默认改用 Authorization: Bearer 发送 API key，一个客户端只持有一个凭据，MessageParam 拆成按角色区分的联合类型，旧 Text Completions 接口从多个 SDK 与 CLI 移除，许可证改为 Apache 2.0。

权威 Benchmark 与实测跑分对比

这是 API 版本与 SDK 发布，不涉及模型能力变化，官方未公布任何跑分。官方说明：Claude 4.7 及以后的模型本来就只接受默认采样值，因此移除采样参数后行为不变；在 Claude Sonnet 4.6 等仍接受自定义值的模型上，靠调低 temperature 获得稳定输出的请求会失去这一效果，且没有替代设置。

开发者实战落地与开箱指南

新版本可用于 Claude API、AWS 上的 Claude Platform、Microsoft Foundry 和 Google Cloud；在 Amazon Bedrock 上仅支持 Claude 4.7 及以后模型。升级建议：先按迁移指南逐条排查破坏性变更，删掉请求里的采样参数；如果网关或代理读取 X-Api-Key，改为读 Authorization；再升级到对应 SDK 大版本并在 2026-10-21 下完整测试后上线。依赖低 temperature 的老请求可以暂时继续用 2023-06-01。