7. 配置模型分组的可用范围与配额

完整版章节。内容按 2026.10 主线代码与运行环境界面核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向平台管理员和负责成本管控的人员，说明如何决定谁能使用一个模型分组、能用多久、能用多少。读完本章，你可以完成以下工作：按成员、部门、职能组或全员授权模型分组，设置授权的生效与失效时间，为授权对象和整个分组设置 Token 与金额预算，理解分组、对象、API 密钥三层配额的关系，为授权对象设置专属价，排查被拒绝的调用，以及安全地移除授权。

模型分组建好之后默认不对任何人开放。分组详情的「可用范围与配额」页签说明了这一机制：仅可用范围内的企业成员可使用该模型分组；每个对象一条规则，规则下每个周期各是一个额度池，用满即拒绝。

入口：「管理后台 › 组织与权限 › 模型分组」，点击分组名称，打开「可用范围与配额」页签。

前提：以租户管理员或具备模型分组管理权限的角色登录；模型分组已创建（第 6 章）；按部门或职能组授权前，组织架构已维护好（第 3 章）；金额预算与专属价要求分组内的模型已设置售价（第 5 章）。

7.1 按成员、部门、职能组授权

适用场景：决定哪些人可以看到并调用一个模型分组。

可用范围的对象类型有四种，另有「所有用户」表示全员：

范围应从小到大逐步开放。上线高成本或高敏感的分组时，先授权给试点成员或一个部门，效果与费用符合预期后再扩大。

操作步骤

1. 在「可用范围与配额」页签选择「编辑可用范围」，打开「可用范围」对话框。
2. 在左上角下拉中切换对象类型（部门、职能组、工作空间、成员、所有用户），在组织架构中搜索并勾选。右侧实时统计已选数量。组织架构中只展示你可见的部门；要添加列表中未出现的部门时，输入部门的完整名称精确搜索。
3. 选择「下一步」，进入「配置目标有效期」（第 7.2 节）。
4. 选择「保存」。

你会看到

保存后页面提示「分发已保存」，「企业内成员」表格列出已授权的对象，列为「范围名称」「类型」「配额」「专属价」，行末提供「配额编辑」「设置专属价」「移除」。

同一个分组可以同时授权不同类型的对象，例如既给一个部门、又给一个职能组；它们各自是一条规则，各自有配额与专属价，互不覆盖。

范围内的成员看到什么

• 工作台「模型分组」列表中出现该分组，附可用模型与「用量&配额」；
• 在模型广场的模型详情里「获取 API 密钥」时，「API 密钥归属」中可以选择该分组，例如「个人专属 · 通用对话」，用它创建的密钥可以立即调用。

范围外的成员看到什么

• 工作台「模型分组」列表里没有这个分组；
• 「获取 API 密钥」的归属候选中没有它；
• 直接访问该分组的详情地址会被整页重定向回工作台，看不到分组内容。

注意：

• 授权的是「分组」，不是某个模型。分组内新增模型后，范围内对象自动可用，不需要重新授权。
• 「API 密钥归属」决定这把密钥代表哪条授权、用量计入哪些额度池。同一成员因多条授权可能有多个可选归属，创建时选错会让用量记到别的部门或项目上。
• 成员被移出某个部门或职能组后，经该部门或职能组获得的授权随之失效，下一次请求即被拒绝。
• 被拒绝的调用都记入「运行总览 › 请求」，可按调用方追溯（第 20 章）。

7.2 设置生效与失效时间

适用场景：临时授权（项目期内、试用期内），或预先配好、到指定时间才生效的授权。

操作步骤

1. 在「可用范围」对话框选好对象后选择「下一步」，进入「配置目标有效期」。
2. 在「默认有效期」中选择：

1. 需要为不同对象设置不同期限时，勾选「为选中角色分配单独有效期」，在列表中逐个设置。
2. 选择「保存」。

你会看到：企业内成员表格中，「范围名称」下方标注授权状态，例如「剩余 8 天 20 小时」或「已失效」。未生效或已失效期间，该对象的调用被拒绝；历史授权记录保留，便于审计。

续期：对已失效或即将到期的对象，重新打开「编辑可用范围」，为它设置新的有效期并保存即可恢复。

注意：

