開發文件
認證與 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