作者注：解釋 Claude Code 裏 Fable 默認 Medium、API 不填 effort 時 Fable 5.2 默認 high 的區別，並說明如何在 API 調用中對齊兩邊的用量。
不少開發者先在 Claude Code 裏用 Fable 5.2 寫代碼，覺得 token 消耗還算剋制。之後他們用 API 調用同一個模型 ID，發現同類任務的用量明顯變多，於是懷疑兩邊跑的不是同一個模型。本文給出結論：Claude 應用和 Claude Code 的默認 effort 是 Medium，Claude API 不填 effort 時 Fable 5.2 的默認值是 high。
這不是兩個模型，也不是計費出了問題，差別來自同一個參數在不同入口的默認值。Anthropic 在 2026-11-09 的發佈文和 Claude 平臺的模型頁、Effort 文檔裏都寫明瞭這一點。
核心價值：讀完本文，你會知道爲什麼 Claude Code 和 API 的用量對不上，也知道怎樣在 API 請求裏顯式設置 effort，讓兩邊的成本對比基於同一個檔位。
Claude Code 裏 Fable 默認 Medium 與 API 默認 high 核心要點
先用一張表說明兩個入口的差別。這張表裏的信息都來自官方發佈文、模型頁和 Effort 文檔。
| 要點 | 說明 | 對你的影響 |
|---|---|---|
| Claude Code 默認 Medium | 官方發佈文說明，Medium effort 是 Claude 應用和 Claude Code 的默認 | 在 Claude Code 裏看到的用量，是 Medium 檔的用量 |
| API 默認 high | 模型頁對照表中 Fable 5.2 的 Default effort 是 high，指 Claude API 上 effort 參數的默認值 | API 請求不寫 effort，就按 high 運行 |
| 同一個模型 | 兩邊調用的都是 Fable 5.2，差別只在 effort 檔位 | 不要把用量差異理解成模型版本不同 |
| 可選檔位 | Fable 5.2 支持 low、medium、high、xhigh、max | API 可以顯式設成 medium，與 Claude Code 對齊 |
爲什麼 Claude Code 和 API 調用 Fable 的用量不一樣
effort 參數控制模型在一次任務上投入多少推理和輸出。檔位越高，模型通常會做更充分的思考和展開，消耗的 token 也傾向於更多。檔位越低，模型傾向於更快、更省地給出結果。Claude Code 面向日常編碼交互，默認選擇 Medium，是在效果和消耗之間取平衡。
Claude API 是給開發者直接集成的接口。Fable 5.2 在 API 上的 effort 默認值是 high，也就是說，只要請求體裏沒有出現 effort 參數，服務端就會按 high 處理。很多人從 Claude Code 遷移到 API 時只換了 base_url 和模型 ID，沒有帶上 effort，於是實際運行檔位從 Medium 升到了 high。
Fable 5.2 在 Medium 默認下的官方說法
Anthropic 在 2026-11-09 的發佈文中提到，在 Medium 這個默認檔位下，Fable 5.2 完成困難任務所用的 token 比 5.1 更少。這是官方自報，不是第三方複測結論。這句話說明了 Medium 檔的效率表現，但沒有給出 high 比 Medium 多消耗多少的統一倍數。
所以，不要把 high 比 Medium 貴幾倍當成固定數字。不同任務的複雜度、上下文長度和輸出長度都會影響實際差距，唯一可靠的做法是在你自己的任務上分別跑 medium 和 high，對比 usage 字段。
Fable 5.2 的 effort 檔位與 Claude Code 默認 Medium 對照
下表列出 Fable 5.2 支持的五個檔位，以及它們和兩個入口默認值的關係。各檔位的取向是 effort 參數的一般含義，具體表現以你的任務實際返回爲準。
| effort 檔位 | 是否爲某入口默認 | 一般取向 | 適合的任務 |
|---|---|---|---|
low |
否 | 更快、更省，推理投入少 | 簡單改寫、格式轉換、分類 |
medium |
Claude 應用和 Claude Code 默認 | 效果與消耗平衡 | 日常編碼、常規問答、批量處理 |
high |
Claude API 默認（不填時） | 推理更充分，消耗傾向更高 | 複雜調試、架構分析 |
xhigh |
否 | 比 high 投入更多 | 難度較高的多步推理 |
max |
否 | 最高投入 | 少量關鍵任務，對質量要求極高 |
這張表的重點是中間兩行。你在 Claude Code 裏形成的用量印象來自 medium，而 API 不填參數時跑的是 high。如果目標是復現 Claude Code 的體驗和成本，API 請求裏就應該顯式寫 medium。
如何在 API 裏讓 Fable 5.2 對齊 Claude Code 默認 Medium
下面的步驟不涉及代碼塊，按順序檢查即可。effort 字段在請求體中的具體寫法，請以 Claude 平臺的 Effort 文檔和你所用平臺的接口文檔爲準。
第一步：確認模型 ID 與接入地址
- 在 API易 的模型價目頁 docs.apiyi.com/models 查到 Fable 5.2 對應的模型 ID：
claude-fable-5-2 - 接口地址使用 OpenAI 兼容的 base_url：
https://api.apiyi.com/v1 - 用同一個 API Key 即可調用，不需要爲 Claude 單獨申請賬號
第二步：顯式填寫 effort 參數
- 想和 Claude Code 保持一致：effort 設爲
medium - 需要更強推理：設爲
high，這也是不填時的默認值 - 只是做簡單轉換：可以嘗試
low降低消耗 - 不要依賴默認值，否則日誌裏看不出這次請求跑的是哪個檔位
第三步：用 usage 字段對比兩檔用量
- 選同一批任務，分別用
medium和high各跑一遍 - 記錄每次返回的輸入 token、輸出 token 和緩存讀 token
- 按單價換算成本，得出你自己業務下的實際差距，而不是套用固定倍數
🚀 快速開始：如果想先驗證 effort 檔位對用量的影響，可以在 API易 apiyi.com 用新用戶的免費測試額度跑一組 medium 和 high 的對比。平臺一個 Key 同時支持 Claude、OpenAI、Gemini 等模型，後續換模型對比也不用改接入方式。
Fable 5.2 API 價格與 effort 用量的關係
effort 本身不改變單價，它影響的是一次請求消耗多少 token。所以成本差異等於 token 數量差異乘以單價。下表是 API易 價目頁在 2026-11-11 的數據。
| 模型 ID | 輸入 | 輸出 | 緩存讀 | 分組 | 數據日期 |
|---|---|---|---|---|---|
claude-fable-5-2 |
$8 | $40 | $0.2 | 含 ClaudeCode | 2026-11-11 |
價格單位和最新數值請以 API易 價目頁 docs.apiyi.com/models 的實時標註爲準。從表裏可以看到，輸出單價是輸入的 5 倍。effort 檔位提高後，模型往往會產出更多推理和回答內容，而輸出 token 的單價最高，所以 high 檔的成本增量主要來自輸出部分。
緩存讀的單價遠低於輸入。如果你的請求有大量重複的系統提示詞或固定上下文，開啓緩存能明顯降低輸入側成本。不過緩存隻影響輸入部分，無法抵消 effort 提高帶來的輸出增長。
Fable 5.2 成本估算的正確方法
估算成本時，不要用一句 high 比 Medium 貴幾倍來推算預算。官方只說明了兩個入口的默認值，以及 Medium 檔下 Fable 5.2 比 5.1 更省 token 的官方自報結論，沒有給出 high 與 Medium 之間的統一換算比例。
更穩妥的做法是取 20 到 50 條有代表性的真實任務，分別在兩個檔位下跑一遍，統計平均的輸入、輸出和緩存讀 token。再用上表單價計算每條任務的平均成本，就能得到適用於你自己業務的數據。
Fable 5.2 用量對不上時的排查對照
如果你發現 API 用量和 Claude Code 差距很大，可以按下表逐項排查。
| 現象 | 可能原因 | 處理方法 |
|---|---|---|
| API 用量明顯高於 Claude Code | 請求未填 effort，按默認 high 運行 | 顯式設爲 medium 後重新對比 |
| 填了 effort 但用量沒有變化 | 字段位置或名稱不符合接口要求，被忽略 | 對照 Effort 文檔和平臺接口文檔檢查字段寫法 |
| 請求返回參數錯誤 | effort 值不在支持範圍內 | 只使用 low、medium、high、xhigh、max |
| 模型名稱報錯 | 模型 ID 拼寫不對 | 到 API易 價目頁覈對 claude-fable-5-2 |
| 兩邊設置都是 medium，用量仍有差別 | 上下文長度、工具調用、緩存命中情況不同 | 固定輸入內容後再比較，並單獨看緩存讀 token |
最後一行容易被忽略。Claude Code 在編碼過程中會自動帶入文件內容和對話歷史，而你自己寫的 API 請求未必包含同樣多的上下文。即使 effort 一致，輸入 token 也可能不同，所以對比時最好把輸入固定下來。
常見問題 FAQ
Q1：Claude Code 裏的 Fable 和 API 裏的 Fable 5.2 是同一個模型嗎？
是同一個模型。差別在 effort 參數的默認值：Claude 應用和 Claude Code 默認是 Medium，Claude API 不填 effort 時，Fable 5.2 默認是 high。
Q2：API 不填 effort 會怎樣？
服務端會按 Fable 5.2 在 Claude API 上的默認值 high 運行。這就是很多人從 Claude Code 切換到 API 後覺得用量變多的原因。
Q3：high 比 Medium 貴幾倍？
官方沒有給出統一倍數。effort 不改變單價，隻影響 token 消耗，而消耗差距取決於任務難度、上下文和輸出長度。建議在自己的任務上分別跑兩檔，用 usage 數據計算。
Q4：Fable 5.2 支持哪些 effort 檔位？
根據 Effort 文檔，Fable 5.2 支持 `low`、`medium`、`high`、`xhigh`、`max` 五檔。日常編碼用 `medium` 通常就夠，複雜推理再考慮更高檔位。
Q5：如何通過 API 調用 Fable 5.2 並設置 effort？
可以按下面三步操作：
1. 在 API易 apiyi.com 註冊並獲取 API Key，新用戶有免費測試額度
2. base_url 填 `https://api.apiyi.com/v1`，模型 ID 填 `claude-fable-5-2`
3. 在請求中顯式填寫 effort，字段寫法以 Effort 文檔和平臺接口文檔爲準
Q6：Fable 5.2 在 API易 的價格是多少？
按 2026-11-11 的價目數據，`claude-fable-5-2` 輸入 $8、輸出 $40、緩存讀 $0.2，分組含 ClaudeCode。價格會調整，下單前請以 API易 價目頁的實時數據爲準。
Q7：Medium 檔下 Fable 5.2 比 5.1 更省 token，這個結論可靠嗎？
這是 Anthropic 在 2026-11-09 發佈文中的官方自報，描述的是困難任務上的整體表現。它沒有給出 high 與 Medium 的對比數字。如果你很在意成本，仍然應該用自己的任務數據驗證。
Q8：所有 API 請求都應該改成 medium 嗎？
不一定。要復現 Claude Code 的體驗和成本，用 `medium` 即可。複雜調試或關鍵分析可以保留 `high`，簡單任務可以降到 `low`。關鍵是顯式填寫檔位，不要讓默認值替你做決定。
Claude Code 裏 Fable 默認 Medium 與 API 默認 high 的 Key Takeaways
- 同一模型，不同默認值：Claude Code 默認 Medium，API 不填 effort 時 Fable 5.2 默認 high
- 不填參數就按 high 跑：遷移到 API 時沒帶上 effort，是用量變多最常見的原因
- 五檔可選：Fable 5.2 支持 low、medium、high、xhigh、max
- 沒有固定倍數：官方沒有給出 high 與 Medium 之間的統一換算比例，需要用自己的任務數據計算
- 成本看輸出：輸出單價是輸入的 5 倍，effort 提高後的增量主要來自輸出 token
- 上手路徑簡單：用 API易 的 OpenAI 兼容接口和模型 ID
claude-fable-5-2，即可做檔位對比
總結
關於 Claude Code 裏 Fable 默認 Medium、API 不填就是 high，記住三點：
- 默認值不同：Claude 應用和 Claude Code 默認 Medium，Claude API 上 Fable 5.2 默認 high
- 顯式設置 effort：想和 Claude Code 對齊，就在 API 請求裏寫
medium - 用數據估算成本：不要套用固定倍數，用 usage 字段和單價計算自己的實際差距
下一步，建議你挑一批真實任務分別用 medium 和 high 跑一遍，把結果記入成本模型。可以先在 API易 apiyi.com 用免費額度完成這組對比，再決定生產環境的默認檔位。
📚 參考資料
- Anthropic 發佈文：Fable 與 Mythos 5.2 發佈說明，2026-11-09
- 鏈接：
anthropic.com/claude-fable-and-mythos-5-2 -
說明：Medium effort 是 Claude 應用和 Claude Code 默認檔位的出處，以及 Medium 下比 5.1 更省 token 的官方自報
-
Fable 5.2 模型頁：模型參數對照表
- 鏈接：
platform.claude.com/docs/en/models/fable-5-2/overview -
說明：Default effort 爲 high，即 Claude API 上 effort 參數的默認值
-
Effort 文檔：effort 參數說明
- 鏈接：
platform.claude.com/docs/en/build-with-claude/effort -
說明：Fable 5.2 支持的檔位，以及 API 默認值
-
API易 模型價目頁：模型 ID 與價格
- 鏈接：
docs.apiyi.com/models - 說明：
claude-fable-5-2的輸入、輸出、緩存讀價格與分組信息，數據日期 2026-11-11
作者：APIYI 技術團隊
技術交流：如果遇到 effort 設置或用量對比方面的問題，歡迎在 API易 官網首頁聯繫我們。
