要调用 Claude Fable 5.2 API,向 Anthropic 的 Messages 端点发送 POST 请求,带上模型 claude-fable-5-2、你的 API 密钥、max_tokens 和一条用户消息。然后同时读取返回的内容块和 stop_reason。仅凭 HTTP 成功响应,并不能判断回答是否已经完成。
Anthropic 于 2026 年 11 月 9 日发布 Fable 5.2。本指南从凭据开始,带你发出一个小请求,再说明如何读取结果。如果你在维护旧集成,此前的 Fable 5 API 指南提供了背景,但 5.2 请使用下面的当前参数。
AI Coding 交流群
如果你也在用 AI 写代码,或者正在研究 Cursor、Claude Code 这些工具,欢迎加入以下交流群。群里平时会聊一些 AI 编程的实际用法、开发工作流,还有各种新工具和新玩法。
Claude Fable 5.2 API 的模型 ID 与要求
| 设置 | 本教程的取值 |
|---|---|
| 提供商 | Claude API 直连 |
| 模型 ID | claude-fable-5-2 |
| 端点 | POST https://api.anthropic.com/v1/messages |
| API 版本头 | 2026-10-21 |
| 凭据 | Claude Console API 密钥 |
| 思考 | 自适应,始终开启 |
官方模型页面列出 100 万 token 的上下文窗口和 128,000 token 的最大输出。这些是容量上限,不是冒烟测试的合理起始值。先用一个短提示和有界的输出预算。
Fable 5.2 面向高要求推理和长时间 Agent 会话。发送第一条消息并不需要工具、搜索或 Agent 框架。把这些都排除在外,更容易隔离身份验证和响应问题。
除非 Anthropic 明确授权零数据保留,该模型还要求 30 天数据保留。发送私密材料前,先检查你组织的要求。第一次调用时,用一个无害的 API 文档问题。

这些示例使用 Anthropic 的直连端点。云提供商有自己的身份验证和部署细节;不要把 Bedrock 的模型标识符与下面的直连 API 请求混在一起。
获取 Claude API 密钥
- 打开 Claude Console,选择目标组织和工作区。
- 创建 API 密钥,并确认账户有可用的 API 计费或抵扣金。
- 把密钥保存在本地环境或服务器密钥管理器中。
- 从终端或后端运行请求,不要让密钥进入浏览器代码。
Anthropic 的快速开始同时提供 CLI 登录和 API 密钥。本教程使用密钥,这样 HTTP 头保持可见。在 macOS 或 Linux 终端中设置:
export ANTHROPIC_API_KEY="your-api-key-here"
在本地替换占位符。不要把真实密钥粘贴到 issue、共享的请求导出、截图或提交到源码的文件中。该变量只作用于当前 shell 及由它启动的程序;另一个终端不会自动继承。
订阅的聊天用量额度,不能证明你的 API 工作区可以发出该请求。请直接检查 Console 的计费和访问状态。如果凭据已经泄露,先撤销并替换,再继续。

发出第一个 Claude Fable 5.2 请求
把下面的 JSON 保存为 request.json,然后在同一目录运行 curl 命令。该请求要求一段简短解释,使用已验证的模型 ID,并省略可选的生成控制项。响应和响应头分别写入不同文件,这样排查失败时不会混在一起。
{
"model": "claude-fable-5-2",
"max_tokens": 4096,
"messages": [
{
"role": "user",
"content": "Explain HTTP idempotency in three short bullet points."
}
]
}
curl --fail-with-body --silent --show-error \
https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "content-type: application/json" \
--data-binary @request.json \
--dump-header response.headers \
--output response.json
x-api-key 用于身份验证。anthropic-version 选择 API 契约,它不是模型的发布日期。content-type 告诉服务器请求体是 JSON。这里显示的版本遵循 2026 年 11 月 10 日核对的官方快速开始。
max_tokens 限制生成的输出,包括思考。它不保证响应会达到这个长度。由于 Fable 5.2 在回答前会推理,极小的预算可能留不下多少可见文本。如果停止原因是 max_tokens,应把回答视为不完整,并检查预算。
不要从旧代码片段中加入 temperature、top_p 或 top_k。模型文档要求省略它们。在 Fable 5.2 上也无法关闭思考。先让这个小请求跑通,再调整 effort 或添加其他功能。
用下面的命令检查原始结果:
python3 -m json.tool response.json
如果 curl 报告 HTTP 失败,该文件可能包含错误对象而不是 Message。把它交给应用解析器之前,先区分这两种情况。
读取内容块与停止原因
在把生成的文本当作完整回答之前,先读取顶层 stop_reason。然后遍历 content,选择 type 为 text 的块。如果需要继续对话,请单独保留完整响应;提取展示文本和保存对话状态是两件不同的事。
Message 包含模型标识符、内容块、用量信息和停止原因。不要假设 content[0].text 一定存在:思考块或其他类型的块可能出现在文本之前,拒绝响应也可能带有空的 content 数组。
| 停止原因 | 首次请求处理器应做什么 |
|---|---|
end_turn |
读取可用文本;本轮已自然结束 |
max_tokens |
标记结果不完整,并检查输出预算 |
refusal |
处理被拒绝的请求,并检查 stop_details |
| 其他任何值 | 显式处理,再决定是否视为完整回答 |
停止原因文档还覆盖了工具和更长对话中的其他状态。扩展本教程时,它们会变得相关。

