Claude API 不再收采样参数
Claude API 2026-10-21·传 temperature / top_p / top_k 直接 400,新大版本 SDK 默认启用
升级 SDK 大版本就等于升级 API 版本,旧脚本里的采样参数会让请求直接失败。
- 🟢 什么是 API 版本:每次调 Claude API 都要带一个
anthropic-version请求头,它决定这次请求按哪套规则处理。上一个版本是 2023-06-01,用了三年多;用 SDK 的话这个头是 SDK 替你填的 - 🟢 Messages API 三条破坏性变化:①
temperature、top_p、top_k被移除,传了就 400,哪怕传的是默认值,所有模型都一样;②assistant消息里直接放document块返回 400;③user消息里带非空citations的text块返回 400 - 🟢 SDK 版本:更新日志原文:Python SDK 2.0.0、TypeScript SDK 1.0.0、
antCLI 2.0.0 等新版本默认发送2026-10-21。迁移指南原话:用 SDK 时,请求用的是「这个 SDK 大版本发布时的当前 API 版本」,也就是说不升大版本就还是旧版本,升了就是新版本 - 🟢 和 API 版本无关、但升 SDK 也会碰到的:SDK 改用
Authorization: Bearer <key>发 API key,不再用X-Api-Key,自己写的代理、网关、日志过滤要跟着改(API 本身两个头都收);新版 SDK 和 CLI 改为 Apache 2.0 许可证 - 🟢 Claude Code 侧:2.1.307 加了
/claude-api api-version,可以让它把现有代码迁到新版本 - 🔵 其实 10-07 已经埋了伏笔:Haiku 5.5 发布时更新日志就写了,Haiku 5.5 上传
temperature会 400。这次是把同一条规则推广到所有模型 - 🔵 本机实查:单仓代码里没有
anthropicSDK,也没有直接请求api.anthropic.com的地方;传temperature的 7 个代码文件都不是调 Claude 的(比如 naming-site 两处是 DeepSeek 的temperature: 1.3),不受影响
新写 Claude 调用时不传采样参数;自建代理和网关改认 Authorization: Bearer 头。存量代码可以在 Claude Code 里用 /claude-api api-version 迁移。
- 旧版本 2023-06-01 什么时候停用,版本页和迁移指南都没写
- Claude Code 本身用不用新版本、对你有没有影响,CHANGELOG 没说;按目前看不影响你在终端里的用法
核实记录
版本页、迁移指南、API 更新日志 10-21 条目三处原文对照;本机 grep 单仓 import anthropic / @anthropic-ai/sdk / api.anthropic.com,命中的只有文档和早报快照,没有代码