開放平台 API 認證
開放平台 API 請求使用管理金鑰（Management Key）以 Bearer 權杖方式認證：
Authorization: Bearer rat_your_management_key例如：
curl https://www.routeapi.ai/api/open/v1/balance \ -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"管理金鑰（Management Key）
Section titled “管理金鑰（Management Key）”管理金鑰是開放平台 API（/api/open/v1）的憑證，以 rat_ 開頭。它和呼叫模型用的 sk- API Key 是兩種不同的憑證：
| 憑證 | 前綴 | 用途 |
|---|---|---|
| 管理金鑰 | rat_ | 呼叫 /api/open/v1 管理帳戶與 API Key |
| API Key | sk- | 呼叫模型介面（如 /v1/chat/completions），見 Chat Completions |
管理金鑰只能操作所屬使用者自己的資源，不繼承管理員權限，也不能透過開放平台 API 管理管理金鑰本身。
建立管理金鑰
Section titled “建立管理金鑰”- 登入 RouteAPI 控制台。
- 在側欄開啟 Management Keys（位於 Billing 與 Playground 之間），或直接前往 console/management-keys。
- 填寫名稱、選擇過期時間，建立金鑰。
- 立即複製並保存
rat_開頭的明文金鑰。
每個使用者最多保留 10 個管理金鑰。過期的金鑰會留在清單中並繼續佔用名額，刪除後才能再建立。金鑰外洩時請在同一頁面刪除，刪除立即生效。
新建的管理金鑰只能刪除，不能撤銷後再啟用。刪除是停用金鑰的唯一方式，使用已刪除金鑰的請求會回傳 401 invalid_token。
- 把管理金鑰存入密鑰管理服務或 CI Secret，不要寫進會提交的程式碼或設定檔。
- 為每個腳本或服務建立各自的管理金鑰，這樣刪除其中一個不會影響其他金鑰。
- 設定過期時間。不再需要的金鑰應該直接刪除，而不是放著讓它過期。
- 只把金鑰交給真正需要管理帳戶的系統。呼叫模型的應用需要的是
sk-API Key，不是這把金鑰。 - 定期檢查管理金鑰清單，刪除任何已無法辨識來源的金鑰。
兩種憑證不能互換，各自的 API 都會以 401 拒絕另一種金鑰：
| 請求 | 結果 |
|---|---|
sk- API Key 送到 /api/open/v1 | 401 invalid_token——該路徑需要管理金鑰 |
rat_ 管理金鑰送到 /v1/chat/completions 等模型介面 | 401 認證錯誤——該路徑需要 API Key |
如果金鑰看起來有效，但呼叫任一 API 都回傳 401，請確認它是在哪個頁面建立的、前綴是什麼。
錯誤碼與頻率限制見錯誤與限制。