Claude Fable 5.1 是 Anthropic 于 2026-09-01 发布、面向「高难度推理与长程智能体」的公开旗舰模型(模型族中首个高于 Opus 的 Mythos 级,基础模型与需受信任访问的 Mythos 5.1 相同)。它以 1M 上下文、常驻自适应思考、更便宜的缓存读取和更强的长程编码/多步研究能力见长。本教程覆盖规格认知、环境准备、官方 SDK 调用、OpenAI 兼容接入、工具/多模态/流式、从 Fable 5 迁移与成本优化,可直接照抄接入。 一、核心规格认知
| |
|---|
| |
| |
| |
| |
| |
| |
| 自适应思考(Adaptive),始终开启、不可关闭;默认 effort 为 high |
| Slower(慢于 Opus 5 的 Moderate、Sonnet 5 的 Fast) |
| 工具调用、JSON / 结构化输出、提示缓存、批处理、流式、视觉 |
| Claude API、Claude Code、Claude.ai、AWS Bedrock、Google Cloud、Microsoft Foundry |
| |
定位建议:大多数负载先用 Claude Opus 5($5/$25 per 1M);只有当 Opus 5 高 effort 仍不达预期,或需要长程无人值守智能体、复杂重构、多步研究、金融/文档分析时,才升级到 Fable 5.1。
二、准备接入环境
1. 获取 API Key
在 Anthropic Console 创建账户并生成 API Key,导出为环境变量(避免写入代码或 shell 历史):
2. 安装官方 SDK
3. 各渠道模型 ID 对照(务必用对)
| |
|---|
| |
| anthropic.claude-fable-5-1
|
Google Cloud / Microsoft Foundry / Claude Platform on AWS | |
OpenAI 兼容网关(如 AIgateway、Haimaker 等) | anthropic/claude-fable-5.1
|
提示:你已有的 claude-fable-5、claude-opus-5、claude-sonnet-5 调用用的同一把 Anthropic Key 通常可直接复用。
三、官方 Anthropic SDK 调用(最稳路径)
最简请求:读 ANTHROPIC_API_KEY 环境变量,调用 Messages API。
多轮对话:把历史放进 messages 数组即可(注意 Fable 5.1 编辑早期轮次会使思考块失效,见第六节)。
等价 cURL(Raw Messages API):
可用 Models API 核对上限:curl -s "https://api.anthropic.com/v1/models/claude-fable-5-1" -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01",返回会确认 1M 输入、128K 输出,且 thinking 仅 adaptive 可用、enabled 已不支持。
四、OpenAI 兼容网关接入(迁移更省事)
若你已有 OpenAI 格式的调用代码,可直接切换 base_url 与 model,无需改 SDK。
支持工具调用、流式、视觉(image_url)与 JSON 模式,与普通 OpenAI 调用一致。注意:网关可能不支持 Anthropic 原生缓存/TTL 等细节,首次重复调用后请确认 usage.cache_read_input_tokens 非零再“记账”。部分网关会把 OpenAI 格式tool_choice="required"映射为 Anthropic 不支持的any,迁移 Fable5.1 时会直接触发 400 报错,需要单独适配工具选择逻辑。
五、进阶:工具调用 / 多模态 / 流式
1. 工具调用(Tool Use,官方原生)
返回的 message.stop_reason == "tool_use" 时,从 content 中解析 tool_use 块、执行函数、把结果作为 user 角色的 tool_result 回传继续对话。
2. 视觉(图像输入)
Messages 的 content 用数组,图像以 base64 或 URL 提供:
3. 流式输出
六、从 Fable 5 迁移与必坑清单
迁移极简:基础费率、上下文、输出上限、默认 effort 均未变,把 claude-fable-5 换成 claude-fable-5-1 即可。但有两处需重新核对:① 输出预算——Artificial Analysis 测到 max effort 下输出 token 约为 1.7 倍,原告警阈值会误触发(该 1.7 倍输出 token 增长是第三方评测观测值,不同任务类型差异很大,不能当作固定系数);② 知识截止变为 2026 年 6 月,绕过旧库知识的补丁可能已冗余或失效。
5 条破坏性变更(会让旧代码报错或行为异常):
- 强制工具调用(
tool_choice 指定单一 tool_use)会返回错误;
- 更早一代模型无法读取 Fable 5.1 的思考块;
- 编辑对话早期轮次会使 Fable 5.1 的思考块失效;
- 旧
thinking.type: "enabled" 已不存在,仅剩 adaptive,硬写 enabled 的代码会失败;
- 自发布日起新建的 API 账户,多轮中不能再在保留思考记录的前提下编辑模型历史上下文(反蒸馏措施,后续版本通用)。
两项访问限制:Fable 5.1要求 30 天数据保留,未获 Anthropic 授权不得使用零数据保留;且无 Priority Tier(Fable 5 有,迁移即丢失)。
七、成本与缓存优化
| | |
|---|
| | |
| | |
| | 比 Fable 5 的 $1.00 降 75%(0.025× 输入价) |
| | |
| | |
| | |
Anthropic 估算典型负载整体约省 25%、高智能体负载最多约省 45%(基于 August 真实流量、默认 effort)。但前提是缓存真的命中:若你的智能体以 high effort 反复生成大量新输出 token,可能把缓存省下的钱又吃回去。建议在自有流量上先测缓存命中率再“记账”。
思考强度:默认 effort 为 high,可通过 beta 的 per-message effort 在对话中途调整且不使提示缓存前缀失效;需长程任务时提高 effort,简单路由可下调以省输出 token。
常见问题
Q: Claude Fable 5.1 和 Claude Mythos 5.1 有什么区别?
A: 两者底层模型相同。Fable 5.1 公开可用(GA);Mythos 5.1 仅通过受信任访问计划 Project Glasswing 提供给经审核的网络防御者与生命科学家,规格与定价一致。
Q: 能关掉思考/降低推理来省钱吗?
A: Fable 5.1 仅支持自适应思考且始终开启、不可关闭。你只能调整 effort 档位(默认 high),不能像部分模型那样设为 none;想省成本更现实的做法是换 Opus 5 或 Sonnet 5,或调低 effort、提高缓存命中。
Q: 从 Fable 5 升级要改很多代码吗?
A: 不需要。基础费率与结构不变,改 model 字符串即可。但要排查上述 5 条破坏性变更(尤其 tool_choice 强制调用与 thinking.enabled 写法),并注意数据保留与优先级档位变化。
Q: 两个模型价格一致,为什么不直接用 Fable 5.1?
A: Fable 5.1 延迟更慢、输出更“重”(高 effort 下输出 token 约 1.7 倍),日常编码/知识工作用 Opus 5($5/$25)性价比更高。Fable 5.1 适合“Opus 5 高 effort 仍做不好的长程/高难任务”。
Q: 第三方网关接入安全吗?
A: 网关多为按官方定价透传(无加价),但缓存、TTL、数据驻留等原生能力支持不一。生产环境建议优先官方 Claude API / Bedrock / Vertex AI;用网关时验证缓存命中与计费口径。
以上信息综合自 Anthropic 官方文档(docs.claude.com / console.anthropic.com / platform.claude.com 模型概览与迁移指南)、dev.to、ComputingForGeeks、DataCamp、llmreference 及各 OpenAI 兼容网关页面,于 2026-09 初核对。模型 ID、定价、缓存费率、可用平台、思考/数据驻留限制等可能随时更新;文中基准(如 GPQA 93.7%、Terminal-Bench 55.8%)来自第三方评测,随 harness 差异较大,仅供取舍参考,生产决策以自有负载实测为准。