> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Fable 5.2 上线：降价 20%，能力再进一步

> Anthropic 于 2026 年 11 月 9 日发布 Claude Fable 5.2，输入输出降至 $8/$40 每百万 tokens，比 5.1 便宜 20%，缓存读取 $0.20。1M 上下文、128K 输出、生成快 30%。API易 已上线 claude-fable-5-2 与 -thinking，双端点，四项计费与官网一致。

## 核心要点

* **价格反向下调 20%**：输入 \$8 / 输出 \$40 每百万 tokens，比 Fable 5.1 的 \$10/\$50 便宜两成；缓存读取 \$0.20，缓存写入（5 分钟）\$10
* **能力全面上台阶**：FrontierCode 2.0 从 32.4% 提升到 **49.1%**，AutomationBench 从 31.4% 到 **51.4%**，RoboDojo Sim 从 27.6% 到 **64.9%**
* **更快、更省**：输出生成速度比 5.1 快最多 30%；High effort 下与 Opus 5.5 的最高分持平，每任务成本约一半
* **规格不变**：100 万 tokens 上下文（默认即最大）、128,000 tokens 最大输出、自适应思考恒开
* **⚠️ 四项破坏性变更**：历史前缀校验对所有账号强制生效、思考块与模型绑定、`computer_20251124` 工具报错、advisor 工具需同代配对——迁移前必读
* **API易 已上线**：`claude-fable-5-2` 与 `claude-fable-5-2-thinking`，OpenAI 兼容与 Anthropic 原生双端点，四项计费与官网一致

## 背景介绍

2026 年 11 月 9 日，Anthropic 发布 Claude Fable 5.2 与 Claude Mythos 5.2。这是 Fable 级模型自 9 月 1 日 5.1 上线后的再次迭代，距上一代不到三个月。

与 5.1「同价升级」的策略不同，5.2 这次是**降价 + 提速**：输入从 \$10 降到 \$8，输出从 \$50 降到 \$40，官方同时把输出生成速度提升了最多 30%。对一个定位「高难度推理与长周期 Agent 工作」的旗舰模型来说，这个组合比单纯刷榜更实际——它意味着同样的预算能跑更多轮 Agent 循环。

Fable 5.2 与 Mythos 5.2 依然是**同一个底层模型的两种护栏配置**：Fable 面向全部用户，带网络安全与生物安全护栏；Mythos 只向通过验证计划的组织开放，规格与价格完全相同。

官方对选型给了明确建议：日常编程与知识工作**先用 Opus 5.5**，只有当 Opus 在高 effort 下仍达不到要求时，再向上切到 Fable 5.2；反过来，任务简单就向下用 Sonnet 5.5 或 Haiku 5.5。

API易 已同步上线 `claude-fable-5-2` 与 `claude-fable-5-2-thinking`，输入、输出、缓存读取、缓存写入四项计费与官网一致。

## 详细解析

### 价格：这次是降的

| 计费项 | Fable 5.2 | Fable 5.1 | 变化 |
| - | - | - | - |
| 输入 | \$8.00 / 1M | \$10.00 / 1M | 降 20% |
| 输出 | \$40.00 / 1M | \$50.00 / 1M | 降 20% |
| 缓存读取 | \$0.20 / 1M | \$0.25 / 1M | 降 20% |
| 缓存写入（5 分钟） | \$10.00 / 1M | \$12.50 / 1M | 降 20% |

官方另有一个可选的 **fast 模式**：\$16 输入 / \$80 输出，token 生成速度最高提升 2.5 倍。这个模式按官网口径是「标准速率的 2 倍价格」，适合对时延敏感、且能接受溢价的场景。API易 当前按标准速率计费，未单独提供 fast 变体。

### 性能：几乎每一项都领先上一代

官方公布的对比数据（Fable 5.2 / Fable 5.1 / Opus 5.5，均为各自最高 effort、护栏开启）：

| 基准测试 | Fable 5.2 | Fable 5.1 | Opus 5.5 | 说明 |
| - | - | - | - | - |
| **FrontierCode 2.0** | **49.1%** | 32.4% | 45.5% | Agent 编程（能否被合并） |
| **FrontierSWE v2** | **69.9%** | 56.3% | 62.3% | Agent 式软件工程 |
| **AutomationBench** | **51.4%** | 31.4% | 42.5% | 商业工作流自动化 |
| **Terminal-Bench-Science 0.1** | **74.6%** | 52.6% | 58.7% | Agent 式科研任务 |
| **WANDR** | **82.1%** | 68.7% | 72.3% | Agent 式搜索 |
| **OSWorld 2.1** | **89.3%** | 83.5% | 87.2% | 计算机操作 |
| **RoboDojo Sim** | **64.9%** | 27.6% | 39.4% | 机器人仿真 |
| **AA-Briefcase v1.1** | **66.1%** | 61.5% | 61.2% | 知识工作（评分卡） |
| **Remote Labor Index** | **41.3%** | 17.9% | 21.3% | 远程工作任务 |
| **Humanity's Last Exam（带工具）** | **74.2%** | 65.6% | 67.7% | 跨学科推理 |
| **Chartography** | **73.4%** | 44.8% | 64.4% | 图表视觉识别 |

