限額與存取
在控制台 設定 → 限額與存取 統一管理整個團隊的預算和存取規則,避免意外超支,也防止 API Key 外洩後被濫用。
只有團隊擁有者和管理員能修改這些規則。每一次修改都會記錄在頁面右上角的 變更紀錄 裡。
預算上限
預算分團隊、成員、API Key 三層,週期可以選 每日、每月 或 總額。
- 團隊預算:整個團隊的花費上限
- 成員預設預算:每位成員各自計算;另外為某位成員設了預算的,以個別設定為準
- Key 預算:在 API Keys 頁面為單一 Key 設定
三層分別計算,任何一層用完,請求就會被攔下。同一週期內,Key 預算不能超過所屬成員的預算,成員預算不能超過團隊預算。
每筆預算可以選處理方式:
預算用完後儲值不會恢復呼叫。需要調高上限,或等每日 / 每月週期重置。
IP 白名單
只允許指定的 IPv4 位址或 CIDR 網段呼叫,最多 100 筆。不在名單裡的請求會被拒絕。
- 團隊 IP 白名單:對團隊所有 API Key 生效
- Key IP 白名單:在團隊名單的基礎上,為單一 Key 再收窄;Key 名單裡的位址也必須在團隊名單內才會生效
適合把正式環境的 Key 鎖定在自己的伺服器上:即使 Key 外洩,別人也無法從其他地方呼叫。
可用模型
團隊可以選三種方式,並可依廠商批次選擇:
單一 Key 也可以在 Key 選單的「可用模型」裡再收窄。團隊和 Key 的規則同時生效,兩邊都允許的模型才能呼叫。
檢查生效規則
一個 Key 同時受團隊和 Key 兩層規則約束。在 API Keys 的 Key 選單點 檢查生效規則,選一個模型,就能看到這次呼叫會不會被攔、被哪條規則攔、預算還剩多少。檢查不消耗額度。
被攔截時的回傳
被預算或存取規則攔下的請求,重試也不會成功,需要先調整規則:
被攔下的請求會出現在 請求明細 的「被攔截」篩選裡。完整錯誤碼見 錯誤處理。
變更紀錄
IP 白名單、可用模型和預算,誰在什麼時候改了什麼,都可以在 限額與存取 右上角的 變更紀錄 裡翻看。日誌保留的設定不在這裡記錄,見 請求日誌。
最後更新於