作者注：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 文檔中心