横向对比里，GPT-6 Astra 在 FrontierSWE v2 上拿到 65.5%、Gemini 4 Carbon 在 AutomationBench 上拿到 53.9%，各有一项反超；但整体上 Fable 5.2 是这份表里领先项最多的模型。

RoboDojo Sim（27.6% → 64.9%）和 Chartography（44.8% → 73.4%）是提升幅度最大的两项，分别对应机器人操作与图表视觉——这两块恰好是 5.2 重点补强的方向。

### 效率：同样的分数，一半的钱

官方给出的效率口径比绝对分数更有参考价值：

* 在 **FrontierCode 2.0 的 High effort** 下，Fable 5.2 拿到 45.3%，与 Opus 5.5 的最高分 45.5% 基本持平，**每任务成本约为后者的二分之一**
* 在 **Medium effort**（Claude 应用与 Claude Code 的默认档）下，完成同样难度的任务比 5.1 消耗更少的 token
* 在 **Xhigh effort** 下达到 49.1%，是官方测试过的已发布模型里的最高分

这意味着对 Agent 类负载，5.2 的性价比优势不只来自单价降了 20%，还来自「同样的任务用更少的 token」。

### 技术规格

| 参数 | 规格 |
| - | - |
| **模型标识** | `claude-fable-5-2` / `claude-fable-5-2-thinking` |
| **上下文窗口** | 1,000,000 tokens（默认即最大，全窗口统一单价） |
| **最大输出** | 128,000 tokens |
| **思考模式** | 自适应思考恒开，通过 `effort` 参数控制深度 |
| **effort 档位** | `low` / `medium` / `high` / `xhigh` / `max` |
| **分词器** | 与 Opus 4.7 起启用的一致 |
| **API 格式** | OpenAI 兼容 `chat/completions` / Anthropic 原生 `messages` |
| **API易 分组** | `ClaudeCode`、`Claude_Enterprise`、`Default`、`SVIP` |

> 与 5.1 相比，API易 侧 `claude-fable-5-2` 暂未开放 `Claude_Reverse` 分组，其余分组一致。

## ⚠️ 四项破坏性变更（迁移必读）

> [!WARNING]
>
> 如果你已经在调用 `claude-fable-5-1`，下面四点在切换模型名之前必须核对，其中前两条会直接导致 400 报错。

### 1. 历史前缀校验对所有账号强制生效

API 的 prefix check 会校验「Fable 5.2 思考块之前的所有内容」自产出以来有没有被改过：`system` 提示词、`tools` 数组、以及更早的任何一条消息。

在 **Fable 5.1** 上，这项校验只对 2026 年 8 月 31 日及之后创建的账号强制生效，老账号只是记录不阻断。**在 Fable 5.2 上，所有账号一律强制**，请求一旦带上失效的思考块、又没设置 `prefix_mismatch_behavior`，就返回 400：

```text theme={null}
The block is bound to a different conversation
```

临时解法是带 `thinking-binding-controls-2026-08-01` beta 头，并设置 `thinking.block_binding.prefix_mismatch_behavior` 为 `"drop_block"`，让 API 丢弃受影响的块继续跑，被丢弃的块会出现在响应的 `input_transformations` 数组里。但这只是过渡手段——丢块会推高输出 token，根因还是要把会话改成只追加（append-only）。

### 2. 思考块与产出它的模型绑定

每个思考块都记录产出模型，且只能由特定模型读取。Fable 5.2 与 Mythos 5.2 **能互相读取**，也能读 Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1、Mythos 5.1、Opus 5、Fable 5、Mythos 5 以及更早的 Opus / Sonnet / Haiku 的思考块。

**反向不成立**：从 Fable 5.2 切到任何其他模型（包括 Opus 5.5、Fable 5.1），那些轮次的推理都会丢失。请求里带目标模型读不了的块时，API 会在模型看到之前静默丢弃，且不计费；带 beta 头可以在 `input_transformations` 里看到丢弃记录。

### 3. `computer_20251124` 工具不再可用

旧版 computer use 工具 `computer_20251124` 在除 Amazon Bedrock 之外的所有平台返回错误，迁移到 5.2 需要改用新的 computer use 工具集。

### 4. advisor 工具必须同代配对

如果使用 advisor 工具，Fable 5.2 作为 executor 时，advisor 也必须是 Fable 5.2 或 Mythos 5.2，不能搭配更早的 advisor 模型。

