API 金鑰管理
API 金鑰是呼叫 API 的憑證,每個金鑰可獨立設定權限範圍和配額上限。左側導航點選「API 金鑰」,或直接存取 /keys。
API 金鑰列表展示所有已建立的金鑰,包含名稱、狀態、已用配額、剩餘配額、過期時間等資訊。

建立 API 金鑰
基本設定
開啟建立彈窗
在 API 金鑰列表頁點選右上角「建立 API 金鑰」按鈕,彈出建立彈窗
填寫金鑰名稱
輸入金鑰名稱(建議按用途命名,如「生產環境」「測試用」)

高階設定選項
| 設定項 | 說明 |
|---|---|
| 過期時間 | 設定有效期,留空或設為 -1 表示永不過期 |
| 額度 | 限制該 API 金鑰可消耗的最大配額,超出後自動失效 |
| 無限配額 | 開啟後不受配額限制(仍受賬戶總配額約束) |
| 模型限制條件 | 限定該 API 金鑰只能呼叫指定模型,留空表示不限制 |
| IP 白名單 | 限定允許使用該 API 金鑰的來源 IP,留空表示不限制 |
| 分組 | 指定該 API 金鑰使用的渠道分組 |
儲存 API 金鑰
點選「儲存更改」,完成 API 金鑰建立流程,可在權杖列表中複製使用 API 金鑰。

編輯 API 金鑰
在 API 金鑰列表中找到目標金鑰,點選右側「編輯」按鈕,可修改 API 金鑰的設定選項(不包括 API 金鑰本身)。可修改的選項包括過期時間、額度、模型限制條件、IP 白名單和分組等。
刪除 API 金鑰
在 API 金鑰列表中找到目標金鑰,點選右側「刪除」按鈕,確認後該 API 金鑰立即失效,無法恢復。
ℹ️ 最佳實踐
- 為不同用途(生產、測試、開發)建立獨立 API 金鑰
- 為每個 API 金鑰設定合理的配額上限,防止意外超額消耗
- 定期清理不再使用的 API 金鑰
- 對生產環境 API 金鑰設定 IP 白名單提高安全性