Claude Fable 5.2 API Key 怎么获取：不用单独申请，调用与报错对照

调用 Claude Fable 5.2 不需要单独的 API Key，也不用像 Claude Mythos 5.2 那样先通过 Anthropic 的验证计划。在 Claude Console 的 API 密钥页（platform.claude.com/settings/keys）创建一个以 sk-ant- 开头的 Key，它能调用你的组织可用的所有模型；请求体里把 model 写成 claude-fable-5-2，调用的就是 2026 年 11 月 9 日发布的 Fable 5.2。

Key 只是能否调用的条件之一，其余几项都落在 Key 背后的组织上：组织里要有 API 额度（Claude 订阅不直接抵 API 费用，只有 Max、Ultra、Team 每月附带一笔 API 额度），你所在的地区要在 Anthropic 的支持列表里，组织没有处在零数据保留（ZDR）安排下。请求返回 HTTP 200，而且响应里的 model 字段是 claude-fable-5-2，才算接通；返回 401、404、400 或 429 时，报错类型和原文能对应到缺的是哪一项。

截至 2026 年 11 月 12 日，Anthropic 的支持地区列表里没有中国大陆和香港，官方 API 不面向这两地提供。在这两地能走的是另外两类入口：公司已有海外主体的云账号（Amazon Bedrock、Google Cloud、Microsoft Foundry）上的 Fable 5.2，或者中转平台各自发放的 Key。后者和 Anthropic 不是同一份合同，Key、余额和限额都归那个平台管。

在 Claude Console 创建 API Key：四步，完整 Key 只显示一次

API Key 在 Claude Console 里创建，按 Anthropic 的获取 API 密钥文档，从登录到拿到 Key 是四步。一个 Key 能调用组织可用的全部模型，并没有"Fable 专用 Key"，以前建好的 Key 也能直接调 Fable 5.2，模型只由请求里的 model 字段决定。

1. 打开 Claude Console 登录，没有账号就先注册。
2. 进入 API 密钥页 platform.claude.com/settings/keys。
3. 点 Create key，给 Key 起名，选过期时间，把 Linked account 设为你自己或一个服务账号；需要时再选一个工作区（workspace），把 Key 限定在里面。
4. 立刻复制完整的 Key（以 sk-ant- 开头），存进密码管理器或密钥管理服务。Console 只在创建时显示这一次，丢了不能再查看，只能新建。

建 Key 时有两个选择会影响之后的调用。一是类型：个人 Key 以你的身份调用，你离开组织后自动失效，适合自己开发；服务账号 Key 给 CI、线上服务和智能体用；旧式的工作区 Key 没有所有者，官方建议优先用前两种。二是工作区：按 Anthropic 的身份验证文档，没有限定工作区的 Key 每次请求都要额外带 anthropic-workspace-id 请求头，所以只想先跑通第一条请求的话，创建时选定一个工作区更省事。

如果 Create key 按钮是灰的，说明你在组织里的角色不允许建 Key，要请组织管理员调整角色，或者代建一个服务账号 Key。本地开发也可以不建 Key：官方快速入门给的另一种方式是用 brew install anthropics/tap/ant 装好 ant 命令行，再运行 ant auth login 登录。SDK、ant 和 Claude Code 读取的都是环境变量 ANTHROPIC_API_KEY，所以下文仍以 API Key 为准。

调用 Fable 5.2 前，Key 之外还要满足的四个条件

Key 建好之后能不能调通 Fable 5.2，还取决于组织的四项状态：API 额度、所在地区、数据保留和用量层级。速率限制和支出上限都按组织计算，不按 Key 计算，换一个新 Key 解决不了这几类问题。下表是每一项在哪里确认，以及新建组织通常处在什么状态，均截至 2026 年 11 月 12 日。

额度用完后调用会停下，直到再次充值，也可以开自动充值在余额低于阈值时补上。失败的请求不扣费，但一个本来会成功的请求如果因为客户端断开或超时被切断，仍然计费。充值步骤和免费额度的细节见Claude API Key 怎么购买：官方充值、价格与免费额度，共享密钥避坑。