分类器拒绝可能以 HTTP 200 返回。Anthropic 的拒绝与降级指南描述了显式降级选项。这里的最小请求没有启用服务端降级,所以不要假设 API 会静默替换成另一个模型。
对于多轮工作,当 API 要求你回传思考块时,按收到的原样保留。过滤后的文本块列表适合展示,但不能替代原始的助手消息。
用 Python 调用 Claude Fable 5.2
在虚拟环境中安装官方 SDK,然后创建一个读取 ANTHROPIC_API_KEY 的客户端。使用与 curl 请求相同的模型、提示和 token 预算。保持这些输入不变,可以让你比较 HTTP 示例和 SDK,而不会引入第二个调试问题。
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade anthropic
把下面的代码保存为 first_request.py:
import anthropic
client = anthropic.Anthropic(
default_headers={"anthropic-version": "2026-10-21"}
)
try:
message = client.messages.create(
model="claude-fable-5-2",
max_tokens=4096,
messages=[{
"role": "user",
"content": "Explain HTTP idempotency in three short bullet points.",
}],
)
except anthropic.APIStatusError as error:
print("HTTP status:", error.status_code)
print("Request ID:", error.request_id)
raise
else:
print("Stop reason:", message.stop_reason)
print("Usage:", message.usage)
if message.stop_reason != "end_turn":
raise RuntimeError("Handle this unfinished or declined turn separately")
for block in message.content:
if block.type == "text":
print(block.text)
在包含密钥的 shell 中运行 python first_request.py。显式的停止检查可以防止被截断或被拒绝的回答流入期望完整答案的代码。把它集成到服务时,再添加单独的连接错误处理。
[待核实] 这些示例已对照当前官方文档,并在本地验证了语法。实际的 Fable 5.2 推理调用仍需要授权的 API 密钥;本文没有声称真实输出。
排查常见的 Claude Fable 5.2 API 错误
| 状态码 | 首先检查 |
|---|---|
| 400 | JSON 结构、不支持的参数和已配置的支出上限 |
| 401 | API 密钥缺失、过期、被撤销或格式错误 |
| 402 | 计费或付款信息 |
| 403 | 组织和空间权限 |
| 404 | 端点路径和资源标识符 |
| 429 | 速率限制或支出上限 |
| 500、504、529 | 服务器故障、超时或临时过载 |
结合返回的错误类型和消息以及状态码进行排查,遵循 Anthropic 的错误指南。保存 request-id 响应头以便联系支持。记录状态码和请求 ID,但不要记录凭据。
遇到 400 时,回到上面的最小请求体。移除可选参数,比调试一个携带多代模型设置的示例更容易。强制工具选择在 Fable 5.2 上也会产生 400,所以之后添加工具时不要带上它。
SDK 默认会对某些瞬时故障重试两次。避免把它包在无限重试循环里。没有 retry-after 的 429 如果是支出上限导致的,快速重试不会解决问题。对于长响应,改用流式传输,不要假设空闲连接会无限保持。
理解首次请求的成本
Fable 5.2 的标准价格为每百万输入 token $8、每百万输出 token $40,核对于 2026 年 11 月 10 日的官方模型页面。一个假设的未缓存请求使用 1,000 个输入 token 和 500 个输出 token,成本为 $0.028:$0.008 加 $0.020。
这是示例算术,不是本教程的实测账单。实际支出请使用响应中的用量数据和账户计费报告。缓存、批处理、fast 模式和降级都会改变计算。在尝试长上下文工作负载之前,先让第一个请求保持很小。
跑通之后,保存请求契约和预期完成状态,用于回归测试。如果下一步要交给 Agent,请把完整的 Fable 测试工作流与这个首次调用教程分开。
常见问题
Claude Fable 5.2 API 的模型名是什么?
在 Claude API 直连中使用 claude-fable-5-2。使用其他平台时,请从官方模型页面复制对应提供商的标识符。
可以关闭思考以获得更短的回答吗?
不可以。自适应思考始终开启。通过文档中的 effort 设置控制深度,并要求简洁的可见输出。
为什么 HTTP 200 却没有回答?
检查 stop_reason 和内容块。分类器拒绝是正常的 HTTP 200 响应,可能不包含任何文本。
可以原样复用我的 Fable 5 请求吗?
检查模型 ID、API 版本和生成控制项。此前的 Fable 5 教程提供了背景,但 Fable 5.2 有不同的参数限制。
API 密钥应该放在哪里?
放在服务器环境变量或密钥管理器中。构建浏览器应用时,通过后端发送请求。