接口总览
要写代码的人看这页：端点选哪个、三种兼容协议怎么接、鉴权放在哪里。
📌
动手之前先确认两件事
- 令牌建在哪个分组上 —— 分组决定了这个令牌能调用哪些模型。选错会返回
模型不存在。 - 你要用哪个端点 —— OpenAI 兼容接口必须带
/v1，Anthropic 兼容接口必须不带。 这两条写反了，报错会很难懂。
端点：两个地址，功能相同
FluxToken 提供两个 API 入口，功能完全一致，只是网络路径不同：
国内加速https://cn.fluxtoken.ai默认使用。国内网络首选，延迟更低。
全球站 · 源站直连https://api.fluxtoken.ai港澳台及境外用户请用此地址；国内加速异常时也可回退到这里。
| 你所在的位置 | 用哪个 |
|---|---|
| 国内网络 | https://cn.fluxtoken.ai（默认） |
| 港澳台及境外 | https://api.fluxtoken.ai |
| 国内加速异常 | 回退到 https://api.fluxtoken.ai |
不要写死成一个
如果你的程序要长期跑，把端点做成配置项。上游渠道波动时切换端点比改代码快得多。
三种兼容协议
同一套模型，FluxToken 用三种协议对外暴露。按你手上的客户端/ SDK 选，不要混用。
| 协议 | 基础地址 | 典型路径 | 谁在用 |
|---|---|---|---|
| OpenAI 兼容 | https://cn.fluxtoken.ai/v1 | /chat/completions、/responses、/models | OpenAI SDK、Codex、Cherry Studio 兼容模式 |
| Anthropic 兼容 | https://cn.fluxtoken.ai（不带 /v1） | SDK 自己拼 /v1/messages | Claude Code、Anthropic SDK |
| Gemini 兼容 | https://cn.fluxtoken.ai | /v1beta/models/<模型>:generateContent | Gemini SDK、Cline / Roo Code |
逐个看：
/v1 该怎么给：一张表说清
这是全站最容易填错的一格。
| 你要接的东西 | 填什么 | 填错的后果 |
|---|---|---|
OpenAI SDK 的 base_url | https://cn.fluxtoken.ai/v1 | 少写 → 404；多写 → /v1/v1/... 也 404 |
Codex 的 base_url | https://cn.fluxtoken.ai/v1 | 同上 |
Anthropic SDK 的 base_url | https://cn.fluxtoken.ai | 多写 /v1 → 变成 /v1/v1/messages，404 |
Claude Code 的 ANTHROPIC_BASE_URL | https://cn.fluxtoken.ai | 同上 |
Gemini SDK 的 base_url | https://cn.fluxtoken.ai | SDK 自己拼 /v1beta/... |
一句话记忆：只有 OpenAI 系的东西要你自己补 /v1，另外两家客户端会自己拼。
国内加速 · OpenAI 兼容https://cn.fluxtoken.ai/v1用于 Codex、OpenAI SDK、Cherry Studio 兼容模式等。
鉴权
所有模型调用接口都需要令牌（API Key）。控制台里叫「令牌」，创建路径是 令牌管理 → 添加令牌。
服务端接受三种请求头，任选一种：
| 请求头 | 写给谁 |
|---|---|
Authorization: Bearer <令牌> | OpenAI 兼容、Anthropic 兼容（通用） |
x-api-key: <令牌> | Anthropic 兼容 |
x-goog-api-key: <令牌> | Gemini 兼容 |
curl 带令牌
curl https://cn.fluxtoken.ai/v1/models \ -H "Authorization: Bearer sk-你的令牌"缺少鉴权头时，服务端返回 401 并在响应体里说明可用哪几种请求头：
json
{
"code": "API_KEY_REQUIRED",
"message": "API key is required in Authorization header (Bearer scheme), x-api-key header, or x-goog-api-key header"
}令牌本身无效时返回 401 与 {"code":"INVALID_API_KEY","message":"Invalid API key"}。 详细排查见认证与 401。
令牌不要写进代码仓库
令牌等同于账号权限。放进 .env 或本地配置，别提交到 Git。
通用请求要点
- 模型名必须逐字正确。
gpt-image-2.5-flare与gpt-image-2.5-sunburst是两个模型。 完整清单见模型列表。 - 模型名和分组必须匹配。令牌所属分组里没有的模型，一律返回
模型不存在。 - 流式响应用 SSE。OpenAI 兼容接口支持
stream: true，返回text/event-stream。 - 计费按实付价：
实付价 = 基准价 × 分组倍率。要看精确数字，读 公开价格接口，别手算。 - 长上下文可能跳档。部分模型超出某个上下文长度后单价上浮，档位信息同样在价格接口里。
- 生图模型按次计费，不按 token。参见生图模型。
公开数据接口
不用令牌、不用登录的只读接口，适合做监控和账单核对：
| 接口 | 地址 |
|---|---|
| 公开价格（实付价） | https://status.fluxtoken.ai/pricing/provider-pricing.json |
| 模型广场 | https://cn.fluxtoken.ai/api/v1/model-plaza |
| 公开设置 | https://cn.fluxtoken.ai/api/v1/settings/public |
| 服务状态页 | https://status.fluxtoken.ai/ |
字段说明与抓取注意事项见公开价格接口。
出错了去哪
- 报错原文总索引：报错原文索引
- 状态码对照：错误码对照
- 服务状态页：https://status.fluxtoken.ai/