Anthropic 发布三年来首个新 API 版本 2026-10-21：temperature 等采样参数直接报错，各语言 SDK 同步大版本升级，改用 Bearer 认证与 Apache 2.0 许可

这件事意味着什么

【要点】

Anthropic 10 月 21 日发布 Claude API 新版本 2026-10-21，这是自 2023-06-01 以来第一次升级 anthropic-version 请求头。同日各语言 SDK 和 ant 命令行工具同步升到新的大版本，并默认发送新版本号。

一、SDK 版本：Python 2.0.0、TypeScript 1.0.0、C# 13.0.0、Go 2.0.0、Java 3.0.0、PHP 1.0.0、Ruby 2.0.0、ant CLI 2.0.0。Python SDK 2.0.0 于北京时间 10 月 21 日 23:51 在 GitHub 发布。

二、破坏性改动：在新版本下，请求里带 temperature、top_p、top_k 会直接返回 400，即使填的是默认值；采样一律按默认值（temperature 1.0）。Claude 4.7 及以后的模型本来就只接受默认值，不受影响；Sonnet 4.6 等旧模型如果靠调低 temperature 求稳定，会失去这个效果，官方说没有替代参数。

三、其他报错项：assistant 消息里直接放 document 块、user 消息的文本块带 citations，都会返回 400。Admin API 和企业分析 API 的若干字段改名，API Key 的 workspace_id 改为 scope。

四、SDK 层面：API Key 改用 Authorization: Bearer 头发送；一个客户端只能持有一种凭证；旧的 Text Completions 接口从多数 SDK 中删除；SDK 许可证由 MIT 改为 Apache 2.0。

五、平台限制：Amazon Bedrock 上新版本只支持 Claude 4.7 及以后的模型，调用旧模型需留在旧 SDK。

【可核验】

API 发布说明：https://docs.anthropic.com/en/release-notes/api

迁移指南：https://docs.anthropic.com/en/api/migration-2026-10-21

Python SDK v2.0.0：https://github.com/anthropics/anthropic-sdk-python/releases/tag/v2.0.0

TypeScript SDK v1.0.0：https://github.com/anthropics/anthropic-sdk-typescript/releases/tag/sdk-v1.0.0

【我们的判断】

一、背景：Claude API 用一个日期版本号跑了三年多，期间新功能都靠 beta 头叠加。这次是 Anthropic 第一次系统清理历史包袱，和本周刚上线的 user profiles、组织 webhook 一起看，API 正在向「企业平台」而不是「模型接口」收拢。

二、横向比较：取消采样参数是最显眼的一刀。OpenAI 的推理模型早已不接受 temperature，Google Gemini 仍保留完整采样参数。Anthropic 的做法更彻底：不是对新模型忽略，而是在协议层面把参数删掉，等于宣布「随机性由模型方决定」。对依赖低温度做分类、抽取、评测复现的团队，这意味着要改用结构化输出、重复投票或换模型来保证稳定。

三、影响：大多数直接用 SDK 默认写法的应用改动不大，但网关、代理、多云封装（尤其读取 X-Api-Key 头的中间件）和 Go、Java、C# 这类强类型代码会有成批的编译错误。旧版本号目前仍可用，官方没给停用时间，团队可以按自己的节奏迁移，但新功能大概率只进新版本。

四、注意：许可证从 MIT 换成 Apache 2.0 对使用者基本无感，但做合规登记的公司需要更新依赖清单；Bedrock 上旧模型与新 SDK 不兼容，混用两套版本的团队要特别小心。