先給結論:Haiku 5.5 換的是響應 JSON 裡哪一塊才是答案。2026 年 10 月 7 日,Anthropic 發布 Claude Haiku 5.5,模型 ID 是 claude-haiku-5-5。自適應思考預設開著,content 陣列的第一塊可以是 thinking,而且預設只有 signature、正文為空。舊請求裡的 budget_tokens 直接 400。按 type 取 text,再交給 JSON.parse。
這篇按 2026 年 10 月 9 日寫,依據當天仍有效的模型頁、遷移指南和 10 月 7 日的發布說明。本站 9 月 29 日的《Sonnet 5.5 與 between_tools》寫過:Haiku 5.5 當時仍是「未來幾周」。那個日期現在到了。本文不重寫 Sonnet 那四處 400,只回答:抽 JSON 的程式碼從 Haiku 4.5 換到 5.5,要改哪一層。
10 月 7 日發了什麼
官方定位是高吞吐、對延遲敏感的活:分類、路由、抽取、子代理。上下文 100 萬 token,最大輸出 12.8 萬 token。思考是自適應的,預設 effort 是 medium。平臺覆蓋 Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry。退役承諾不早於 2027 年 10 月 7 日。claude-haiku-5-5 沒有日期字尾,也沒有另一條別名。
| 平臺 | Haiku 4.5 | Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Google Cloud | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
價目按提示是否超過 10 萬 token 分兩檔(每百萬 token,美元)。10 萬以內:輸入 0.10、輸出 0.50、快取讀 0.01、5 分鐘快取寫 0.125、1 小時快取寫 0.20。超過 10 萬:輸入 0.50、輸出 2.50、快取讀 0.05、5 分鐘寫 0.625、1 小時寫 1。Batch 對輸入和輸出打五折。對照頁上的 Haiku 4.5 是輸入 1、輸出 5。發布說明另說:平均跑下來大約便宜 75%。同一天,Sonnet 5.5 的快取讀從 0.20 降到 0.10,那是另一份價目,不要和 Haiku 的 0.01 混進同一張帳單。
第一塊不是答案
自適應思考預設開啟。請求裡不寫 thinking,響應仍可能以一塊或多塊 thinking 開頭。預設每塊的 thinking 欄位是空字串,只帶 signature。Haiku 4.5 返回的是摘要思考。要摘要,得顯式寫 thinking: {"type":"adaptive","display":"summarized"}。
遷移指南寫得很直:按 type 選塊,不要按位置。工具結果回傳時,thinking 塊原樣帶回去,不要改寫、不要丟掉 signature。思考 token 計入 max_tokens。上限按 4.5 的短回覆來設,可能在文字出現之前就停在 stop_reason: "max_tokens"。抽 JSON 的人會把空的 thinking 或半截 thinking 送進 JSON.parse,然後以為模型沒輸出。
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}
強制 tool_choice(any 或點名工具)在 Haiku 5.5 上仍被接受。這和 Opus 5.5、Sonnet 5.5 不同:那兩檔的 any / tool 會 400。Haiku 這邊強制呼叫時,響應直接從工具呼叫開始,沒有 thinking 塊。要讓它先想再調,用 tool_choice 的 auto。
四類會 400 的舊 JSON
- 手動思考預算。
thinking: {"type":"enabled","budget_tokens":N}回 400。改成{"type":"adaptive"},用output_config.effort調深淺。4.5 上不思考或只給很小預算的請求,這裡用更低的 effort;簡單請求可以整段不思考。 - 取樣參數。非預設
temperature、top_p不是 0.99、任意top_k,以及同時帶temperature和top_p,都 400。temperature若出現必須是 1。top_p若出現必須是 0.99,寫成 1 也不行。刪掉這三個欄位。 - 助手預填。
messages以 assistant 結尾、讓模型接著寫,即便關了思考也 400。格式約束改走 Structured Output,或用帶 enum 的工具做分類。續寫放到使用者訊息裡。 - 舊計算機工具。Claude API 與 Google Cloud 上,
computer_20250124加舊 beta 頭會 400。換成{"type":"computer_toolset_20260801"},並丟掉computer-use-2025-01-24。和 toolset 一起帶fine-grained-tool-streaming-2025-05-14也會 400。
還有一條不是 400、但會讓思考消失:把 Haiku 5.5 的 thinking 塊換到另一個帳號重放,API 會在模型看見之前丟掉這塊,請求仍然成功。多租戶如果共用一份對話儲存,要按產出帳號回放。改了 system、tools 或更早的 messages 再把 thinking 送回去,會 400。對話只追加。2026 年 8 月 31 日 0 點 UTC 之前建立的帳號,只有設定了 prefix_mismatch_behavior 才會報這個錯。
stop_reason: "refusal" 要單獨處理。Haiku 5.5 會跑安全分類,沒有服務端回退。Priority Tier 在這一檔不支援。Claude Managed Agents 這邊,遷移指南寫的是:除了模型名,不必再改。
關思考再要結構化輸出
thinking: {"type":"disabled"} 在 low、medium、high 可用。xhigh 和 max 會 400。提示詞裡寫「直接回答」停不住思考,這是官方提示頁上的測試結論。把 effort 調低,才是少想的槓桿。
思考關掉、同時又用 Structured Output 要 JSON 時,模型可能跳過它本該呼叫的工具。三條路:改回自適應思考;必須調工具的請求拿掉 output_config.format;或用 tool_choice 強制呼叫。強制之後,呼叫前不再有文字。官方建議寫進 system:JSON 格式只約束最終答案;需要工具時先呼叫,拿到結果再寫 JSON。
Amazon Bedrock 上的 Claude 不支援 Structured Output。分類和抽取改用帶 enum 的工具,不要在 Bedrock 上等 output_config.format。頂層 effort 在輪次之間一改,會讓這段對話的提示快取失效。要單輪改 effort,走 beta 頭 mid-conversation-output-config-2026-07-01,而且思考必須開著;思考關掉時,這條中途改動本身 400。
同一段字,token 變多
Haiku 5.5 用的是 Claude 4.7 及以後那套分詞器。同一段輸入大約比 Haiku 4.5 多 30% token,具體看內容。請求、響應、流式事件的形狀沒變。變的是你用 token 記賬的地方:usage 變大,同樣的 max_tokens 裝得下的字變少,按 4.5 計數做的成本估算要重算。用 model 設成 claude-haiku-5-5 再數,不要複用 4.5 的計數。
所以「價目大約便宜 75%」和「token 多了約 30%」要放在同一張表裡看。只換模型字串、沿用舊的 max_tokens 和舊的 token 計數,抽取任務會在 JSON 寫完之前被截斷。
上線前先核的四份 JSON
- 請求體。沒有
budget_tokens,沒有非預設取樣,messages不以 assistant 結尾。思考要麼不寫,要麼是adaptive。 - 一條真實響應。先按
type === "text"取出文字,再JSON.parse。不要解析content[0]。 - 回傳的 thinking 塊。
signature還在,塊沒有被改寫,system和tools相對產出那一輪沒有被改過。 - Structured Output 的 schema。若這輪必須調工具,不要同時把思考關掉。Bedrock 上改走工具的 enum,而不是
output_config.format。
用本機 JSON 工具看響應
改模型字串之前,在瀏覽器裡攤開三份文字:舊的 Haiku 4.5 請求、新的 5.5 請求、一條帶 thinking 塊的響應。
- JSON 校驗 — 請求和響應是否是合法 JSON;schema 是否還在要求你已經刪掉的欄位。
- JSONPath — 用
$..content[?(@.type=='text')]取出答案,避開 thinking。 - JSON Diff — 對比 4.5 請求和 5.5 請求,確認
budget_tokens、temperature、預填都消失了。
資料不離開瀏覽器。合約看平了,再改模型 ID。Haiku 5.5 會自己決定想多久;你的解析器不應把第一塊空 thinking 當成抽取結果。
常見問題 FAQ
只改 model 為 claude-haiku-5-5 能上線嗎?
不能當預設。請求裡還有 budget_tokens、非預設 temperature 或 top_p、任意 top_k、以 assistant 結尾的預填,或 Claude API / Google Cloud 上的 computer_20250124,都會 400。解析若仍讀 content 的第一塊,會把 thinking 當成答案。
為什麼解析到的第一塊是空的?
預設思考塊的 thinking 欄位是空字串,只帶 signature。要摘要得把 display 設為 summarized。答案在 type 為 text 的塊裡,不在下標 0。
把 budget_tokens 改小就能少花錢嗎?
不能。帶 budget_tokens 的 enabled 思考會 400。少想用更低的 effort。簡單請求在低 effort 下可以不產生思考塊。
關掉思考再要 JSON,工具還會被呼叫嗎?
不一定。官方提示頁寫明:思考關閉且同時使用 Structured Output 時,模型可能跳過需要的工具。要工具就保持自適應思考,或拿掉 output_config.format,或用 tool_choice 強制呼叫。
Bedrock 上怎麼拿到結構化 JSON?
遷移指南寫明:Amazon Bedrock 上的 Claude 不支援 Structured Output。用帶 enum 的工具做分類和抽取。
和 9 月 Sonnet 5.5 的 between_tools 是同一條規則嗎?
不是。Sonnet 5.5 拒收 thinking.disabled,要改 between_tools,也拒收強制 tool_choice。Haiku 5.5 在 high 及以下可以 disabled,也接受強制 tool_choice,但強制時響應裡沒有 thinking 塊。
總結
Haiku 5.5 收走的是「第一塊就是 JSON 答案」這個假設,不是抽取這件事本身。10 月 7 日上線的 claude-haiku-5-5 預設自適應思考,budget_tokens 會 400,同一段字大約多 30% token。按 content.type 取 text,thinking 塊原樣回傳,Structured Output 不要和關掉的思考綁在必須調工具的那一輪上。
先在本機把舊請求、新請求和一條真實響應看平,再改模型 ID。價目可以更低;解析器仍要認得出哪一塊才是 JSON。