作者注：claude-sonnet-4-5 将于 2026-11-30 退役。本文说明迁到 claude-sonnet-5-5 时，模型 ID、缓存读倍率和账单分别怎么变，并给出切换当天的字段清单和验收方法。
如果你的代码、配置文件或网关路由里还写着 claude-sonnet-4-5，或者带日期的快照 claude-sonnet-4-5-20250929，需要尽快排期了。Anthropic 模型退役页已把这个快照标为 Deprecated，公告日是 2026-09-30，退役日是 2026-11-30，官方给出的替换型号是 claude-sonnet-5-5。
这不是又一篇“新模型更强”的宣传稿。本文只讲 Sonnet 4.5 迁到 Sonnet 5.5 的工程动作：模型 ID 怎么改，倍率和价格怎么变，切换当天要动哪些字段，切换后怎么验收。能力差异不在本文的结论范围内，需要你用自己的任务回归。
核心价值：读完本文，你会拿到一张新旧型号对照表和一条可执行的切换顺序，并知道切换后用哪条请求、看哪些字段来确认迁移成功。
Sonnet 4.5 退役迁移 Sonnet 5.5 核心要点
先给结论。下表是这次迁移最需要关注的四件事，数据时间为 2026-11-10。
| 要点 | 说明 | 对你的影响 |
|---|---|---|
| 退役日期 | claude-sonnet-4-5-20250929 于 2026-11-30 退役，公告日 2026-09-30 |
距今约 20 天，需要在月底前完成切换 |
| 官方替换型号 | Anthropic 建议替换为 claude-sonnet-5-5 |
迁移目标明确，不需要在多个型号间犹豫 |
| 两个型号都能调 | 新旧型号目前都在平台型号列表中 | 可以并行跑一段时间，做灰度和回归 |
| 价格与缓存倍率变化 | 输入、输出、缓存读三项单价都下调，缓存读倍率从 0.1 降到 0.05 | 账单会变，缓存命中率高的业务变化更明显 |
Sonnet 4.5 和 Sonnet 5.5 现在都能调
这次迁移不用“一刀切”。2026-11-10 读取 API易 apiyi.com 公开价目接口，共 283 个型号，其中 claude-sonnet-4-5 与 claude-sonnet-4-5-20250929 都在，claude-sonnet-5-5 与 claude-sonnet-5-5-thinking 也已上架。新旧型号同时可用，你可以在退役日前用同一个 API Key、同一套 OpenAI 兼容接口，把流量逐步从旧 ID 挪到新 ID。
需要注意的是，带日期的快照 claude-sonnet-4-5-20250929 和不带日期的 claude-sonnet-4-5 在代码里往往散落在不同位置。前者常见于追求可复现的离线评测脚本，后者常见于业务代码和配置中心。迁移时两种写法都要搜出来，不要只改其中一种。
Sonnet 5.5 迁移中的 thinking 变体
claude-sonnet-5-5-thinking 在价目接口里是一个独立条目，有自己的倍率。如果你的业务原本就区分“普通调用”和“深度推理调用”，迁移时应该分别映射，不要把 thinking 变体的价格和基座 claude-sonnet-5-5 混在一起算。本文后面的价格换算只针对基座型号，thinking 变体请以平台型号列表的实际条目为准。
Sonnet 4.5 与 Sonnet 5.5 模型 ID 对照
迁移的第一步是建立一张 ID 映射表。下表列出了旧写法和推荐的新写法：
| 当前写法 | 状态 | 迁移后写法 | 备注 |
|---|---|---|---|
claude-sonnet-4-5-20250929 |
Deprecated，2026-11-30 退役 | claude-sonnet-5-5 |
官方建议的替换目标 |
claude-sonnet-4-5 |
仍在列表中，应随快照一起迁移 | claude-sonnet-5-5 |
业务代码中最常见的写法 |
| 推理场景自行拼接的 Sonnet 4.5 调用 | 需逐个确认 | claude-sonnet-5-5-thinking |
独立条目，单独计价 |
建议把映射关系集中写在一处，比如配置中心或环境变量，而不是在多个服务里各自硬编码。这样退役日前后只需要改一个地方，回滚也方便。
Sonnet 5.5 迁移后价格与缓存读倍率变化
倍率换算口径说明
价目接口给出的不是美元价，而是三个倍率字段：model_ratio（输入倍率）、completion_ratio（输出相对输入的倍数）、cache_ratio（缓存读相对输入的倍数）。本文按平台已发布文章使用的同一口径换算：
- 倍率 1 = 每百万 token 输入 2 美元
- 输出单价 = 输入单价 ×
completion_ratio - 缓存读单价 = 输入单价 ×
cache_ratio
下表中的美元价均是按上述口径换算得出，并非官方挂牌价，数据时间 2026-11-10。
| 型号 | model_ratio | completion_ratio | cache_ratio | 输入 $/百万 token | 输出 $/百万 token | 缓存读 $/百万 token |
|---|---|---|---|---|---|---|
claude-sonnet-4-5 |
1.5 | 5 | 0.1 | $3 | $15 | $0.30 |
claude-sonnet-5-5 |
1 | 5 | 0.05 | $2 | $10 | $0.10 |
Sonnet 5.5 缓存读倍率变化解读
从表里能看出两层变化。第一层是基础倍率，model_ratio 从 1.5 降到 1，而 completion_ratio 都是 5，所以输入和输出单价同比下降约三分之一。第二层是缓存读，cache_ratio 从 0.1 降到 0.05，叠加基础倍率的下降，缓存读单价从 $0.30 降到 $0.10，降幅约三分之二。
这意味着同样迁移一个模型 ID，不同业务的账单变化幅度并不一样。长系统提示词、长文档问答、多轮 Agent 这类缓存命中率高的场景，缓存读占账单比重大，整体变化会比纯输入输出型业务更明显。做预算时不要只用一个统一的百分比去估。
账单变化示例（假设用量）
下面用一组假设的月用量做换算，帮助你理解三项价格如何共同影响账单。数字仅用于演示计算方法，请替换成你自己的用量统计。
| 计费项 | 假设月用量 | Sonnet 4.5 换算费用 | Sonnet 5.5 换算费用 |
|---|---|---|---|
| 输入 | 1,000 万 token | $30 | $20 |
| 输出 | 200 万 token | $30 | $20 |
| 缓存读 | 3,000 万 token | $9 | $3 |
| 合计 | — | $69 | $43 |
另外，提示词缓存一般按模型隔离。切换到新 ID 后，原来在旧型号上积累的缓存不会自动沿用，前一批请求会重新写入缓存，所以切换当天的缓存命中率可能短暂偏低，账单也会有一个小波动。观察账单时，建议跳过切换后的头几个小时，再做前后对比。
切换前后，请到 API易 apiyi.com 的型号列表里重新核对 claude-sonnet-5-5 与 claude-sonnet-5-5-thinking 的当前倍率，并把核对结果更新到内部的成本预估表和告警阈值里。
Sonnet 4.5 迁移 Sonnet 5.5 快速上手
极简请求示例
用 OpenAI 兼容接口调用新型号，只需要关注下面几个字段：
- 接口地址 base_url：
https://api.apiyi.com/v1 - 请求路径：
/chat/completions - 模型字段 model：
claude-sonnet-5-5（替换原来的claude-sonnet-4-5或claude-sonnet-4-5-20250929） - 鉴权：请求头
Authorization: Bearer YOUR_API_KEY - 消息体：
messages保持原样，迁移时不需要改
如果你用的是 OpenAI 官方 SDK，通常只需改动客户端初始化里的 base_url，以及调用时的 model 参数，其余业务代码可以保持不变。
查看完整切换字段清单
切换当天需要逐项确认的位置：
– 客户端初始化：base_url 统一为 `https://api.apiyi.com/v1`，API Key 从环境变量读取
– 默认模型：配置中心或环境变量中的默认 model 改为 `claude-sonnet-5-5`
– 推理路由：原来走深度推理的分支改为 `claude-sonnet-5-5-thinking`，单独计价
– 回退列表：fallback 或重试链路中如果写了 `claude-sonnet-4-5`，一并替换，避免退役后回退失败
– 白名单与权限：网关的模型白名单、团队成员可用模型列表加入新 ID
– 成本与告警：单价表、预算告警阈值按新倍率更新
– 日志与报表：按 model 字段统计用量的看板，把新旧 ID 归到同一业务线，避免切换后报表断档
– 离线评测脚本：带日期快照 `claude-sonnet-4-5-20250929` 的评测任务改为新 ID 并重跑基线
快速开始建议：建议先在测试环境用 API易 的同一个 Key 同时调用新旧两个型号，把输出差异和用量差异记录下来，再决定灰度比例。新用户可以先用免费测试额度跑完回归。
推荐的五步切换顺序
- 全局搜索旧 ID：在代码库、配置中心、CI 脚本、网关配置中搜索
claude-sonnet-4-5，带日期和不带日期的写法都要搜出来，整理成清单。 - 核对新型号价格：到平台型号列表确认
claude-sonnet-5-5和 thinking 变体的当前倍率，更新成本预估和告警阈值。 - 灰度切换部分流量：先把非核心业务或一小部分请求切到新 ID，旧 ID 继续承接其余流量，观察错误率和输出质量。
- 同一条请求验收：用固定的验收请求分别打新旧型号，确认返回、用量和计费都符合预期（详见下一节）。
- 退役日前全量切换：在 2026-11-30 之前完成全量切换，并从代码和配置中删除旧 ID，防止有遗漏的路径在退役后报错。
切换后用同一条请求验收
验收的关键是“同一条请求”：固定系统提示词、固定用户消息、固定 max_tokens，分别发给旧型号和新型号，然后对比以下几项。
- 返回的 model 字段：确认响应里的型号是
claude-sonnet-5-5，而不是被某个默认值或回退逻辑改写成别的型号。 - usage 用量字段：对比
prompt_tokens和completion_tokens，若返回中包含缓存相关字段，也一并记录，用来核对缓存是否生效。 - 业务输出：按你自己的评测标准检查结果，比如结构化输出能否通过 JSON 校验、工具调用格式是否正确。能力差异以你的任务回归为准。
- 计费明细：在 API易 apiyi.com 控制台的用量记录里找到这条请求，核对扣费是否与新倍率换算一致。
第二天再用同一条请求重复一次，可以顺带观察缓存重新建立后的命中情况。验收通过后，再扩大灰度比例。
常见问题 FAQ
Q1：Sonnet 4.5 退役具体指哪个型号？
Anthropic 退役页列出的是 `claude-sonnet-4-5-20250929`，状态 Deprecated，公告日 2026-09-30，退役日 2026-11-30。业务中不带日期的 `claude-sonnet-4-5` 写法也建议一起迁移，避免退役后出现调用失败。
Q2：Sonnet 5.5 和 Sonnet 4.5 迁移时有什么区别要注意？
工程层面主要是三处：模型 ID 改为 `claude-sonnet-5-5`；输入、输出、缓存读单价都下调；缓存读倍率从 0.1 变为 0.05。能力是否满足你的场景，需要用自己的任务做回归，本文不做全面替代的结论。
Q3：退役日前还能继续调用 claude-sonnet-4-5 吗？
截至 2026-11-10，`claude-sonnet-4-5` 和 `claude-sonnet-4-5-20250929` 都还在平台型号列表中，可以继续调用。这段时间适合并行跑新旧型号做对比，但不建议把切换拖到退役日当天。
Q4：哪些业务迁移到 Sonnet 5.5 后账单变化最明显？
缓存读占比高的业务变化最明显，例如：
– **长系统提示词的客服或助手**：每次请求都会命中同一段长提示词缓存
– **长文档问答**：同一份文档被反复提问
– **多轮 Agent 任务**：上下文在多轮之间大量复用
Q5：如何通过 API 快速切换到 claude-sonnet-5-5？
在 API易 注册并获取 API Key 后，保持 OpenAI 兼容的调用方式不变，把 base_url 指向本文给出的地址，把 model 改为 `claude-sonnet-5-5` 即可。新用户可以用免费测试额度先跑完验收请求。
Q6：thinking 变体怎么计价？
`claude-sonnet-5-5-thinking` 在价目接口里是独立条目，倍率与基座型号分开。本文的换算价只覆盖基座 `claude-sonnet-5-5`，thinking 变体请到平台型号列表查看当前条目，不要套用基座价格。
Q7：迁移有哪些已知风险？
主要有三类：一是遗漏的硬编码旧 ID，在退役后会直接报错；二是切换当天缓存需要重新建立，短期命中率偏低；三是输出风格或格式可能有差异，依赖严格格式解析的下游需要回归。灰度切换加固定请求验收可以覆盖大部分风险。
Sonnet 4.5 迁移 Sonnet 5.5 核心要点 Key Takeaways
- 退役时间明确：
claude-sonnet-4-5-20250929于 2026-11-30 退役，官方建议换成claude-sonnet-5-5 - 新旧并存可灰度：截至 2026-11-10，新旧型号都在平台列表中，可以并行对比
- 三项单价都变：按倍率换算，输入 $3→$2，输出 $15→$10，缓存读 $0.30→$0.10
- 缓存读变化最大：
cache_ratio从 0.1 降到 0.05，缓存占比高的业务变化更明显 - thinking 单独计价：
claude-sonnet-5-5-thinking是独立条目，不与基座价混写 - 用同一条请求验收：核对 model 字段、usage 用量和计费明细，能力差异用自己的任务回归
总结
Sonnet 4.5 迁移到 Sonnet 5.5 的核心要点：
- 先改 ID：把
claude-sonnet-4-5和claude-sonnet-4-5-20250929统一映射到claude-sonnet-5-5，推理分支映射到 thinking 变体 - 再核价：按
model_ratio、completion_ratio、cache_ratio重新估算输入、输出、缓存读三项成本 - 最后验收：灰度切换后，用同一条请求核对返回型号、用量和扣费，退役日前删除旧 ID
距离 2026-11-30 还有约 20 天，建议本周就完成全局搜索和测试环境切换，留出时间做业务回归。需要同时对比新旧型号时，可以在 API易 apiyi.com 用一个 Key 完成调用和用量核对。型号与价格以平台型号列表为准。
📚 参考资料
- Anthropic 模型退役页：Claude 型号弃用与退役时间表
- 链接：
platform.claude.com/docs/en/about-claude/model-deprecations -
说明：确认
claude-sonnet-4-5-20250929的状态、公告日、退役日和官方替换建议 -
API易 公开价目接口：型号倍率数据来源
- 链接：
api.apiyi.com/api/pricing - 说明：2026-11-10 读取，包含
model_ratio、completion_ratio、cache_ratio字段
作者：API易 技术团队
技术交流：迁移过程中遇到问题，欢迎在 API易 网站首页联系我们，更多接入资料可访问 docs.apiyi.com 文档中心
