Claude Fable 5.1 API | BeatAPI API Documentation

Claude Fable 5.1 是 BeatAPI 当前公开提供的唯一 Claude 模型。它沿用文本 API 的统一透传通道，所有支持的 SDK 格式都使用模型 ID claude-fable-5-1。

模型	适合场景	上下文
`claude-fable-5-1`	长文写作，以及对文风与结构要求最高的场景	1,000,000 tokens

当前公开的 Claude 路由只提供 claude-fable-5-1。上线前可调用 GET /v1/models，确认你的账户已启用哪些模型。

推荐：Anthropic Messages

新接 Claude 建议直接用原生 Messages 格式 —— 只有它能不经转换地承载 Claude 自己的工具调用与提示缓存字段。

POST https://api.beatapi.io/v1/messages

1 import Anthropic from "@anthropic-ai/sdk";
2 
3 const client = new Anthropic({
4   apiKey: process.env.BEATAPI_API_KEY,
5   baseURL: "https://api.beatapi.io"
6 });
7 
8 const message = await client.messages.create({
9   model: "claude-fable-5-1",
10   max_tokens: 1024,
11   messages: [
12     { role: "user", content: "为支付 API 设计一套稳健的 Webhook 重试策略。" }
13   ]
14 });
15 
16 console.log(message.content);

BeatAPI 密钥可以用 x-api-key，也可以用 Authorization: Bearer，两种都接受。已有的 Anthropic 客户端只需要改 base URL。

$ curl --request POST \
>   --url https://api.beatapi.io/v1/messages \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "claude-fable-5-1",
>   "max_tokens": 1024,
>   "messages": [
>     {
>       "role": "user",
>       "content": "Design a resilient webhook retry strategy for a payments API."
>     }
>   ]
> }'

提示缓存

Claude 对缓存读取、5 分钟缓存写入、1 小时缓存写入分别定价，BeatAPI 也分别计量 —— 命中缓存的前缀按缓存读取计费，而不是按全价输入。cache_control 的用法与直连 Anthropic 完全一致。

claude-fable-5-1 的缓存命中按基础输入价的 0.025 倍计费；缓存写入与读取分别计量。

其他 SDK 格式

同一个 claude-fable-5-1 模型也支持另外三种请求格式。已有集成只需改 base URL、把供应商密钥换成 BeatAPI 密钥即可迁移。

OpenAI Chat Completions

POST https://api.beatapi.io/v1/chat/completions

$ curl --request POST \
>   --url https://api.beatapi.io/v1/chat/completions \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "claude-fable-5-1",
>   "messages": [
>     {
>       "role": "user",
>       "content": "Design a resilient webhook retry strategy for a payments API."
>     }
>   ]
> }'

OpenAI Responses

POST https://api.beatapi.io/v1/responses

$ curl --request POST \
>   --url https://api.beatapi.io/v1/responses \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "model": "claude-fable-5-1",
>   "input": "Design a resilient webhook retry strategy for a payments API.",
>   "reasoning": {
>     "effort": "medium"
>   }
> }'

Gemini 兼容格式

POST https://api.beatapi.io/v1beta/models/{model}:generateContent

BeatAPI 密钥可通过 x-goog-api-key、Bearer 认证，或 Gemini SDK 兼容的 key 查询参数传入。直接发 HTTP 请求时建议用请求头。

$ curl --request POST \
>   --url 'https://api.beatapi.io/v1beta/models/claude-fable-5-1:generateContent' \
>   --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>   --header 'Content-Type: application/json' \
>   --data '{
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Design a resilient webhook retry strategy for a payments API."
>         }
>       ]
>     }
>   ]
> }'

流式响应

按所选格式设置对应的流式字段。BeatAPI 原样转发 SSE 流、不做格式转换，因此事件名与响应对象与该 SDK 格式保持兼容。

认证与可用性

上线前先列出当前已启用的文本模型：

$ curl https://api.beatapi.io/v1/models \
>   -H "Authorization: Bearer $BEATAPI_API_KEY"

1 {
2   "object": "list",
3   "data": [
4     { "id": "claude-fable-5-1", "object": "model", "owned_by": "beatapi" }
5   ]
6 }

同一把 API 密钥和同一份美元余额在文本、图片、视频、工作流、特效与实时 API 之间共用。按真实 token 用量计费；请求 ID、模型、token 总量、状态与结算金额都可在控制台用量日志中查看。

上线检查清单

API 密钥只放在可信服务端，并从日志中脱敏。
设置明确的请求超时，并安全地重连流式响应。
记录响应中的请求 ID，便于支持与账单核对。
在有代表性的生产输入上完成评测，再决定是否上线。
把 401、402、429、502、503 当作各自不同的运维场景分别处理。

继续接入媒体模型

同一个 BeatAPI 账户可以直接调用 GPT-5.6、GPT Image 2、Wan 3.0 以及其余图片和视频 API，不需要再引入一套计费或认证体系。