Anthropic 11 月 9 日發布 Claude Fable 5.2 之後,Messages API 裡 effort、fast mode 與 usage JSON 該如何相對 Opus 5.5 配置?

截至 2026 年 11 月 10 日:Fable 5.2 標準價 $8/$40,fast mode $16/$80;用 output_config.effort 與 speed,繼承 Fable 5.1 的 thinking 與 tool_choice 限制。

先給結論:Fable 5.2 不是把 claude-fable-5-1 字串換掉就完事。2026 年 11 月 9 日 Anthropic 發布 Claude Fable 5.2(claude-fable-5-2)與受限版 Mythos 5.2(claude-mythos-5-2)。標價降到輸入 / 輸出 $8 / $40(Fable 5.1 是 $10 / $50),可選 fast mode 為 $16 / $80。整合要改三件事:model、output_config.effort(重活在 xhigh / max)、以及帳單側對 usage 的期望——同樣一次呼叫,token 組合與 Opus 5.5 不同。

這篇按 2026 年 11 月 10 日寫,依據 11 月 9 日官方發布說明。一週前本站《code execution with MCP》講 Agent 側 tool 清單 JSON;九月《Opus 5.5 與 tool_choice》寫過 Fable 5.1 同族的 400 規則。本文只補 Fable 5.2 專有欄位與選型,不重複 Opus 全文。

11 月 9 日發了什麼

官方定位 Fable 5.2 面向最難的開放式技術任務:代理式編碼、長程研究、硬體與機器人類工作。同一底層權重:Fable 帶完整網路與生物護欄,Mythos 5.2 經核驗組織可用。上下文 100 萬 token,最大輸出 12.8 萬 token。發布說明稱輸出比 5.1 快約 30%。Anthropic 建議日常編碼與知識工作仍從 claude-opus-5-5 起步,複雜度上去再切 Fable。

標準 API 價(每百萬 token,美元):輸入 8、輸出 40;Batch 半價(4 / 20)。fast mode:輸入 16、輸出 80,token 生成最高約 2.5 倍。相對 Fable 5.1 標價降 20%,相對 Opus 5.5(4 / 20)Fable 5.2 單價仍高一倍——選型看任務深度,不只看價目表一行。

各平臺 model 字串

平臺Fable 5.2Mythos 5.2
Claude API / Messagesclaude-fable-5-2claude-mythos-5-2(需核驗)
Amazon Bedrockanthropic.claude-fable-5-2組織透過核驗後單獨開通
Google Cloudclaude-fable-5-2同上
Microsoft Foundryclaude-fable-5-2同上

只改 model 欄位時,同步檢查路由層快取鍵與日誌標籤;不要把 Mythos ID 寫進面向全體使用者的預設配置。

請求 JSON:effort 與 fast mode

Fable 5.2 繼承 5.5 族的 adaptive thinking:thinking.disabled 與 budget_tokens 仍 400。深度用 output_config.effort:low / medium / high / xhigh / max。發布說明裡 FrontierCode 2.0 的 49.1% 在 xhigh;日常代理任務多半 medium 或 high 即可。漏寫 effort 時行為隨產品預設走,不應假設與 5.1 相同。

{
  "model": "claude-fable-5-2",
  "max_tokens": 128000,
  "output_config": { "effort": "high" },
  "messages": [{ "role": "user", "content": "..." }]
}

Claude API 上啟用 fast mode 時在請求體外加 beta 頭 fast-mode-2026-02-01,並在 output_config 裡設 speed: "fast"(與 Opus 5.5 fast mode 同一套欄位):

{
  "model": "claude-fable-5-2",
  "max_tokens": 32000,
  "output_config": {
    "effort": "medium",
    "speed": "fast"
  },
  "messages": [{ "role": "user", "content": "..." }]
}

tool_choice 的 any / tool 在 Fable 5.2 上仍 400,與 Opus 5.5、Fable 5.1 一致。要結構化參數用 tool_choice: auto + strict: true 的 JSON Schema,或 Structured Output。見《Opus 5.5 與 tool_choice》。

沿用 Fable 5.1 的硬失敗

從 5.1 升到 5.2 時,下列 JSON 形狀未放鬆:

  • 關 thinking 或手動預算 → 400;只用 adaptive + effort。
  • 強制 tool_choice → 400;改 auto + strict Schema。
  • 改 system / tools / 更早訊息後回放 thinking → 400(2026-08-31 後開立的帳號預設檢查)。
  • Claude API / Google Cloud 上的 computer_20251124 → 400;用 computer_toolset_20260801。

解析響應時仍按 content[].type 取 text 或 tool_use,勿假設第一塊就是答案。與 Haiku 5.5 文同一原則。

響應裡的 usage 與帳單 JSON

