限额与访问

在控制台 设置 → 限额与访问 统一管理整个团队的预算和访问规则，避免意外超支，也防止 API Key 泄露后被滥用。

只有团队所有者和管理员能修改这些规则。每一次修改都会记录在页面右上角的 变更记录 里。

预算上限

预算分团队、成员、API Key 三层，周期可以选每日、每月或总额。

三层分别计算，任意一层用完，请求就会被拦下。同一周期内，Key 预算不能超过所属成员的预算，成员预算不能超过团队预算。

每条预算可以选处理方式：

处理方式	到达上限时
限制使用	发邮件提醒，并停止调用
仅提醒	只发邮件提醒，不拦截

预算用完后充值不会恢复调用。需要调高上限，或等每日 / 每月周期重置。

只允许指定的 IPv4 地址或 CIDR 网段调用，最多 100 条。不在名单里的请求会被拒绝。

适合把生产环境的 Key 锁定在自己的服务器上：即使 Key 泄露，别人也无法从其他地方调用。

团队可以选三种方式，可以按厂商批量选择：

方式	说明
全部模型	可以调用所有模型，包括以后上线的新模型
只允许以下模型	只有列表中的模型可以调用，以后上线的新模型也不能调用
禁止以下模型	列表中的模型不能调用，其他模型不受影响

单个 Key 也可以在 Key 菜单的「可用模型」里再收窄。团队和 Key 的规则同时生效，两边都允许的模型才能调用。

一个 Key 同时受团队和 Key 两层规则约束。在 API Keys 的 Key 菜单点 检查生效规则，选一个模型，就能看到这次调用会不会被拦、被哪条规则拦、预算还剩多少。检查不消耗额度。

被预算或访问规则拦下的请求，重试也不会成功，需要先调整规则：

状态码	错误码	原因	怎么处理
`402`	`spending_limit_exceeded`	超出团队、成员或 Key 的预算上限	调高上限，或等周期重置
`402`	`insufficient_credits`	余额不足	充值
`403`	`ip_not_allowed`	调用 IP 不在白名单内	把该 IP 加入团队或 Key 的白名单
`403`	`model_not_allowed`	团队或 Key 不允许使用该模型	换模型，或调整可用模型
`503`	`spending_limit_check_unavailable`	暂时无法确认预算	稍后重试

被拦下的请求会出现在 请求明细 的「被拦截」筛选里。完整错误码见错误处理。

IP 白名单、可用模型和预算，谁在什么时候改了什么，都可以在 限额与访问 右上角 变更记录 里翻看。日志保留的设置不在这里记录，见请求日志。