API 金鑰管理

API 金鑰是呼叫 API 的憑證,每個金鑰可獨立設定權限範圍和配額上限。左側導航點選「API 金鑰」,或直接存取 /keys

API 金鑰列表展示所有已建立的金鑰,包含名稱、狀態、已用配額、剩餘配額、過期時間等資訊。

API 金鑰列表

建立 API 金鑰

基本設定

開啟建立彈窗

在 API 金鑰列表頁點選右上角「建立 API 金鑰」按鈕,彈出建立彈窗

填寫金鑰名稱

輸入金鑰名稱(建議按用途命名,如「生產環境」「測試用」)

建立 API 金鑰

高階設定選項

設定項說明
過期時間設定有效期,留空或設為 -1 表示永不過期
額度限制該 API 金鑰可消耗的最大配額,超出後自動失效
無限配額開啟後不受配額限制(仍受賬戶總配額約束)
模型限制條件限定該 API 金鑰只能呼叫指定模型,留空表示不限制
IP 白名單限定允許使用該 API 金鑰的來源 IP,留空表示不限制
分組指定該 API 金鑰使用的渠道分組

儲存 API 金鑰

點選「儲存更改」,完成 API 金鑰建立流程,可在權杖列表中複製使用 API 金鑰。

API 金鑰展示

編輯 API 金鑰

在 API 金鑰列表中找到目標金鑰,點選右側「編輯」按鈕,可修改 API 金鑰的設定選項(不包括 API 金鑰本身)。可修改的選項包括過期時間、額度、模型限制條件、IP 白名單和分組等。

刪除 API 金鑰

在 API 金鑰列表中找到目標金鑰,點選右側「刪除」按鈕,確認後該 API 金鑰立即失效,無法恢復。

ℹ️ 最佳實踐
  • 為不同用途(生產、測試、開發)建立獨立 API 金鑰
  • 為每個 API 金鑰設定合理的配額上限,防止意外超額消耗
  • 定期清理不再使用的 API 金鑰
  • 對生產環境 API 金鑰設定 IP 白名單提高安全性