Messages 成功響應頂層仍有 usage。常見欄位:

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "content": [ ... ],
  "model": "claude-fable-5-2",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 18240,
    "output_tokens": 4096,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 120000
  }
}

計費:按上方價目乘 token;fast mode 與 Batch 有獨立係數。Fable 5.2 在同等 effort 下可能比 5.1 用更少 token 完成同一任務,但總輸出 token 上限 128k——要把 thinking、tool 往返和最終正文都放進 max_tokens。成本儀表盤應存整條 usage JSON,而不是隻存總數,便於區分 cache read 與 output。

thinking 塊與 5.5 的互讀

Fable 5.2 能讀 Opus 5.5 及更早 Opus / Sonnet / Haiku 產出的 thinking 塊;Fable 5.2 寫的塊可被 Fable / Mythos 5.2 讀回,但 Opus 5.5 不讀 Fable 5.2 的塊——多模型編排時,顧問鏈(5.5 問 Fable)要在 JSON 歷史裡保留塊型別,換模型字串不能丟 signature。

需要看見丟棄了哪些塊時,請求加 thinking-binding-controls-2026-08-01,讀響應頂層 input_transformations。與 Opus 5.5 文描述一致,5.2 未改協議。

護欄回退時的 JSON 形狀

發布說明:Fable 5.2 對高風險網路與生物查詢仍會攔截;被攔時使用者看到的是回退模型(如網路安全回 Opus 4.8、生物回 Opus 5)生成的 content,但你的請求裡 model 仍是 Fable。日誌裡應同時記錄 model 欄位與可選的 stop_reason / 後設資料;若宿主暴露「實際推理模型」,寫入審計 JSON,避免把回退響應當 Fable 基準評測。

誤攔率相對 5.1 宣稱降約 55%;整合側不要靠「永遠 200 且無工具」推斷未觸發護欄。

何時仍用 Opus 5.5

Anthropic 明確:多數編碼與知識任務預設 Opus 5.5;Fable 5.2 適合 scope 大、工具多、長程 agent 的任務。價目上 Opus 輸入輸出更便宜,Fable 在 FrontierCode / RLI 等基準上更高分但更貴。路由 JSON 可做成配置表,例如按任務標籤選擇 model,而不是全域性預設值一刀切。

{
  "routes": [
    { "if": { "task": "daily_coding" }, "model": "claude-opus-5-5" },
    { "if": { "task": "frontier_swe" }, "model": "claude-fable-5-2", "effort": "xhigh" }
  ]
}

上線前核對的 JSON

  1. 請求體:model、output_config、無禁用 thinking / 強制 tool_choice。
  2. fast mode 樣本:頭 + speed: "fast" 與價目 $16/$80 對齊。
  3. 一條真實響應:usage 四項齊全;content 按 type 解析。
  4. 路由配置:生產預設不是 Mythos ID。

用本站 JSON 校驗、JSONPath、JSON Diff 在本機對比 5.1 與 5.2 請求 diff。資料不上傳。

常見問題 FAQ

只把 model 改成 claude-fable-5-2 能上線嗎?

不能當靜默升級。仍帶 thinking.disabled、budget_tokens、強制 tool_choice 或舊 computer 工具會 400。解析若按 content[0] 取答案,thinking 塊會誤導 JSON 流水線。

Fable 5.2 還支援 tool_choice any 嗎?

不支援。與 Opus 5.5、Fable 5.1 相同:any 與 tool 型別返回 400。用 auto + strict JSON Schema 或 Structured Output。

什麼時候該用 Opus 5.5 而不是 Fable 5.2?

官方建議日常編碼與知識工作從 Opus 5.5 開始;任務 scope 大、需要最高 effort 或長程 agent 再切 Fable 5.2。價目上 Opus 更便宜。

fast mode 在 JSON 裡怎麼開?

Claude API:beta 頭 fast-mode-2026-02-01,output_config 裡 speed 設為 fast。按 $16/$80 百萬 token 計價,不是標準 $8/$40。

claude-mythos-5-2 和 claude-fable-5-2 請求有何不同?

同一族權重;Mythos 需核驗組織許可權,護欄更松。model 字串不同,其餘 Messages JSON 形狀相同。不要把 Mythos 寫進公開預設路由。

護欄攔截會改變響應 JSON 嗎?

HTTP 仍 200,content 由回退模型生成。審計層應記錄請求的 model 與實際推理模型,避免混淆評測與帳單歸因。

總結

2026 年 11 月 9 日上線的 Fable 5.2 改的是能力、價目與 effort 刻度,不是 Messages JSON 的外殼。claude-fable-5-2 標準價 $8/$40,fast mode $16/$80;重任務把 effort 提到 xhigh/max;繼承 Fable 5.1 的 thinking 與 tool_choice 限制。上線前在本機 diff 請求 JSON、按 type 解析 content、並把 usage 整條入庫。