过了 Evaluation 之后，Fable 5.2 在标准层级里有自己独立的限额，不和 Fable 5.1、Fable 5 共用同一份。按 Anthropic 的速率限制文档，三个标准层级的 Fable 5.2 限额和每月支出上限如下：

缓存读取不计入每分钟输入 token。想提高限额，在 Console 的 Rate limits 页点 Request tier increase；累计充值多少才会升到下一层，这份文档没有写。旧文章里的 Tier 1 到 Tier 4 是以前的叫法，现在的层级名是 Evaluation、Start、Build、Scale，另有 Custom。

发第一条请求：model 填 claude-fable-5-2，返回里核对 model 字段

第一条请求用 cURL 发最直接：三个请求头加一个最小的请求体。下面的请求头沿用 Anthropic 快速入门的 cURL 写法，model 填 Fable 5.2 的 ID，提示词是一个答案可核对的小问题：

export ANTHROPIC_API_KEY="sk-ant-..."   # 换成你自己的 Key

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-fable-5-2",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Reply with exactly: ready. Then on a new line give 17 * 23."}
    ]
  }'

Key 没有限定工作区时，再加一行 -H "anthropic-workspace-id: <工作区 ID>"，ID 在 Console 的 Workspaces 页 ID 一列。获取 API 密钥文档里还写了另一种认证头 Authorization: Bearer <key>，两种写法都在现行文档中。旧教程常写 anthropic-version: 2023-06-01；2026 年 11 月 12 日用一个伪造的 Key 分别带这两个版本号请求 api.anthropic.com，返回的是同一个 401，这只说明 Key 最先被检查，不能证明旧版本号在有效 Key 下表现一样，照快速入门写 2026-10-21 最稳妥。

接通的标志有三个：HTTP 状态码是 200；响应里的 model 是 claude-fable-5-2；content 里有 text 块，usage 给出了输入和输出 token 数。官方端点这一步要用你自己的有效 Key；2026 年 11 月 12 日能拿到成功响应的那次调用，走的是 laozhang.ai 的 Anthropic 兼容接口（https://api.laozhang.ai/v1/messages），描述的是这个平台当天的返回。同一个请求体（max_tokens 为 2048）返回 HTTP 200，耗时 5.53 秒，model 为 claude-fable-5-2，content 先是一个 thinking 块，再是内容为 "ready" 和 "391" 两行的 text 块，usage 为输入 33、输出 16 个 token。出现 thinking 块是因为 Fable 5.2 的自适应思考始终开启；这次块里的思考文字是空的，只带一段签名，读取答案时取 text 块即可。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

按 Anthropic 的 Fable 5.2 模型页标价，输入每百万 token $8，输出每百万 token $40，这次调用的费用是 33 × 8 ÷ 1,000,000 + 16 × 40 ÷ 1,000,000 = 0.000904 美元，不到 0.001 美元。中转平台响应里的 model 是平台自己报告的，所以接任何第三方入口时，除了看 model，还可以拿 usage 乘以标价，和平台的扣费记录对一下。Fable 5.2 和 Opus 5.5 之间怎么选、同题实测花多少，见Fable 5.2 和 Opus 5.5 怎么选：哪档对哪档，同题实测贵 1.86 倍。

API 的默认 effort 是 high，简单任务可以调低。同一天在同一个平台上加了下面两个字段、effort 设为 low 后，响应里只剩 text 块，输出从 16 个 token 降到 6 个；设为 high 时和默认一样是 16 个。可选的档位有 low、medium、high、xhigh、max，各档在真实任务里花费差多少，见Claude Fable 5.2 和 5.1 区别：单价降 20%，high 以上每任务更贵。

"thinking": {"type": "adaptive"},
"output_config": {"effort": "low"}

从别的模型迁过来的代码，要先删掉几个参数。Anthropic 的 Fable 5.2 新特性文档写明，在 Claude API 上 thinking 设成 {"type": "disabled"} 或带 budget_tokens 的 enabled 都返回 400，应当不传或写 adaptive；temperature、top_p、top_k 要删掉，非默认值返回 400；tool_choice 为 {"type": "any"} 或指定某个工具也返回 400。中转平台不一定照此拦截：11 月 12 日在 laozhang.ai 上，thinking: disabled 和 temperature: 0.2 都返回了 200，而且 disabled 的回复里仍有 thinking 块，只有强制工具调用返回 400。也就是说，经中转能跑通的代码，换到 api.anthropic.com 仍可能报 400，而 disabled 在中转上也并没有关掉思考。