• 有效期作用于授权本身。API 密钥自身还有独立的有效期，两者互不替代（第 9 章）。
• 当前版本如在使用「自定义」时遇到时间选择器选中后自动关闭、之前的日期选择丢失，请改用预设时长（7 天、30 天）或「长期有效」，保存后重新打开该页确认结果。
• 平台不提供「每日生效时间段」。需要某把密钥只在指定时段可用（例如只在夜间批处理窗口），由管理员新建流量规则：条件为「调用方属于该密钥」且「时段落在不允许的时间段」，动作为「拒绝请求」，并填写可识别的原因码。时段外的调用返回 403，其他密钥不受影响（第 15 章）。

7.3 为授权对象设置 Token 与金额预算

适用场景：控制某个成员、部门或职能组在一个分组上的用量或花费，用满即停。

操作步骤

1. 在「可用范围与配额」页签的对象行选择「配额编辑」，打开「编辑配额」对话框。对话框顶部显示当前对象，例如「某成员 · 成员」。
2. 打开「启用策略」开关。停用后保留设置，但不再限制请求，额度池也停止记账。
3. 按需填写各周期的预算，选择「确认」。

字段说明

必须知道的四条规则

• 留空表示该周期不限；填 0 是硬墙，不是不限。填 0 会让该周期的全部调用被拒绝，适合「暂时冻结但保留配置」的场景。要恢复不限，把已填的值清空后保存。
• 已用量在调用结束后记账。平台在放行一次请求时看的是「已记账的用量」，因此单次调用可能把已用量推过限额，从下一次调用起才开始拒绝；同时发出的多个请求也会一起被放行而短暂超出。这样做的代价是限额会被小幅穿透，换来的是每次调用不必等待上一笔结算。
• 各周期、各预算类型可以任意组合。每个填写的上限都同时生效，任一用满即拒绝。
• 启用策略时至少要填写一个周期预算。

你会看到

1. 保存后提示「配额已保存」，对象行的「配额」列显示额度池，例如「本月 · Token · 已用 0 / 限额 300」。
2. 用满后该对象的调用返回 HTTP 429，错误类型 insufficient_quota，原因 POOL_EXHAUSTED；对象行的额度池以红色显示已用量与限额，超过限额时已用量会大于限额。

被拒绝的调用在「运行总览 › 请求」中结果为「已拦截」，打开详情能看到请求体、响应状态码与发起人：

注意：

• 金额预算按每次调用的有效单价累加。调用方带金额预算时，未定价的模型会被跳过；可用的模型全部未定价时，调用返回 HTTP 429，原因 POOL_MONEY_UNPRICED。因此设金额预算前，先把分组内用到的模型都定价（第 5 章）。分组内模型都还没有发布价时，对话框提示金额预算暂时不能填，此时只能填写 Token 预算。
• 配额只限制当前模型分组。它不是成员或部门在平台上的总预算，同一个人在其他分组上的用量不受这里影响。
• 小时、天、月按周期滚动，周期结束后重新从 0 计；「累计」覆盖全部时间，不重置。额度池上标注的「截至 …」是当前统计到的时间点。
• 需要提前感知预算触顶时，在「运行总览」的「预算」面板中查看各额度池的当期用量与状态（「未超限」「接近限额」「额度耗尽」等）。

7.4 分组级配额

适用场景：给整个分组设一个总盘子，所有调用方共享，例如「低成本批处理每月总 Token 不超过某个数」。

操作步骤

1. 进入分组详情的「基本信息」页签，在左侧「分组级配额」旁选择「编辑配额」，打开「分组级配额」对话框。
2. 字段与对象配额完全相同（启用策略、Token 预算、金额预算，各含小时、天、月、累计），填写后选择「确认」。
3. 用左侧的「分组配额」开关启用或停用。

你会看到：「分组配额」下方显示各额度池的用量与限额，例如「本月 · Token · 已用 0 / 限额 200」。用满后显示「已用尽」，该分组的全部调用返回 429，与是哪个成员、哪把密钥无关。

注意：分组级配额与对象配额是两层独立判断。分组级用满会连带拒掉所有人，包括尚未用完自己额度的成员。排查时先看是哪一层用尽，再决定调高上限还是通知使用方。

7.5 多层配额的关系

一次调用可能同时计入多个额度池。平台逐层判断，任一层用满都会拒绝：

操作步骤（为单把密钥设额度）

