使用 FableAI API 构建

一个 API 密钥即可用于 Claude Code、Cline、9Router、Cursor、Anthropic SDK 和 OpenAI SDK。复制下方的 Base URL,粘贴你的密钥,然后选择模型。

Base URL · Anthropic 格式
Base URL · OpenAI 格式
API 密钥
sk-ant-fai-…创建密钥
01 /

6 步快速开始

从注册到发出第一个请求,大约只需两分钟。

  1. 1
    第 1 步 / 共 6 步

    创建账户

    打开注册页面,填写姓名、邮箱和密码,勾选条款,然后点击 Create account。

    注册表单
  2. 2
    第 2 步 / 共 6 步

    验证邮箱

    我们会向你的邮箱发送一个 6 位验证码。输入验证码后点击 Verify email。如果一分钟内没有收到,请检查垃圾邮件文件夹。

    六位邮箱验证码
  3. 3
    第 3 步 / 共 6 步

    兑换优惠码

    打开余额页面,粘贴你的优惠码,点击 Add to balance。余额会立即到账。你可以随时在同一个账户中兑换更多优惠码,所有金额都会累加到同一个余额中。

    余额页面与优惠码
  4. 4
    第 4 步 / 共 6 步

    创建 API 密钥

    打开 API Keys 页面,点击 Create key,为密钥命名。Spend limit(消费上限)可选:留空表示不限制;设置上限后,密钥达到上限会自动暂停。Expires(过期时间)也是可选的。Speed(速度):每分钟 60 次请求已包含在内,更高的速度每个 token 价格会略高一些。

    创建 API 密钥窗口
  5. 5
    第 5 步 / 共 6 步

    复制并保存密钥

    密钥只显示一次。点击 Copy 复制并妥善保存,然后点击 I've saved it。为了你的安全,我们只保存密钥的指纹,因此无法再次显示。如果丢失,请删除后重新创建一个。

    新密钥只显示一次
  6. 6
    第 6 步 / 共 6 步

    连接你的工具

    将 Base URL 和密钥粘贴到 Claude Code、Cline、9Router、Cursor 或任意 SDK 中。请先查看应使用哪个 Base URL,再查看 Claude Code 和其他工具的设置方法。

发送第一个请求试试:

# ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"

claude   # that's it
02 /

我应该使用哪个 Base URL?

只有一个服务器,但有两种调用方式。每个工具都会使用其中一种,唯一的区别是末尾是否加 /v1。

Anthropic 格式
将此粘贴为 Base URL
工具会自动调用 https://api.fableaiapi.com/v1/messages。
Claude Code、Anthropic SDK、Cline 和 Roo Code(Anthropic 提供商)、9Router(Anthropic Compatible)
OpenAI 格式
将此粘贴为 Base URL
工具会自动调用 https://api.fableaiapi.com/v1/chat/completions。
Cursor、OpenAI SDK、Cline 和 Roo Code(OpenAI Compatible)、9Router(OpenAI Compatible)
简单规则:如果工具要求填写 Anthropic URL,不要加 /v1;如果要求填写 OpenAI URL,请加上 /v1。不要把 /messages 或 /chat/completions 填进 Base URL,工具会自动加上这部分。

各工具一览

Claude CodeANTHROPIC_BASE_URLANTHROPIChttps://api.fableaiapi.com
Anthropic SDK (Python, Node)base_url / baseURLANTHROPIChttps://api.fableaiapi.com
Cline, Roo Code提供商:Anthropic,自定义 Base URLANTHROPIChttps://api.fableaiapi.com
9RouterAdd Anthropic CompatibleANTHROPIChttps://api.fableaiapi.com
Cline, Roo Code提供商:OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
9RouterAdd OpenAI CompatibleOPENAIhttps://api.fableaiapi.com/v1
CursorOverride OpenAI Base URLOPENAIhttps://api.fableaiapi.com/v1
OpenAI SDK, LiteLLM, LangChainbase_url (OpenAI)OPENAIhttps://api.fableaiapi.com/v1

自己用 curl 或 fetch 调用 API?请使用完整地址:https://api.fableaiapi.com/v1/messages 或 https://api.fableaiapi.com/v1/chat/completions。

有些错误会自动修正:重复的 /v1/v1,以及 /chat/completions 前缺少 /v1,都可以正常使用。Base URL 末尾不要加斜杠。

03 /

Claude Code

把 Base URL 和密钥写入 Claude Code 的设置文件,然后运行 claude。适用于 macOS、Windows、Linux,以及 VS Code 和 JetBrains 插件。

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.fableaiapi.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-ant-fai-your-key"
  }
}

在 Windows 上,该文件位于 C:\Users\你的用户名\.claude\settings.json。你也可以只为当前终端会话设置这两个值:

macOS / Linux
export ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
export ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.fableaiapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-ant-fai-your-key"
claude
在 Claude Code 中用 /model 选择模型,或使用 claude --model claude-sonnet-5-5 启动。运行 /status,确认 Base URL 显示为 https://api.fableaiapi.com。
04 /

Cline、9Router、Cursor

所有工具使用同一个密钥。如果工具提供 Anthropic 选项,请优先选择它。

Cline / Roo Code (VS Code)

方案 A · Anthropic(推荐)
API 提供商
Anthropic
自定义 Base URL
https://api.fableaiapi.com
API 密钥
sk-ant-fai-…
模型
claude-sonnet-5-5
方案 B · OpenAI Compatible
API 提供商
OpenAI Compatible
Base URL
https://api.fableaiapi.com/v1
API 密钥
sk-ant-fai-…
模型 ID
claude-sonnet-5-5

