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