Base URL#
| 协议 | Base URL | 说明 |
|---|
| OpenAI 兼容 | https://api.flyrouter.ai/v1 | OpenAI SDK 与大多数客户端填这个地址（带 /v1） |
| Anthropic 原生 | https://api.flyrouter.ai | Anthropic SDK、Claude Code 会自动拼接 /v1/messages（不带 /v1） |
| Gemini 原生 | https://api.flyrouter.ai | Google Gen AI SDK 会自动拼接 /v1beta/models/...（不带 /v1） |
所有接口都用 API Key 鉴权，详见 认证与 API Key：
- OpenAI 兼容：
Authorization: Bearer sk-...
- Anthropic 原生：
x-api-key: sk-...（也接受 Authorization: Bearer），并带 anthropic-version: 2023-06-01
- Gemini 原生：
Authorization: Bearer sk-... 或 x-goog-api-key: sk-...
端点一览#
OpenAI 兼容#
| 方法 | 路径 | 说明 |
|---|
POST | /v1/chat/completions | 对话补全，支持全部文本模型 |
POST | /v1/responses | Responses API，仅 GPT 系列 |
POST | /v1/images/generations | 生成图片 |
POST | /v1/images/edits | 编辑图片 |
GET | /v1/models | 模型列表 |
Anthropic 原生#
| 方法 | 路径 | 说明 |
|---|
POST | /v1/messages | Messages，Claude 系列推荐使用 |
Gemini 原生#
| 方法 | 路径 | 说明 |
|---|
POST | /v1beta/models/{model}:generateContent | 生成内容 |
POST | /v1beta/models/{model}:streamGenerateContent | 流式生成内容 |
平台接口#
选择协议#
- 调用 Claude：用 Anthropic 原生协议，提示词缓存、深度思考、工具调用等能力最完整。
- 调用 GPT：Chat Completions 或 Responses 都可以；新项目推荐 Responses。
- 调用 Gemini：Gemini 原生协议或 OpenAI 兼容协议都可以。
- 已有代码或工具只支持 OpenAI 格式：直接用 OpenAI 兼容协议调用任意文本模型。
错误与限流#
出错时返回对应的 HTTP 状态码和该协议的错误格式。请求过于频繁时返回 429，请降低并发并按指数退避重试。完整的状态码说明与重试建议见 错误处理与重试。
FlyRouter