Claude Fable 5.2 API 接入指南：模型 ID、计费与 Claude Code

截至 2026-11-11 的模型目录，Router One 以 anthropic/claude-fable-5.2 列出 Claude Fable 5.2；网关同时接受 Anthropic 官方 id claude-fable-5-2，对应同一个目录条目。用 Router One 的 Key 向 https://api.router.one/v1/messages 发 "model": "claude-fable-5-2"，或者把 OpenAI 兼容客户端的 base URL 换成 https://api.router.one/v1，请求就会像目录里其他模型一样被路由、计费并记入日志。截至 2026-11-11 的套餐接口，Pro、Max、Ultra 没有任何档位列出 Claude Fable 5.2，所以无论是否订阅，每次调用都按 token 从钱包扣费，实时单价看 Claude Fable 5.2 模型页。

本文依次讲清：目录对这个 id 列出了什么；Anthropic 官方对它在自家 API 上的说明；在 Router One 上怎么在 Claude Fable 5.2、Claude Fable 5.1 与 Claude Opus 5.5 之间选；费用和套餐怎么算；Claude Code 怎么选到它；两个端点上的第一个请求怎么发；以及哪些客户端能调用。文中的目录、套餐信息与 Anthropic 的说法都注明了日期，发起新请求前以实时目录为准。

Claude Fable 5.2 速览

Router One 只在 /v1/messages 与 /v1/chat/completions 上提供 Claude 系列 id；各模型系列的端点规则见 API 兼容性事实页。

Anthropic 官方怎么说明 Claude Fable 5.2

Anthropic 的发布说明（2026-11-09 条目）与 Claude Fable 5.2 概览页（均为 2026-11-11 核对）就 Anthropic 自家的 API 给出以下说明：

• 发布与 ID。 Anthropic 于 2026-11-09 发布 Claude Fable 5.2，模型 ID 为 claude-fable-5-2，定位是 "built for demanding reasoning and long-horizon agentic work"（面向高难度推理与长周期的 Agent 工作）。Anthropic 的模型总览（2026-11-11 核对）现在把 Claude Fable 5.1 与 Claude Fable 5 列在仍可使用的旧版模型里。
• 上下文与输出。 上下文窗口 1M token；最多输出 128K token，这是 Anthropic 给出的同步 Messages API 输出上限。
• 思考与 effort。 自适应思考始终开启，不能关闭：按 Anthropic 的迁移指南（2026-11-11 核对），thinking: {"type": "disabled"} 与手动扩展思考（budget_tokens）都返回 400 错误，强制工具调用（tool_choice 为 any 或 tool）也一样。Anthropic 的 effort 文档（2026-11-11 核对）为这个模型列出全部五个 effort 档位，API 默认是 high，并建议从这一档开始。
• 采样参数。 按同一份迁移指南，请求里不带 temperature、top_p 与 top_k，与 Claude Fable 5.1 相同；会返回 400 错误的取值见 Anthropic 的思考文档。
• 前缀检查。 Claude Fable 5.2 对所有账户执行 Anthropic 的前缀检查，不论账户新旧：请求改动了 system 提示词、tools 或之前的消息，又把后面某一轮产生的 Claude Fable 5.2 thinking 块传回去，就会返回 400 错误（除非请求启用了 Anthropic 的 beta 设置 drop_block）。Anthropic 的迁移指南补充说，由 Claude Code 或 Claude Agent SDK 维护对话历史时不需要改动。
• thinking 块。 Claude Fable 5.2 产生的 thinking 块只在产生它的账户（或与之关联的账户）里有效；按迁移指南，别的账户传回这样的块，Anthropic 的 API 会把它丢掉，请求照常成功。按 Anthropic 的说明，Claude Opus 5.5 与 Claude Fable 5.1 都无法读取 Claude Fable 5.2 的 thinking 块，所以对话从 Claude Fable 5.2 换到这两个模型后，后面的轮次没有之前的推理。
• computer use。 这个模型通过 computer_toolset_20260801 工具集使用 computer use；在 Anthropic 的 API 上，声明旧工具 computer_20251124 的请求会返回 400 错误。
• advisor 工具。 Anthropic 的 advisor 工具仍是 beta；以 Claude Fable 5.2 作执行模型时，advisor 只能是 Claude Fable 5.2 或 Claude Mythos 5.2，换成别的模型会返回 400 错误。

