如果你的程式現在呼叫的是 claude-haiku-4-5,換成新的 Haiku 之後,有幾種請求會直接回傳 400 錯誤,不是把模型名稱改掉就能用。
Anthropic 在 2026 年 10 月 7 日釋出 Claude Haiku 5.5,模型 ID 是 claude-haiku-5-5。價格依提示(prompt)長度分兩級,同樣的文字會比 Haiku 4.5 多算約 30% 的 token,而且有五種舊寫法不能再用。如果專案在 Claude Code 裡,官方提供一行指令可以代為處理。
這篇依官方文件整理:這個模型是做什麼的、價格怎麼算、哪些請求要改,以及換之前先做的事。
這個模型是做什麼的
官方的定位是量大、要求回應速度的工作,例如分類、擷取、路由和子任務(subagent)。幾個規格:
| 項目 | Haiku 5.5 |
|---|---|
| 模型 ID | claude-haiku-5-5 |
| 上下文長度 | 1M token |
| 最大輸出 | 128K token |
| 思考方式 | 自適應(adaptive),由 effort 參數調整,預設 medium |
| 延遲 | 官方比較表中是 Claude 現有模型裡最快 |
| 最早退役時間 | 2027 年 10 月 7 日之後 |
token 是模型計費與計算長度的單位,中文與英文切成 token 的方式不一樣。這個模型的上下文長度和最大輸出,跟同一代的 Opus 5.5、Sonnet 5.5 一樣。
價格怎麼算
價格以每百萬 token(MTok)計算,依單次提示的長度分兩級:
| 提示長度 | 輸入 | 輸出 |
|---|---|---|
| 100,000 token 以內 | $0.10 / MTok | $0.50 / MTok |
| 超過 100,000 token | $0.50 / MTok | $2.50 / MTok |
快取(prompt caching,重複使用已送過的提示內容)另外計價:
| 項目 | 100,000 token 以內 | 超過 100,000 token |
|---|---|---|
| 5 分鐘快取寫入 | $0.125 / MTok | $0.625 / MTok |
| 1 小時快取寫入 | $0.20 / MTok | $1 / MTok |
| 快取讀取 | $0.01 / MTok | $0.05 / MTok |
Batch API 對輸入和輸出都是 50% 折扣。可以快取的最短提示是 512 token。
估成本時要注意一件事:Haiku 5.5 用的是 Claude 4.7 之後的新 tokenizer(把文字切成 token 的規則),官方寫明同樣的文字會比 Haiku 4.5 多算約 30% 的 token,實際增加多少看內容。所以從 Haiku 4.5 的用量換算成本時,要用 Haiku 5.5 重新計算 token 數,不能直接沿用舊數字。max_tokens 的上限也可能要調高,不然同一段回覆可能被提早截斷。
從 Haiku 4.5 換過來,會回傳 400 的幾種請求
官方遷移指南列出下面幾種寫法,在 Haiku 5.5 會回傳 400 錯誤:
thinking設成enabled加budget_tokens。 要改成自適應思考,思考多寡改用output_config.effort控制。- 帶了
temperature、top_p、top_k。temperature如果有帶,只能是 1;top_p如果有帶,只能是預設的 0.99,連 1 都會錯;任何top_k值都會錯;同時帶temperature和top_p也會錯。最簡單的做法是三個參數都移除,改用提示詞調整行為。 messages最後一則是 assistant。 這種寫法叫 prefill,是先替模型寫好回覆的開頭,讓它接著往下寫。Haiku 5.5 即使關掉思考也不接受,要改成以 user 結尾。- 使用電腦操作的
computer_20250124工具。 在 Claude API 和 Google Cloud 上要改用computer_toolset_20260801。 - 思考區塊(thinking block)送回去之前,
system、tools或前面的messages被改過。 對話要維持只往後新增,不能回頭改前面的內容。
第 1 點的改法,官方給的對照如下:
// Haiku 4.5
"thinking": { "type": "enabled", "budget_tokens": 8000 }
// Haiku 5.5
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" }
自適應思考預設是開的,所以回應可能以一個或多個 thinking 區塊開頭。讀取回覆時,要用區塊的 type 判斷,不能假設第一個區塊就是答案。思考用的 token 也算在 max_tokens 裡,max_tokens 設太小,可能在思考結束後、還沒輸出文字時就停了。
除了會回 400 的,還有幾件事要處理:
- 安全分類器可能拒絕請求,回覆的
stop_reason會是"refusal",Haiku 5.5 沒有伺服器端的備援,要在程式裡處理。 - Priority Tier(優先處理的付費層級)不支援 Haiku 5.5,如果原本在 Haiku 4.5 上買了,要另外規劃。
- 思考區塊只在產生它的帳號,或連結的帳號裡有效,不同帳號重播會被丟掉。
用 Claude Code 一行指令處理
如果專案在 Claude Code 裡,官方遷移指南提供這個指令:
/claude-api migrate this project to claude-haiku-5-5
這會呼叫 Claude Code 內建的 Claude API skill。官方說明它會替換模型 ID,視需要處理上面這類參數改動、prefill 的替代寫法和 effort 的設定,最後列出需要你手動確認的項目。動檔案之前,它會先問你要改整個目錄、子目錄還是指定的檔案。
它列出的清單仍然需要你自己看過,特別是成本和 max_tokens。
換之前先做這幾件事
- 搜尋專案裡的
claude-haiku-4-5,確認有哪些地方在呼叫,包含不同平台(Amazon Bedrock、Google Cloud、Microsoft Foundry)的模型 ID,官方遷移指南有各平台的對照表。 - 用
model設成claude-haiku-5-5重新計算一次代表性提示的 token 數,再估月成本。 - 移除
temperature、top_p、top_k,把budget_tokens改成effort,確認沒有以 assistant 結尾的messages。 - 先在測試環境跑一輪,確認沒有 400,再切換正式流量。
參考資料
- Claude Haiku 5.5,Anthropic,Claude Platform 文件
- Claude Haiku 5.5 migration guide,Anthropic,Claude Platform 文件