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 整条入库。