同一条发布说明还发布了 Claude Mythos 5.2，Anthropic 只向通过其验证项目的组织提供；2026-11-11 的 Router One 模型目录没有列出任何 Claude Mythos id。以上是 Anthropic 对自家 API 的说法；Router One 负责的是目录条目本身，以及网关如何路由和计费。把一类任务迁过去之前，先用自己的提示词测一遍代码依赖的请求形态（思考设置、工具定义、改动过的对话历史）。

Claude Fable 5.2、Claude Fable 5.1 还是 Claude Opus 5.5？

这一节只比 Router One 管得着的地方（调用扣哪份套餐额度、走哪些端点、公示单价），不比输出质量：把一类任务迁过去之前，先用自己的提示词把候选模型都跑一遍。截至 2026-11-11 的模型目录与套餐接口：

三者的端点和计费方式相同，所以在 Router One 上你能比的是公示单价：对比 Claude Fable 5.2、Claude Fable 5.1 与 Claude Opus 5.5 三个模型页，或者打开 Claude Fable 5.2 vs Claude Opus 5.5，那一页并排渲染两者的规格与实时单价。如果想让 Claude 调用扣套餐额度，截至 2026-11-11 的套餐接口，Claude Opus 5（anthropic/claude-opus-5）在 Pro、Max、Ultra 的「高级模型」档。

Anthropic 自己的建议，来自它的模型总览（2026-11-11 核对）：大多数任务先从 Claude Opus 5.5 开始；高难度推理、长周期的 Agent 工作，或者在 Claude Opus 5.5 上调高 effort 后评测仍不达标时，再用 Claude Fable 5.2。Anthropic 的 Claude Fable 5.1 概览页（2026-11-11 核对）把 Claude Fable 5.1 标为旧版模型，说它仍可使用，同时建议迁移到 Claude Fable 5.2。

按 Anthropic 的迁移指南（2026-11-11 核对），换过来时要注意：

• 从 Claude Fable 5.1 换过来。 Anthropic 说迁移基本上直接替换即可；上面的前缀检查、thinking 块规则、computer use 工具集与 advisor 搭配，是可能让代码出错的四项改动。
• 从 Claude Opus 5.5 换过来。 Anthropic 列出的变化里，有一条是它的 API 上默认 effort 从 medium 变成 high，不传 effort 的请求会高一档运行，所以请显式设置。按 Anthropic 的说明，在 Claude API 上 Claude Fable 5.2 能读取 Claude Opus 5.5 的 thinking 块，反过来不行。

费用怎么算

Claude Fable 5.2 按 token 计费，单价以模型页公示的输入与输出单价为准。Router One 为每个模型单独公示单价，部分模型最低官方价 1 折；本文不印每 token 单价，因为它会过时。截至 2026-11-11 的套餐接口，没有套餐档位列出 Claude Fable 5.2，所以无论是否订阅，每次调用都按公示单价从钱包扣费。

按 Anthropic 的迁移指南（2026-11-11 核对），这个模型的自适应思考始终开启。思考产生的输出按模型公示的输出单价计费，没有单独的推理价格行（定价事实页），所以 effort 既影响质量也影响成本：先按任务测量，再定默认值。Anthropic 自家的 API 另有定价；Router One 对这个 id 收取的单价以模型页为准。

控制台 → 日志里每次调用都带模型、Token、钱包扣费或套餐扣减次数、延迟和状态（每请求可观测）。一个任务扣了多少钱包余额，可以按它发出的调用逐条加总，不必凭单价估算。

订阅套餐覆盖 Claude Fable 5.2 吗？

截至 2026-11-11 的套餐接口，不覆盖：Pro、Max、Ultra 没有任何档位列出 claude-fable-5-2，所以无论是否订阅，Claude Fable 5.2 的调用都按公示单价从钱包扣费。同一份套餐接口里，Claude Fable 5.1 与 Claude Opus 5.5 也不在任何档位，Claude Opus 5 在三个套餐的「高级模型」档。套餐的模型列表会调整，实时列表以价格页为准。

Claude Code 与 fable 别名

