配額管理

通過建立可復用的配額規則模板，精確控制 API Key 和帳戶的消費上限。每條規則可定義額度限制和時間窗口，綁定到單個 Key 或設為帳戶預設。

IMG配額管理/placeholders/docs/guide/quota-management.png

---

使用場景

• 防止超額消費 — 為 Key 設定每日、每周、每月積分上限，額度用完後目前周期內自動拒絕請求。
• 環境隔离 — 給開發調試用的 Key 設低額度，生產 Key 保持無限制，避免誤操作消耗。
• 限制使用時段 — 只允許工作時間調用 API，如周一至周五 08:00–20:00，防止腳本夜間異常跑量。

---

規則生效邏輯

規則遵循明確的優先級鏈：

API Key 綁定的規則（優先） → 帳戶預設規則（次之） → 無限制

• API Key 設定了獨立規則 → 使用該規則。
• API Key 未設定 → 繼承帳戶預設規則。
• 兩者都未設定 → 該 Key 無任何消費和時間限制。

---

建立規則

點擊「+ 建立配額規則」打開編輯面板。

IMG建立配額規則/placeholders/docs/guide/create-quota-rule.png

基本信息

• 規則名稱 — 起一個好記的名字，例如「開發 Key 每日上限」。
• 描述 — 可選，補充說明規則適用的場景。
• 啟用規則 — 開關控制。停用後規則保留，但不會被新綁定時推薦。

額度限制

• 啟用額度限制 — 開啟後設定消費上限。達到上限後，目前周期剩餘時間內請求被拒絕。
• 額度周期 — 選擇每日、每周或每月。每個周期開始時額度清零重置。
• 額度上限 — 周期內允許的最大積分消耗。輸入框旁標注單位為積分。

時間窗口

• 啟用時間窗口 — 開啟後限制規則生效的時段。時段外請求會被攔截。
• 時區 — 選擇規則綁定的時區，如 UTC+8。
• 允許星期 — 勾選允許調用 API 的星期。通常工作時間勾選周一至周五。
• 允許時段 — 設定時間段，格式為 HH:MM-HH:MM，如 08:00-20:00。

規則預覽

編輯面板底部的預覽區會以純文本形式展示規則生效後的實際效果，提交前請確認無誤。

---

綁定規則的位置

綁定到 API Key

進入 API Key 管理，找到目標 Key，點擊行內的「綁定規則」。在下拉菜單中選擇一條規則，或選擇「繼承帳戶預設規則」沿用帳戶級設定。

設定帳戶預設規則

進入個人設定，找到「預設配額規則」卡片，在下拉框中選擇一條規則作為帳戶全局預設。未單獨設定的 API Key 將自動繼承此規則。

IMG預設配額規則/placeholders/docs/guide/default-quota-rule.png

---

管理已有規則

規則列表展示所有已建立的模板，每行顯示：

列名	說明
規則名稱	建立時設定的名稱
額度限制	周期和積分上限
時間窗口	允許的星期和時段，附帶時區
狀態	啟用或停用
被引用數	目前有多少 API Key 綁定了此規則
操作	編輯修改規則，啟用或停用切換狀態

已有 Key 引用的規則仍可修改，修改後立即對所有綁定 Key 生效。