开发文档
认证与 API Key
所有请求都用 API Key 鉴权。三种协议使用各自习惯的请求头，但填的是同一个 Key。
创建 API Key
在控制台 API 密钥 页面点击「创建密钥」。密钥以 sk- 开头，创建后请立即复制保存。一个账户可以建多个 Key，比如按项目、环境或成员分开，方便单独限额和停用。
在请求中携带 Key
| 协议 | 请求头 | 示例 |
|---|---|---|
| OpenAI 兼容 | Authorization | Authorization: Bearer sk-... |
| Anthropic 原生 | x-api-key（也接受 Authorization: Bearer） | x-api-key: sk-... |
| Gemini 原生 | Authorization: Bearer 或 x-goog-api-key | x-goog-api-key: sk-... |
官方 SDK 会自动带上正确的请求头，你只需要把 Key 传给 SDK：
Python
from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://api.flyrouter.ai/v1")限制单个 Key 的权限
编辑 Key 时可以设置以下限制，超出限制的请求会被直接拒绝，不会扣费：
- 额度上限：这个 Key 最多能花多少钱，用完即停，适合分给成员或第三方工具。
- 过期时间：到期后自动失效。
- 可用模型：只允许调用指定的模型，其他模型返回 403。
- IP 白名单：只接受来自指定 IP 或网段的请求。
给 Claude Code、Cursor 这类工具单独建一个 Key 并设置额度上限，即使配置文件被分享出去，损失也可控。
安全建议
- Key 等同于账户密码，只在服务端或自己的电脑上使用，不要写进前端代码、App 安装包或公开仓库。
- 用环境变量或密钥管理服务保存 Key，不要硬编码在源码里。
- 怀疑泄露时，立即在控制台删除该 Key 并新建一个替换，旧 Key 删除后马上失效。
鉴权失败怎么办
返回 401 时，按顺序检查：
- Key 是否完整复制（
sk-开头，前后没有空格或换行）。 - 请求头是否和协议对应，比如 Anthropic 协议用的是
x-api-key。 - Key 是否已被删除、禁用或过期，可在控制台查看状态。
- Base URL 是否填对：OpenAI SDK 带
/v1，Anthropic 与 Gemini SDK 不带。
FlyRouter