按 Claude Code 的更新日志与模型配置文档（Claude Code 2.1.322，2026-11-11 核对），从 2.1.257 起到 2.1.321 之前，fable 别名请求 claude-fable-5-1；从 2.1.321 起请求 claude-fable-5-2；同一份文档写明 Claude Fable 5.2 需要 Claude Code 2.1.321 或更高版本。按 Claude Code 的网关协议文档（2026-11-11 核对），通过 ANTHROPIC_BASE_URL 设置的网关会被 Claude Code 当作 Claude API，所以指向 Router One 的会话发出的也是这些 id。截至 2026-11-11 的模型目录，Router One 两个模型都列出（目录 id anthropic/claude-fable-5.1 与 anthropic/claude-fable-5.2），也接受这两个官方 id；截至 2026-11-11 的套餐接口，没有套餐档位列出 Claude Fable 5.2 或 Claude Fable 5.1，所以这些调用都按 token 从钱包扣费。

让会话跑在 Claude Fable 5.2 上有三种做法：

• 在 Claude Code 2.1.321 或更高版本里用 /model fable，或以 claude --model fable 启动（claude --version 显示你用的版本）。
• /model claude-fable-5-2，按 id 选择这个模型。
• ANTHROPIC_MODEL=claude-fable-5-2，设为会话的主模型。写在 shell 配置文件里；如果是一键安装写的配置，就写在 ~/.claude/settings.json 的 env 块里，因为安装脚本只设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，不设模型：

export ANTHROPIC_BASE_URL=https://api.router.one
export ANTHROPIC_AUTH_TOKEN=sk-your-api-key
export ANTHROPIC_MODEL=claude-fable-5-2

之前按旧说明设过 ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5-1 的，可以删掉这一行，别名就会随 Claude Code 指向 Claude Fable 5.2；想让别名继续停在 Claude Fable 5.1 的，保留即可。在 Claude Code 里请用官方 id 或别名：Claude Code 的模型配置文档（2026-11-11 核对）为 Claude Fable 5.2 给出的就是这两种写法；按它的网关协议文档（2026-11-11 核对），遇到不认识的模型 id，Claude Code 会按 200K 上下文窗口处理。全新安装见 Claude Code 配置指南。

发出第一个请求

1. 创建 Key。 控制台 → API 密钥 → 创建密钥，Key 形如 sk-...。试用阶段给这把 Key 设一个 maxSpend 消费上限。每把 Key 的消费上限（maxSpend）限的是这把 Key 能从钱包扣的钱：累计扣费到上限后，这把 Key 上需要钱包付费的请求返回 HTTP 402。套餐额度覆盖的请求从账户共用的套餐额度里扣，不计入任何 Key 的上限。其他 Key 照常可用（按 Key 成本追踪）。
2. 准备钱包余额。 无论是否订阅，Claude Fable 5.2 的调用都从钱包扣费（2026-11-11 的套餐接口）；充值在控制台 → 充值。
3. 按客户端选 base URL。 Anthropic 原生 SDK 与工具填 https://api.router.one（SDK 的 base_url，或 ANTHROPIC_BASE_URL），在它下面调用 /v1/messages；OpenAI 兼容 SDK 填 https://api.router.one/v1。
4. 调用模型。 下面的示例都用 claude-fable-5-2；同一个字段填目录 id anthropic/claude-fable-5.2 也可以。

用 curl 调用 Messages API，开启流式，effort 设为 high（这是 API 默认值，也是 Anthropic 的 effort 文档（2026-11-11 核对）建议的起点）：

curl https://api.router.one/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 32000,
    "stream": true,
    "output_config": {"effort": "high"},
    "messages": [{"role": "user", "content": "阅读这份故障时间线，写一份根因分析，并给出三条后续行动。"}]
  }'

用 Anthropic Python SDK 发同样的请求（pip install -U anthropic），只需要改 base_url 和 Key。响应开头可能有一个或多个 thinking 块，所以按块类型读取内容，不要按位置取：

import anthropic

client = anthropic.Anthropic(
    base_url="https://api.router.one",
    api_key="sk-your-api-key",
)

with client.messages.stream(
    model="claude-fable-5-2",
    max_tokens=32000,
    output_config={"effort": "high"},
    messages=[{"role": "user", "content": "阅读这份故障时间线，写一份根因分析，并给出三条后续行动。"}],
) as stream:
    message = stream.get_final_message()

for block in message.content:
    if block.type == "text":
        print(block.text)
print(message.stop_reason, message.usage)

用 OpenAI Python SDK 调用 Chat Completions（pip install -U openai），适合 OpenAI 兼容的代码；这里的 base URL 以 /v1 结尾：