## 实际应用

### 代码示例

用 OpenAI 兼容格式调用 `claude-fable-5-2`，先设置环境变量 `APIYI_API_KEY`：

```python theme={null}
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1"
)

response = client.chat.completions.create(
    model="claude-fable-5-2",
    messages=[
        {"role": "user", "content": "把这个仓库里三处重复的鉴权逻辑抽成一个模块，列出改动文件并说明如何回归测试。"}
    ]
)

print(response.choices[0].message.content)
```

也可以走 Anthropic 原生 `messages` 格式，`model` 字段相同。长周期 Agent 任务建议用流式返回，并按步骤检查 `stop_reason` 与中间结果。

### 推荐场景

> [card] 长周期 Agent 编程
>
> FrontierCode 2.0 与 FrontierSWE v2 双料领先，适合多文件迁移、大规模重构与需要数小时连续执行的编码任务

> [card] 业务流程自动化
>
> AutomationBench 51.4%，适合跨系统、多步骤的自动化流程与数据处理

> [card] 深度研究与搜索
>
> WANDR 82.1%，适合多轮网页研究、线索追问与结论汇总

> [card] 计算机操作
>
> OSWorld 2.1 达 89.3%，适合浏览器与桌面应用操作；注意旧版 computer use 工具需替换

### 使用建议

1. **迁移先测 prefix check**：把会话改成只追加，不要编辑、重排或删除更早的轮次；临时用 `drop_block` 兜底，但不要长期依赖。
2. **按任务调 effort**：难的步骤用 `high` / `xhigh`，常规步骤降到 `medium`，能在不牺牲质量的前提下明显降低成本。
3. **不要跨代复用思考块**：从 5.2 切回 5.1 或 Opus 5.5 时，之前轮次的推理会丢失，需要重新组织上下文。
4. **fast 模式按需**：对时延敏感、又能接受 2 倍价格的任务，可以考虑官网的 fast 模式；API易 当前走标准速率。

## 价格与可用性

### 定价信息

| 计费项 | 每 1M tokens 单价 |
| - | - |
| 输入 | \$8.00 |
| 输出 | \$40.00 |
| 缓存读取 | \$0.20 |
| 缓存写入（5 分钟） | \$10.00 |

> [!NOTE]
>
> 模型价格与官网对齐，且可能随官网调整；上表仅供参考，具体以顶部导航「模型价格」栏目为准：[模型价格](https://docs.apiyi.com/models/index.md)。

### 可用分组

`ClaudeCode`、`Claude_Enterprise`、`Default` 与 `SVIP` 四个分组均已开放该模型，`claude-fable-5-2` 与 `claude-fable-5-2-thinking` 在两个端点下保持一致。

其中 `Claude_Enterprise` 是更稳定的 Claude 官转通道，面向企业客户的保障与应急需求，纯官转、不含 AWS Claude（Not include Amazon Claude），分组倍率 **1.2x**；`ClaudeCode` 分组倍率 0.95x。`Default` 与 `SVIP` 分组同样已上架该模型。

`Claude_Reverse` 分组暂未开放。

### 叠加网站充值活动

上述价格为默认标价，可叠加充值赠送与分组优惠，实际扣费以控制台为准。活动规则见[充值活动说明](https://docs.apiyi.com/faq/recharge-promotions.md)。

## 总结与建议

Fable 5.2 是少见的「降价 + 提速 + 能力提升」三件事同时发生的版本。对已经在跑 Agent 负载的团队，它带来的不是「要不要换」的问题，而是「什么时候迁移」的问题——单价降 20%、token 消耗更低、每任务成本约为 Opus 5.5 的一半，这三项叠加后的差距比单价本身更大。

* **高难度 Agent 编程与迁移**：FrontierCode 2.0 与 FrontierSWE v2 双料第一，优先替换长链路任务
* **预算敏感的长周期任务**：High effort 下与 Opus 5.5 持平但成本减半，适合把 Opus 跑不动的任务上移
* **日常编程与知识工作**：按官方建议继续用 Opus 5.5，不必为简单任务付 Fable 的价格
* **迁移前**：务必把 prefix check 与思考块绑定这两条过一遍，这两处是最容易踩的坑

> [!NOTE]
>
> **信息来源与核验日期**：
>
> * Anthropic 发布公告：`anthropic.com/claude-fable-and-mythos-5-2`（2026-11-09）
> * 模型概览：`platform.claude.com/docs/en/models/fable-5-2/overview`
> * 变更说明：`platform.claude.com/docs/en/models/fable-5-2/whats-new-fable-5-2`
> * 定价页：`platform.claude.com/docs/en/about-claude/pricing`
> * API易 实时模型接口：`api.apiyi.com/api/pricing`
> * 资料检索与价格核验日期：2026 年 11 月 10 日


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.