Skip to Content
快速開始限額與存取

限額與存取

在控制台 設定 → 限額與存取 統一管理整個團隊的預算和存取規則,避免意外超支,也防止 API Key 外洩後被濫用。

規則作用在哪設定
預算上限花到上限就停止呼叫團隊、成員:限額與存取;Key:API Keys
IP 白名單只允許指定的伺服器呼叫團隊:限額與存取;Key:Key 選單「IP 白名單」
可用模型限制能呼叫哪些模型團隊:限額與存取;Key:Key 選單「可用模型」
請求頻率團隊所有 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 選單點 檢查生效規則,選一個模型,就能看到這次呼叫會不會被攔、被哪條規則攔、預算還剩多少。檢查不消耗額度。

被攔截時的回傳

被預算或存取規則攔下的請求,重試也不會成功,需要先調整規則:

狀態碼錯誤碼原因如何處理
402spending_limit_exceeded超出團隊、成員或 Key 的預算上限調高上限,或等週期重置
402insufficient_credits餘額不足儲值
403ip_not_allowed呼叫 IP 不在白名單內把該 IP 加入團隊或 Key 的白名單
403model_not_allowed團隊或 Key 不允許使用該模型換模型,或調整可用模型
503spending_limit_check_unavailable暫時無法確認預算稍後重試

被攔下的請求會出現在 請求明細 的「被攔截」篩選裡。完整錯誤碼見 錯誤處理。

變更紀錄

IP 白名單、可用模型和預算,誰在什麼時候改了什麼,都可以在 限額與存取 右上角的 變更紀錄 裡翻看。日誌保留的設定不在這裡記錄,見 請求日誌。

最後更新於