from openai import OpenAI

client = OpenAI(
    base_url="https://api.router.one/v1",
    api_key="sk-your-api-key",
)

response = client.chat.completions.create(
    model="claude-fable-5-2",
    max_tokens=32000,
    messages=[
        {"role": "user", "content": "阅读这份故障时间线，写一份根因分析，并给出三条后续行动。"},
    ],
)
print(response.choices[0].message.content)
print(response.choices[0].finish_reason, response.usage)

两个端点都适用的几条规则：

• 每个请求都显式设置 max_tokens。 思考也计入这个上限：按 Anthropic 的迁移指南（2026-11-11 核对），上限设得太小，响应可能在 thinking 块之后、正文之前就停下，所以要给两者都留出余量。Router One 的 Chat Completions 也接受 max_completion_tokens 作为同一个上限（两者都传时以 max_completion_tokens 为准）。
• 长任务用流式。 stream: true 让输出边生成边返回（流式输出指南）。
• 保持充足的钱包余额。 请求执行前，网关会按预估额从余额中预留；余额不够时，网关会把 max_tokens 调低到余额能覆盖的数值，长回答可能因此被截断。余额连这次请求的初始预留都覆盖不了时，网关会在模型运行前返回 HTTP 402。
• 不要传 temperature、top_p 与 top_k。 按 Anthropic 的迁移指南（2026-11-11 核对），在 Claude Fable 5.2 上这三个参数都不带；Anthropic 的相关规则汇总在 Claude 采样参数报错页。
• messages 以 user 轮结尾。 按 Anthropic 的迁移指南（2026-11-11 核对），预填 assistant 消息会返回 400 错误；格式与语气要求写进 system 提示词。
• 文件直接内联。 Router One 不提供 Files API：图片以 base64 内容块发送。

走哪个端点。 推荐用 /v1/messages：它是 Anthropic 自己的请求格式，也是 Claude Code 发送的格式，上面 Anthropic 关于 thinking 块与 effort 的规则都是按它写的，所以多轮工具调用请走这个端点。/v1/chat/completions 为只支持 OpenAI 格式的客户端提供同一个 id。

5. 看 Trace。 控制台 → 日志里每次调用都带模型、Token、钱包扣费或套餐扣减次数、延迟和状态（每请求可观测）。可重试的上游故障由同一模型多条候选线路之间的自动故障转移消化；Claude Fable 5.2 的请求绝不会被换成别的模型来回答。

网关在调用任何模型之前就拒绝的请求，在控制台 → 日志里没有记录，原因看状态码和错误信息：401 说明 Key 没有通过校验；402 说明钱包余额或这把 Key 的 maxSpend 不够覆盖这次请求的初始预留；404 说明路径或模型 id 不存在，请照目录原样复制 id。其他状态码见错误码速查。

哪些客户端能调用

Claude Code 与 Anthropic SDK 在 /v1/messages 上调用 Claude Fable 5.2：把它们指向 https://api.router.one，填 Router One 的 Key（CLI 配置、Claude Agent SDK 接入）。凡是支持 Chat Completions、能填自定义 base URL 的客户端，都能在 /v1/chat/completions 上调用它：官方 OpenAI SDK（OpenAI SDK 接入），以及集成目录里的聊天应用与框架。给这类客户端填上 base URL https://api.router.one/v1，model 写 claude-fable-5-2。

Codex CLI 调不了 Claude Fable 5.2。Codex CLI 向 /v1/responses 发送 Responses API 请求，而 Router One 不在这个端点上提供 Claude 系列 id：这样的请求会在调用任何模型之前被 HTTP 400 拒绝（API 兼容性事实页）。Codex CLI 请用在 /v1/responses 上提供的 id，例如 GPT 系列。

常见问题

Router One 上 Claude Fable 5.2 的模型 ID 是什么？ 截至 2026-11-11 的模型目录，目录 id 是 anthropic/claude-fable-5.2；网关同时接受 Anthropic 官方 id claude-fable-5-2，对应同一个目录条目。在 Claude Code 和 Anthropic SDK 的代码里请用 claude-fable-5-2。截至 2026-11-11 的套餐接口没有档位列出这个模型，所以两种 id 都按 token 从钱包扣费。

