Claude API · 2026-10-21 版本

Claude API 2026-10-21:采样参数移除与迁移

截至 2026-10-26,Anthropic 已发布 Claude API 版本 2026-10-21;请求里再带 temperature、top_p 或 top_k 会在所有模型上返回 400,即使传的是默认值。旧版本 2023-06-01 仍可用,官方版本页未标注弃用日期。

更新于 2026-10-26

一把 Key 调用 Claude、GPT 与主流国产模型,按 token 计费,几分钟上手。

#2026-10-21#temperature / top_p / top_k#HTTP 400#Apache-2.0

四项要点

400

采样参数即报错

官方版本页:发送 temperature、top_p、top_k 中任意一个,所有模型都返回 400。

2023-06-01

旧版本仍可用

官方迁移指南写明依赖非默认采样值的请求可以继续留在 2023-06-01;版本页未标注弃用日期。

Python 2.0.0

SDK 默认新版本

官方 release notes:Python SDK 2.0.0 与 TypeScript SDK 1.0.0 默认发送 2026-10-21;C#、Go、Java、PHP、Ruby 与 ant CLI 也有各自的新版本。

Apache 2.0

许可证变更

官方 release notes:新版 SDK 与 CLI 改用 Apache 2.0,旧版仍为 MIT。

2026-10-21 改了什么

官方 release notes 把 2026-10-21 列为新 API 版本;版本页列出的 Messages API 变更包括:assistant 消息里直接放 document 块返回 400;user 消息的 text 块带非空 citations 返回 400;temperature、top_p、top_k 被移除,发送任意一个都会在所有模型上返回 400。迁移指南写明,即使参数是默认值也报错,要去掉这三个参数。

官方发布页要点

2026-10-21 的 release notes 同时列出 SDK 与 ant CLI 新版本: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,默认发送 2026-10-21。这些版本还有与 API 版本无关的破坏性变更,许可证从 MIT 改为 Apache 2.0。

时间线

2026-10-21

Anthropic 发布 API 版本 2026-10-21,并发布默认使用该版本的 SDK 与 ant CLI。

2026-10-21

Claude Code 2.1.307 加入 /claude-api api-version 命令,用于把 Claude API 代码迁到 2026-10-21。

2026-10-26

核对官方版本页:旧版本 2023-06-01 仍未标注弃用日。

已确认 vs 官方未公布

已确认(官方页面可核)

2026-10-21 已发布;temperature、top_p、top_k 发送即返回 400;旧版本 2023-06-01 仍可用;SDK 新版本默认发送 2026-10-21;新 SDK 与 CLI 改用 Apache 2.0;Claude Code 2.1.307 加入 /claude-api api-version。

未证实与官方未公布

官方版本页与 release notes 没有给出 2023-06-01 的弃用日期,也没有说明何时停止支持旧版本。版本页只写 Anthropic 建议尽可能使用最新的 API 版本。

旧请求与新请求

2023-06-01 的请求

可以带 temperature、top_p、top_k;SDK 旧版默认发送 2023-06-01。迁移指南写明,依赖非默认值的请求可以继续留在这一版本。

2026-10-21 的请求

不能带这三个参数;发送任意一个,所有模型都返回 400。不传时按默认值采样,包括 temperature 1.0。

迁移步骤

① 按官方迁移指南改请求:去掉 temperature、top_p、top_k(发送任意一个都返回 400);assistant 消息里的 document 块改放进 user 消息;user 消息 text 块上的 citations 去掉。② 不用 SDK 时,把 anthropic-version 头设为 2026-10-21;用 SDK 时升级到首个默认发送该版本的版本,例如 Python 2.0.0、TypeScript 1.0.0。③ 按迁移指南处理 SDK 大版本与 API 版本无关的破坏性变更,并在发布前用 2026-10-21 测试集成。

在 QCode 上调用 Claude

QCode 文档的接入点表把 Claude Agent SDK 的 base_url 写成 https://api.qcode.cc/api,Key 用控制台拿到的 cr_ 密钥。按 token 计费,各模型单价见 /models。迁移时,你自己的请求代码要去掉 temperature、top_p、top_k(官方迁移指南)。

常见问题

2026-10-21 之后还能传 temperature 吗?

不能。官方版本页写明这三个参数已移除,发送任意一个会在所有模型上返回 400;迁移指南补充,即使传默认值也报错。

旧版本 2023-06-01 什么时候停用?

官方版本页未标注弃用日期,release notes 也没有给出时间表。迁移指南只说明,依赖非默认采样值的请求可以继续留在 2023-06-01。

哪些 SDK 版本默认使用 2026-10-21?

官方 release notes 列出 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。

不传采样参数会怎样?

官方迁移指南写明:请求按这些参数的默认值采样,包括 temperature 1.0,与 2023-06-01 请求不传时相同;在接受其他取值的模型(如 Claude Sonnet 4.6)上,原本调低 temperature 的请求会失去这个效果,官方说没有其他设置能替代。

Claude Code 有迁移命令吗?

官方 changelog 的 2.1.307(2026-10-21)写明新增 /claude-api api-version,用于把 Claude API 代码迁到 2026-10-21。

在 QCode 上调用 Claude 要改什么?

接入照 QCode 文档:Claude Agent SDK 的 base_url 用 https://api.qcode.cc/api,Key 用 cr_ 密钥。迁移时你自己的请求代码要去掉 temperature、top_p、top_k;模型按 token 计费,各模型单价见 /models。

信息来源

Anthropic 官方 release notes、API 版本页与 2026-10-21 迁移指南(2026-10-26 抓取);Claude Code 官方 changelog(2026-10-26 抓取);QCode 文档的接入点与按量包页面(2026-10-26 抓取);QCode /models 页面(2026-10-26 抓取)。

按官方步骤迁移,别等 400

想先试几天?不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,比中包每 $1 约便宜一半(每天 $5 额度)