# 限额与访问 — 预算、IP 白名单与可用模型 Source: https://ofox.ai/zh/docs/develop/limits-access 在控制台 **设置 → 限额与访问** 统一管理整个团队的预算和访问规则，避免意外超支，也防止 API Key 泄露后被滥用。 | 规则 | 作用 | 在哪设置 | |------|------|------| | 预算上限 | 花到上限就停止调用 | 团队、成员：限额与访问；Key：API Keys | | IP 白名单 | 只允许指定的服务器调用 | 团队：限额与访问；Key：Key 菜单「IP 白名单」 | | 可用模型 | 限制能调用哪些模型 | 团队：限额与访问；Key：Key 菜单「可用模型」 | | 请求频率 | 团队所有 Key 共用的每分钟请求数 | 只能查看，详见 [速率限制](https://ofox.ai/zh/docs/develop/guides/rate-limits) | 只有团队所有者和管理员能修改这些规则。每一次修改都会记录在页面右上角的 **变更记录** 里。 ## 预算上限 预算分团队、成员、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 菜单点 **检查生效规则**，选一个模型，就能看到这次调用会不会被拦、被哪条规则拦、预算还剩多少。检查不消耗额度。 ## 被拦截时的返回 被预算或访问规则拦下的请求，重试也不会成功，需要先调整规则： | 状态码 | 错误码 | 原因 | 怎么处理 | |------|------|------|------| | `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` | 暂时无法确认预算 | 稍后重试 | 被拦下的请求会出现在 **请求明细** 的「被拦截」筛选里。完整错误码见 [错误处理](https://ofox.ai/zh/docs/develop/guides/error-handling)。 ## 变更记录 IP 白名单、可用模型和预算，谁在什么时候改了什么，都可以在 **限额与访问** 右上角 **变更记录** 里翻看。日志保留的设置不在这里记录，见 [请求日志](https://ofox.ai/zh/docs/develop/observability/request-logs)。