在 TopxAI 升级到 Claude Fable 5.2

2026-11-10 · anthropic, models, api, topxai

更新 Fable 模型 ID，所有价格比 Fable 5.1 低 20%，并核对对话历史、计算机工具和 advisor 的设置。

在 TopxAI 的 Claude 共享池和官方线路上使用 claude-fable-5-2，上游模型 ID 也是这个名字。Anthropic 于 2026 年 11 月 9 日发布了这个模型。它直接取代 Fable 5.1：旧 ID claude-fable-5-1 退出目录，请求返回 HTTP 403，不转发到新模型。所有价格都比 Fable 5.1 低 20%。

更新客户端和密钥

把 SDK 或编码客户端里保存的模型 ID 换成新值。基础地址无需调整，没有模型限制的密钥也能继续使用。设有允许模型列表的密钥，请另外编辑该列表；只改客户端模型名不会扩大密钥权限。

Claude Code 用户应更新 shell 或 ~/.claude/settings.json 中的 ANTHROPIC_MODEL：

export ANTHROPIC_BASE_URL=https://ai.topxea.com
export ANTHROPIC_AUTH_TOKEN=$TOPXAI_API_KEY
export ANTHROPIC_MODEL=claude-fable-5-2
claude

长期设置方法见 Claude Code 接入文档。直接调用 Messages 接口可以这样写：

curl https://ai.topxea.com/v1/messages \
  -H "x-api-key: $TOPXAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-fable-5-2","max_tokens":4096,"output_config":{"effort":"high"},"messages":[{"role":"user","content":"分析这个 API 设计的取舍。"}]}'

两条线路的价格

以下为默认美元价格，单位是每百万 token，依据 2026 年 11 月 10 日核对的 Anthropic 价格页：

类别	共享池	官方线路	Anthropic 官网价
输入	$4	$7.20	$8
输出	$20	$36	$40
缓存读取	$0.10	$0.18	$0.20
缓存写入，5 分钟	$5	$9	$10
缓存写入，1 小时	$8	$14.40	$16

共享池为牌价的 50%，官方线路为 90%，两档缓存写入也按同一比例。没有长上下文溢价。Fable 5.2 支持 100 万 token 上下文及最多 12.8 万输出 token。实际费用按上游返回的 token 类别及请求受理时保存的价格计算，缓存未命中不等于自动写入缓存。在共享池上，请求 5 分钟的 Fable 5.2 缓存写入，目前上游都按 1 小时上报，这部分按 1 小时价计费。模型页和用量日志分别列出适用价格和计费数量。

核对思考模式

自适应思考始终开启，不能关闭。默认推理强度为 high，Fable 5.2 支持 low、medium、high、xhigh 和 max。思考 token 计入输出上限，也按输出价格收费，所以 max_tokens 设得很小时，回复可能没有正文。

在 Chat Completions 和 Responses 接口上，TopxAI 收到要求关闭思考的请求时，保持自适应模式并使用默认强度，手动思考预算会转换为 effort 档位。想减少思考，请传更低的 effort。原生 Messages 请求按原样转发，Anthropic 的文档写明 thinking: {"type":"disabled"} 和 budget_tokens 都会返回 400，这两项请去掉，改用 output_config.effort。

读取回复时应按内容块的 type 分别处理。工具对话里的原生 thinking 内容块和签名需原样带回。

核对采样和工具参数

Fable 5.2 不支持 temperature、top_p、top_k，TopxAI 在 Messages、Chat Completions 和 Responses 接口上都会在转发前移除这些设置。强制工具选择（any / 指定 tool，或 OpenAI 的 required / 指定函数）返回 400 且不收费。请使用 auto。

从 Fable 5.1 迁移时可能出错的地方

Anthropic 的迁移指南列出了四项变化，TopxAI 不做改写，原样转发：

改动过的历史。 对话带回思考块、但前面的轮次被改过时，Anthropic 返回 400。Fable 5.1 只对较新的账号执行这项检查，Fable 5.2 对所有账号都执行。前面的轮次要逐字节保持不变，只在末尾追加。
思考块。 Fable 5.1 读不了 Fable 5.2 写的思考块。
计算机工具。 computer_20251124 返回 400，请改用 computer_toolset_20260801。
advisor 工具。 执行模型是 Fable 5.2 时，顾问模型只接受 Fable 5.2 或 Mythos 5.2。

普通自定义工具沿用原来的定义。

模型：claude-fable-5-2 · 模型与价格