9Router

  1. 打开 Providers,选择 Add Anthropic Compatible 并填写 Base URL https://api.fableaiapi.com,或选择 Add OpenAI Compatible 并填写 https://api.fableaiapi.com/v1。
  2. 点击 Add API Key,粘贴密钥,等待显示 Valid 后保存。
  3. 点击 Import Models,你的密钥可用的所有模型都会出现。

Cursor

  1. 打开 Settings → Models → API Keys。
  2. 将密钥粘贴到 OpenAI API Key,并开启 Override OpenAI Base URL,填写 https://api.fableaiapi.com/v1。
  3. 从模型列表中选择一个 ID 添加为自定义模型,然后在聊天中选择它。

OpenAI SDK

Python · openai
from openai import OpenAI

client = OpenAI(base_url="https://api.fableaiapi.com/v1", api_key="sk-ant-fai-your-key")
r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
print(r.choices[0].message.content)

支持流式输出、工具与函数调用、图片以及 stream_options.include_usage。计费方式与 Anthropic 格式相同。

05 /

API 参考

POST/v1/messages创建消息(流式或非流式)
POST/v1/chat/completionsOpenAI 格式对话:流式、工具、图片
POST/v1/messages/count_tokens统计请求的 token 数(免费)
GET/v1/models列出模型(两种格式)

身份验证

可以通过以下任一请求头发送密钥。所有接口都支持这两种方式,按你的工具默认方式即可。

Anthropic 方式
OpenAI 方式

不需要其他请求头。如果你的 SDK 发送了 anthropic-version 或 anthropic-beta,会原样转发。

请求
curl https://api.fableaiapi.com/v1/messages \
  -H "x-api-key: $FABLEAI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'
响应
{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "Hello! How can I help?" }],
  "model": "claude-sonnet-5-5",
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 9 }
}
06 /

模型

每个模型按每百万 token 统一计价。请完全按显示的 ID 使用。

Fable 5.2NEW$13.33 /1M
1M 上下文
Fable 5.1$13.33 /1M
1M 上下文
Opus 5.5$12.50 /1M
1M 上下文
Sonnet 5.5$12.90 /1M
1M 上下文
Haiku 5.5$13.33 /1M
200K 上下文
Fable 5$12.12 /1M
1M 上下文
Opus 5$11.43 /1M
1M 上下文
Sonnet 5$11.76 /1M
1M 上下文
Opus 4.8$11.11 /1M
1M 上下文
Opus 4.7$11.11 /1M
1M 上下文
Opus 4.6$11.11 /1M
1M 上下文
Sonnet 4.6$11.11 /1M
1M 上下文
Opus 4.5$11.11 /1M
200K 上下文
Sonnet 4.5$11.11 /1M
200K 上下文
Haiku 4.5$11.11 /1M
200K 上下文
Opus 4.1$11.11 /1M
200K 上下文

GET /v1/models 返回相同的列表,因此 9Router 等工具可以直接导入。

07 /

流式输出

发送 "stream": true。事件会实时原样转发。流结束时计费,即使你提前断开也会按已用量计费。

Python · anthropic
import anthropic

client = anthropic.Anthropic(base_url="https://api.fableaiapi.com", api_key="sk-ant-fai-your-key")
with client.messages.stream(
    model="claude-sonnet-5-5", max_tokens=1024,
    messages=[{"role": "user", "content": "Write a haiku about APIs"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
08 /

速率限制

60
次请求 / 分钟

每个密钥,已包含。

180
次请求 / 分钟

每个密钥的上限。更快的密钥价格高 5% 到 20%。

300
次请求 / 分钟

同一账户下所有密钥合计。

在 API Keys 页面创建或编辑密钥时设置速度。超出限制会返回 429 rate_limit_error,并带有 retry-after 请求头。官方 SDK 和 Claude Code 会自动等待并重试。

当余额较少且同时运行很多请求时,新请求会收到 429 和 retry-after: 5,直到某个正在运行的请求完成。这样可以防止余额变为负数。请求不会丢失,重试后即可完成。
09 /

错误

错误的 JSON 格式与 Anthropic API 相同: {"type":"error","error":{"type":"…","message":"…"}}

400invalid_request_error请求体不是有效的 JSON,或缺少字段。
401authentication_errorAPI 密钥缺失或错误。
402billing_error余额已用完。请在余额页面兑换优惠码。
403permission_error密钥已停用、已过期、超过消费上限,或无权使用该模型。
404not_found_error该模型 ID 不可用。请对照模型列表检查拼写。
429rate_limit_error每分钟请求过多,或余额被正在运行的请求占用。请在指定秒数后重试。
502api_error上游暂时无法连接,请重试。
10 /

常见问题

401 或 "invalid API key"

重新完整复制密钥(以 sk-ant-fai- 开头),末尾不要有空格。并在控制台中确认密钥已开启。

404 或 "model not found"

请完全按照模型列表中的 ID 填写,例如 claude-sonnet-5-5。不要在前面加提供商名称。

工具无法连接

确认工具使用的格式。Anthropic 格式填写 https://api.fableaiapi.com,不加 /v1;OpenAI 格式填写 https://api.fableaiapi.com/v1。不要在 Base URL 中填写 /messages 或 /chat/completions。

立即返回 429

可能是每分钟请求数超过了密钥限制,或者余额较少且有其他请求正在运行。请稍等几秒,工具会自动重试。

402 余额不足

在余额页面使用优惠码充值。余额到账后,密钥立即恢复可用。

11 /

计费

你的余额来自优惠码。每个模型按每百万 token 统一计价。输入、输出和缓存 token 计费相同,另外每个请求会有上游产生的少量固定开销。

API 响应中的 token 数为估算值。用量页面会显示每个请求的准确计费 token 和费用(约一分钟内确定),并可导出为 CSV。

需要更多余额或更高限制?请联系你的管理员。