Fable 5.2 API 报错对照：401、404、400、429 分别缺哪一项

官方端点先验 Key，再看模型名和请求体。2026 年 11 月 12 日直接请求 api.anthropic.com、模型填 claude-fable-5-2：不带 Key 头返回 401，消息是 x-api-key header is required；带伪造 Key 请求 /v1/messages 和 /v1/models，都返回 401 invalid x-api-key，每次都在 1 秒内回来。所以看到 401 时先查 Key 和请求头，不用去改模型名。下表中标"实测"的两行是这次拿到的原文，其余来自 Anthropic 的API 错误文档、速率限制文档、数据保留文档和 Fable 5.2 新特性文档。

额度用完具体返回哪个状态码，Anthropic 的帮助文档没有写，只说调用会停止直到充值；如果你在额度耗尽时看到 402，先去 Billing 页看余额。

换了入口，同样的错误会换一种返回。11 月 12 日在 laozhang.ai 上把模型写成 claude-fable-5.2、fable-5-2、Bedrock 的 global.anthropic.claude-fable-5-2 或 claude-fable-5-2-latest，得到的都不是 404，而是 HTTP 503 api_error，消息是 "Current group default has no available channels for model …"；伪造的平台 Key 返回 401 authentication_error，消息 "Invalid token."。这些请求都没有扣费。用中转平台时，按平台文档解读报错，不要拿 Anthropic 的错误表直接套。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

国内能直接用 Fable 5.2 官方 API 吗：支持地区不含中国大陆和香港

不能。截至 2026 年 11 月 12 日，Anthropic 的 API 支持地区列表共 175 个国家和地区，台湾、日本、韩国、新加坡都在列，中国大陆和香港不在。这份列表写的是 Anthropic 可以支持从哪些地区访问，没有写列表之外的地区会收到什么报错；2026 年 11 月 12 日对官方端点的几次请求是从定位在台湾的网络发出的，不支持地区的返回没有测到。

在中国大陆和香港，可行的入口有两类。一是公司已有海外主体，并在 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 开了账号，那么在云平台里调用 Fable 5.2，账单、限额和凭证都属于那个云账号，不用 sk-ant- Key。二是中转平台：注册后用平台发的 Key 调用。中转解决的是模型调用入口，不能帮你注册或恢复 Claude 官网账号；Key、余额、限额、能用哪些参数，都按平台自己的规则。各入口的模型 ID 写法见下一节。

Bedrock、Google Cloud、Foundry 和中转平台的 Fable 5.2 模型 ID

除了 Amazon Bedrock 要加前缀，其他云平台上的 Fable 5.2 都沿用 claude-fable-5-2。下表按 Anthropic 的 Fable 5.2 新特性文档和 Amazon Bedrock 上的 Claude 文档整理，截至 2026 年 11 月 12 日：

laozhang.ai 从 2026 年 11 月 10 日起提供 claude-fable-5-2，单价与 Anthropic 标价相同，按量计费。按它的文档，Anthropic Messages 格式走 https://api.laozhang.ai/v1/messages，要用 Claude Code 分组的令牌；OpenAI 兼容格式走 /v1/chat/completions，用 default 分组令牌。11 月 12 日的测试里，/v1/models 列出 207 个模型，其中 11 个 Claude 模型，包括 claude-fable-5-2；一个 default 分组令牌在两种格式下都返回了 200，chat/completions 一次耗时 3.27 秒，同样是输入 33、输出 16 个 token。平台文档列出的与官方 API 的差异是：单次输出上限 32,768 token（官方为 128K）；不支持 web_search、web_fetch、code_execution 这类服务器工具；没有 count_tokens、Message Batches 和 Files 端点；命中停止序列时 stop_reason 返回 end_turn。它的文档里也没有提到 fast mode。需要 Batch 半价或超长单次输出的任务，仍然要走官方或云平台。

说明：laozhang.ai 是我们自己的服务，其价格是平台报价，不是独立比较的结论。

