跳到內容
RouteAPI RouteAPI

開放平台 API 認證

開放平台 API 請求使用管理金鑰（Management Key）以 Bearer 權杖方式認證：

Authorization: Bearer rat_your_management_key

例如：

Terminal window
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 Keysk-呼叫模型介面（如 /v1/chat/completions），見 Chat Completions

管理金鑰只能操作所屬使用者自己的資源，不繼承管理員權限，也不能透過開放平台 API 管理管理金鑰本身。

建立管理金鑰

Section titled “建立管理金鑰”
  1. 登入 RouteAPI 控制台。
  2. 在側欄開啟 Management Keys（位於 Billing 與 Playground 之間），或直接前往 console/management-keys。
  3. 填寫名稱、選擇過期時間，建立金鑰。
  4. 立即複製並保存 rat_ 開頭的明文金鑰。

每個使用者最多保留 10 個管理金鑰。過期的金鑰會留在清單中並繼續佔用名額，刪除後才能再建立。金鑰外洩時請在同一頁面刪除，刪除立即生效。

新建的管理金鑰只能刪除，不能撤銷後再啟用。刪除是停用金鑰的唯一方式，使用已刪除金鑰的請求會回傳 401 invalid_token。

安全建議

Section titled “安全建議”
  • 把管理金鑰存入密鑰管理服務或 CI Secret，不要寫進會提交的程式碼或設定檔。
  • 為每個腳本或服務建立各自的管理金鑰，這樣刪除其中一個不會影響其他金鑰。
  • 設定過期時間。不再需要的金鑰應該直接刪除，而不是放著讓它過期。
  • 只把金鑰交給真正需要管理帳戶的系統。呼叫模型的應用需要的是 sk- API Key，不是這把金鑰。
  • 定期檢查管理金鑰清單，刪除任何已無法辨識來源的金鑰。

憑證混用

Section titled “憑證混用”

兩種憑證不能互換，各自的 API 都會以 401 拒絕另一種金鑰：

請求結果
sk- API Key 送到 /api/open/v1401 invalid_token——該路徑需要管理金鑰
rat_ 管理金鑰送到 /v1/chat/completions 等模型介面401 認證錯誤——該路徑需要 API Key

如果金鑰看起來有效，但呼叫任一 API 都回傳 401，請確認它是在哪個頁面建立的、前綴是什麼。

錯誤碼與頻率限制見錯誤與限制。