鑑權方式
Base URL 在哪裡取得、三種協議分別如何鑑權（Bearer / x-api-key / x-goog-api-key）。
每次呼叫都需要兩項東西：API 金鑰（證明你是誰）與 Base URL（請求要送到哪裡）。兩者都能在控制台取得。
取得 Base URL
登入控制台，在任一模型卡片開啟「快速介接」彈窗（也可以從帳戶總覽開啟）。在下拉選單中選擇你的協議，複製對應的 Base URL。
- 不同協議的路徑前綴不同——請一律從彈窗複製；
- 文件中的範例寫成
https://<your-base-url>；請替換成你的實際位址。
各協議的鑑權方式
| 協議 | 鑑權標頭 | 備註 |
|---|---|---|
| OpenAI 相容 | Authorization: Bearer YOUR_API_KEY | 可搭配官方 OpenAI SDK 使用——設定 api_key + base_url |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | 版本標頭為必填；SDK 會自動帶上 |
| Gemini | x-goog-api-key: YOUR_API_KEY | 模型 ID 直接放在 URL 路徑中 |
常見的鑑權錯誤
- 401 Unauthorized：金鑰錯誤、已被刪除或已過期。確認你使用的是建立時保存的完整金鑰，且沒有多餘空白或換行。
- 金鑰暴露在前端程式碼：任何放在瀏覽器程式碼裡的東西所有人都看得到——金鑰應該放在你的伺服器或本機環境變數中。
- 用錯金鑰：每把金鑰有各自的消費上限；請確認你用的是對應環境（正式 / 測試）的正確金鑰。
金鑰的建立與保管方式，請見建立 API 金鑰。