Fable 5.2 API 能免费用吗：Pro 订阅不抵 API 费用，Max 每月带额度

官方 API 没有长期免费档。Anthropic 定价页只写了新用户会拿到一笔免费额度用来测试 API，金额没有公布，够不够调用 Fable 5.2、Evaluation 层级的组织能不能用它调 Fable 5.2，文档也都没写。网上宣传的"免费 Fable 5.2 Key"，送的多是第三方平台自己的赠送额度，不是 Anthropic 的 API 额度。

Claude 的付费订阅（Pro、Max、Ultra）不支付 API 调用，API 单独按标准费率计费。例外是 Max、Ultra 和 Team 每月附带的 API 额度：按 Anthropic 的月度 API 额度帮助文档，Max 每月 $100，Ultra 每月 $200，Team 每个 Standard 席位 $20、Premium 席位 $100，团队合计每月最多 $500；Free、Pro 和 Enterprise 没有。订阅满 7 天后，在 claude.ai 的 Settings > Billing > API credits 里点 Link organization 关联一个 Console 组织即可领取，不需要绑定付款方式。这笔额度可以用于 Claude API 上任何可用模型，包括 Fable 5.2，会先于你购买的额度扣除，当期没用完就作废；它不抵交互式 Claude Code 和应用里的额外用量。

应用里用 Fable 5.2 是另一回事。所有付费订阅都能在模型选择器里选 Fable，Pro 用户在首发优惠期内（到 2026 年 11 月 16 日太平洋时间 23:59 为止）包含一周的 Fable 使用，之后按用量额度付费；这些都不产生 API Key，也不变成 API 额度。应用内额度怎么算见Claude Fable 5.1 使用限制：Pro 怎么收费，Max 额度何时恢复。

在 Claude Code 里用 Fable 5.2 的 API Key：版本要 2.1.321 以上

设置了 ANTHROPIC_API_KEY 后，Claude Code 按 API 费率向这个 Key 所在的 Console 组织计费。Fable 5.2 要求 Claude Code 2.1.321 或更高版本，用 /model fable 或 claude --model claude-fable-5-2 选择。版本不够时问题不容易看出来：2026 年 11 月 10 日用本地模拟端点记录 Claude Code 实际发出的请求，2.1.316 把 fable 解析成 claude-fable-5-1；手动指定 claude-fable-5-2 能发出去，但会提示 "Claude Code doesn't recognize the model"，按 200k 上下文处理，max_tokens 只给 32000。换成 2.1.321 后，两种写法都发成 claude-fable-5-2，effort 为 medium，max_tokens 为 128000。

到 11 月 12 日，那台测试机上 claude --version 显示的仍是 2.1.316，可见已装的 Claude Code 不一定自己升到 2.1.321，选模型之前先看一眼版本号。模拟端点只记录客户端发了什么，不代表 Anthropic 的实际返回。Claude Code 该用 API Key 还是订阅计费、怎么确认当前走的是哪一种，见Claude Code API Key 和订阅计费怎么选：先看 /status；默认的 medium 怎么改，见Claude Code effort level 设置：各模型实测默认档与不生效排查。走中转平台时，按平台文档设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。

Claude Fable 5.2 API 的其他问题

Fable 5.2 的 API 会不会很快下线？

不会很快。截至 2026 年 11 月 12 日，Anthropic 的 Fable 5.2 模型页把它标为当前最新、在售的模型，退役时间不早于 2027 年 11 月 9 日。

Fable 5.2 能用 Batch API 和 fast mode 吗？

能。按 Anthropic 的 Fable 5.2 模型页，Batch API 打五折，输入和输出单价都是标价的一半；fast mode 另有更高的单价，在 Microsoft Foundry 上用单独的 ID claude-fable-5-2-fast。Batch 怎么和提示缓存叠加、什么时候更省，见Claude Batch API 价格与用法：五折怎么算，缓存何时叠加更省。

Fable 5.2 的上下文和单次输出有多长？

按 Anthropic 的 Fable 5.2 模型页，上下文窗口为 100 万 token，单次最多输出 128K token，输入支持文字和图片，输出只有文字。中转平台可能另设更低的输出上限，以平台文档为准。