作者注：解释 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易 官网首页联系我们。