1. 进入「管理后台 › 组织与权限 › 模型分组 › API 密钥管理」，搜索并打开目标密钥。
2. 在详情中确认「计入的额度池」，再选择「编辑配额」。
3. 填写额度后选择「确认」。

规则

• 一把密钥的用量同时计入它自己的额度池、它所属授权对象的额度池和分组级额度池，每层都扣减，不是只扣一层。
• 下层额度可以设得比上层大，平台不校验，也不会拒绝保存。实际调用时按最严的一层生效，上层额度池始终能兜住下层——因此在上层已用满时，「给某把密钥单独放宽」不起作用。
• 新建的额度池从 0 开始计数，不回填本周期已用量。给一个已经用掉大量额度的对象新设本月额度时，它的起点是 0，而不是本月的实际已用量。
• 各级用量可以在页面上分别看到：分组「可用范围与配额」列出每个对象的池，密钥详情同时显示上级池与自己的池。
• 调用被拒绝时，错误详情会指明是哪一层拦下的（成员、部门还是整个分组）、哪个周期、哪种预算，可以据此直接定位要调整的那一层。

注意：平台没有「父级额度按比例分配给子级」「子级之和不得超过父级」这类模型。需要按项目单独控制时，把项目拆成独立的模型分组或职能组，分别授权、分别设配额。

7.6 为授权对象设置专属价

适用场景：对内结算时对不同部门或成员采用不同价格，或给某个对象单独的阶梯价。

前提：作为计价基础的模型必须已经设置售价（第 5 章）。

操作步骤

1. 在「可用范围与配额」页签的对象行选择「设置专属价」，打开「对象专属价」对话框。
2. 选择「网关模型」。
3. 设置「累计周期」「累计方法」「计价方式」（单价或 Token 倍率）与「跨档计价」（分段计价或整笔计价）。
4. 在「价格区间」中「添加档位」，填写用量区间与单价；只有一个价格时保留 0～∞ 一档。
5. 选择「确认」。

你会看到：对话框顶部写明三条规则——「为该对象在本模型分组中的调用单独设置阶梯价，优先于模型供应商处的标准价」；「同一次调用命中多个对象时，取最具体的一个：用户 > 职能组 > 部门 > 工作空间 > 本分组全部成员」；「改档表后历史账单不变」「已结算的调用不重新计价」。保存后该对象行「专属价」列不再为空。

注意：

• 模型未定价时，对话框会提示「这个模型在模型供应商处还没有标准价，不能设置专属价」，并提供「去定价」入口。先定价，再回来设专属价。
• 「Token 倍率」档的价格按模型标准价乘以倍率得出，只影响金额，不改变额度消耗。
• 修改档位只对之后的调用生效，已结算的账单不重算。跨结算周期调价前，先与财务确认口径。

7.7 排查被拒绝的调用

调用方收到拒绝时，先看错误码判断是哪一层拦下的：

被拒绝的请求都可以在「管理后台 › 观测中心 › 运行总览 › 请求」中按调用方、接入凭据或链路编号查到，详情里给出拒绝来源与时间（第 20 章）。

注意：配额类的拒绝带 x-should-retry: false 响应头，表示自动重试没有意义，需要等周期重置或调整限额。限流类的拒绝带 retry-after，按其等待即可。

7.8 移除授权

适用场景：收回某个成员、部门或职能组的调用权限。

操作步骤

1. 在「企业内成员」表格中找到目标对象，行末选择「移除」。
2. 确认框提示「确认移除 … 的分发规则？」，选择「移除」。

你会看到

• 页面提示「分发目标已移除」，列表刷新后该行消失。
• 该对象依靠这条授权创建的 API 密钥随之失效，调用返回 401 invalid_api_key；成员侧的分组列表与密钥归属同步消失。失效通常在数十秒内完成，不是瞬时。

注意：

• 保存或移除后若列表未立即刷新，重新打开该页确认结果，不要连着重复操作。
• 移除授权不会删除该对象的历史用量与账单，也不影响他通过其他分组获得的授权。
• 该对象在这个分组上的配额与专属价配置随规则一并消失。如果只是临时停用，改用「发布」开关或把配额设为 0，比删除授权更容易恢复。
• 成员被移出部门或职能组时，经该组织获得的授权同样失效，无需逐条移除。

能力说明

---

上一章：6. 模型与模型分组 · 下一章：8. 成员使用模型