Claude Fable 5.2 API 价格是多少？ 在 Router One 上按 token 计费，单价以 Claude Fable 5.2 模型页公示的输入与输出单价为准，部分模型最低官方价 1 折；本文不印具体数字，因为它会过时。截至 2026-11-11 的套餐接口没有档位列出这个模型，所以每次调用都从钱包扣费，思考产生的输出按公示的输出单价计费。

Claude Fable 5.2 在 Router One 订阅套餐里吗？ 不在。截至 2026-11-11 的套餐接口，Pro、Max、Ultra 没有任何档位列出它，所以无论是否订阅，它的调用都按 token 从钱包扣费。按同一份套餐接口，Claude Opus 5 在三个套餐的「高级模型」档。各套餐的模型列表见价格页。

在 Claude Code 里怎么用 Claude Fable 5.2？ 在 Claude Code 2.1.321 或更高版本里用 /model fable，或以 claude --model fable 启动；/model claude-fable-5-2 与 ANTHROPIC_MODEL=claude-fable-5-2 按 id 选择它。按 Claude Code 的更新日志与模型配置文档（Claude Code 2.1.322，2026-11-11 核对），从 2.1.257 起到 2.1.321 之前，fable 别名请求 claude-fable-5-1；从 2.1.321 起请求 claude-fable-5-2。截至 2026-11-11 的模型目录，Router One 两个模型都列出，也接受这两个官方 id。

我之前把 fable 别名固定到了 Claude Fable 5.1，还需要那一行吗？ 不需要。截至 2026-11-11 的模型目录，Router One 列出了 Claude Fable 5.2，也接受它的官方 id，所以可以删掉这一行，让 fable 别名随 Claude Code 2.1.321 或更高版本指向 claude-fable-5-2。想让别名继续停在 Claude Fable 5.1 的，保留这一行即可；截至 2026-11-11 的套餐接口，两个模型都不在套餐档位，都从钱包扣费。

Claude Fable 5.2 的上下文窗口和最大输出是多少？ 按 Anthropic 的 Claude Fable 5.2 概览页（2026-11-11 核对），上下文窗口 1M token，在 Anthropic 的同步 Messages API 上最多输出 128K token。思考也计入 max_tokens，所以要显式设置并给两者都留出余量，再看 stop_reason：值为 max_tokens 说明触到了上限。Router One 模型页显示这个 id 的实时目录条目。

Claude Fable 5.2 能关闭思考或设置 temperature 吗？ 在 Anthropic 自家的 API 上不能。按 Anthropic 的迁移指南（2026-11-11 核对），自适应思考始终开启，把 thinking 设为 disabled 或手动设预算都返回 400 错误，思考深度由 effort 参数控制。Anthropic 的这份指南还要求请求里不带 temperature、top_p 与 top_k。

Codex CLI 或 Responses API 能调用 Claude Fable 5.2 吗？ 不能。Router One 在 /v1/messages 与 /v1/chat/completions 上提供 Claude 系列 id，/v1/responses 不提供，发到那里的请求会在调用任何模型之前被 HTTP 400 拒绝。Codex CLI 只支持 Responses 格式，请让它用在那个端点上提供的 id，例如 GPT 系列。

该用 Claude Fable 5.2 还是 Claude Opus 5.5？ Anthropic 的模型总览（2026-11-11 核对）建议：大多数任务先从 Claude Opus 5.5 开始；高难度推理、长周期的 Agent 工作，或者在 Claude Opus 5.5 上调高 effort 后评测仍不达标时，再用 Claude Fable 5.2。在 Router One 上，截至 2026-11-11 的模型目录两者都在列，都在同样的两个端点上提供；截至 2026-11-11 的套餐接口，两者都不在套餐档位，所以你能比的是各自模型页上的公示单价。

Claude Fable 5.2 的调用怎么付费？ 从钱包扣：截至 2026-11-11 的套餐接口，Claude Fable 5.2 的每次调用都按 token 从钱包扣费。支付宝或银行卡在同一个托管收银台完成充值，也支持 6 条链上的 USDT/USDC（Tron、BSC、以太坊、Polygon、Base、Arbitrum），无需美国信用卡。

下一步

• 打开 Claude Fable 5.2 模型页，查看实时单价与端点。
• 在对比页上把它和 Claude Opus 5.5 放在一起看。
• 各套餐的额度与各档列出的模型，见价格页。
• 配置终端 agent，见 Claude Code 配置指南。
• 传 temperature、top_p 或 top_k 收到 400？见 Claude 采样参数报错页。