7. 配置模型服务的可用范围与配额
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
在模型服务详情的「可用范围与配额」页签中，管理员决定哪些对象可以使用该服务，并为每个对象设置周期预算和阶梯计价。页面说明：仅可用范围内的企业成员可使用该模型服务；每个对象一条规则，规则下每个周期各是一个额度池，用满即拒绝。
入口：「管理控制台 → 搭建 → 模型服务」，点击服务名称，打开「可用范围与配额」页签。
前提：租户管理员或「系统管理员」角色。金额预算和阶梯计价要求服务内的模型已设置售价（第 5 章「模型定价与分类」）。本章功能属于基础功能许可。
7.1 选择授权范围并设置有效期
可用范围的对象类型有四种：
| 对象 | 适用场景 |
|---|---|
| 所有用户 | 全员都应使用的基础服务 |
| 部门 | 部门稳定、职责清晰的场景 |
| 职能组 | 跨部门项目或专项能力 |
| 成员 | 个别成员的试点或例外授权 |
范围应从小到大逐步开放。新增高成本或高敏感模型时，先授权给试点部门、职能组或成员，效果与费用符合预期后再扩大。
操作步骤：
- 在「可用范围与配额」页签选择「编辑可用范围」，打开「可用范围」对话框。
- 在「所有用户」「职能组」「部门」之间切换，在组织架构中搜索并勾选部门或成员，或勾选职能组。右侧显示已选对象，例如“已选 2 个部门，3 位成员”。
- 选择「下一步」，进入「配置目标有效期」。默认有效期可选 7 天、30 天、自定义或长期有效，默认为长期有效；也可以开启「为选中角色分配单独有效期」，为每个对象单独设置。
- 保存。影响人数较多时，平台预览受影响的成员并要求再次确认。
结果：「企业内成员」列表列出已授权对象，列为「范围名称」「类型」「配额」「阶梯」。有效期未开始的对象显示“N 后生效”，进行中的显示“剩余 N”，到期后显示“已失效”。到期后请求被拒绝，历史授权记录保留用于审计。
移除授权：在对象行选择「移除」并确认。移除后该对象不能再使用此服务。
7.2 配额字段说明
在对象行选择「配额编辑」，打开「编辑配额」对话框，为该对象设置在本服务上的周期预算。
| 字段 | 说明 |
|---|---|
| 「启用策略」 | 停用后保留设置，但不再限制请求，额度池也停止记账 |
| 「Token 预算」：小时、天、月、累计 | 按周期限制该对象在本服务上消耗的 Token 总量，单位 B（十亿 Token），最多九位小数，例如 0.5 表示 5 亿 Token |
| 「金额预算」：小时、天、月、累计（标题后显示结算币种，例如「金额预算（人民币）」） | 按周期限制该对象在本服务上的花费，按每次调用的有效单价计算，最多六位小数 |
规则说明：
- 各周期、各预算类型可任意组合，每个已填写的上限都在请求准入时同时判断，任一用满即拒绝；
- 留空表示该周期不限制；填写
0会阻断所有匹配调用； - 启用策略时至少填写一个周期预算；
- 服务内模型都没有发布价时，金额预算不能填写；设置了金额预算后，调用未定价模型会被直接拒绝；
- 小时、天、月按 UTC 时间的自然周期重置：天从 UTC 0 点（北京时间 8 点）开始，月从每月 1 日 UTC 0 点开始；「累计」覆盖全部时间，不重置。
配额只限制当前模型服务，不是部门或成员的全部平台预算。单次请求的 Token 上限、并发数和每分钟请求数不在配额中设置，由流量规则和全局限额控制（第 15 章，需要动态路由许可）。
7.3 服务级配额
服务级配额以整个模型服务为对象，所有调用共享同一组额度池。
- 进入服务详情的「基本信息」页签，在左侧「服务级配额」中选择「编辑配额」。
- 字段与第 7.2 节相同，保存。
- 用「服务配额」开关启用或停用。尚未设置任何周期预算时打开开关，会先弹出配额对话框。
左侧同时显示各额度池的用量，例如“已用 0.12B / 限额 1B”，以及「累计 Token（全部时间）」和「累计费用（全部时间）」。
7.4 阶梯计价
模型服务可以为某个授权对象设置按累计 Token 分档的价格，用于对内结算或差异化计费。
- 在「可用范围与配额」页签的对象行选择「阶梯计价」。
- 在「网关模型」中选择模型。模型必须已有发布价，未定价时页面提示先到价格页定价。
- 设置累计周期：可选「月」，或该对象 Token 预算已使用的周期。累计方法固定为按该对象累计。
- 选择计价方式：「单价」或「Token 倍率」。倍率档的价格 = 模型发布价 × Token 倍率，只影响金额，不影响额度。
- 选择计算方式：「分段累进」按档位边界拆开计价；「全量按最终档」整笔按调用结束时所在档位计价。
- 填写档位，用量单位为“万 Token”，第 1 档从 0 起，末档不封顶，最多 32 档。保存。
结算规则：预付费按最高档冻结、按实际档位结算；修改档表后历史账单不变，已结算的调用不重新计算。对象行的「阶梯」列显示已配置阶梯的模型数量，额度池旁显示当前所在档位，例如“第 2 档 · 再用 N Token 进第 3 档”。删除阶梯在同一对话框中选择「删除阶梯」。
7.5 单个 API 密钥的额度
除授权对象的额度池外，还可以为单个 API 密钥设置独立额度。
- 进入「管理控制台 → 搭建 → 模型服务 → API 密钥管理」，打开目标 Key 的详情。
- 在「额度」区域选择「编辑配额」，字段与第 7.2 节相同。只有绑定了模型服务的 Key 可以配置。
- 保存。
这把 Key 的用量同时计入本服务和所属组织对象的额度池，任一额度池用满都会拒绝请求。未单独设置时，Key 只受服务、所属部门或职能组等共享额度池限制。
成员创建 Key 时选择的「API 密钥归属」决定这把 Key 的用量计入哪些额度池，创建结果中会列出。
7.6 配额拒绝排查
额度用尽时，网关返回 HTTP 429，错误码为 POOL_EXHAUSTED，错误信息说明是哪个对象、哪个周期、哪种预算用尽，以及何时恢复，例如“部门研发部的今日Token额度已用尽，08:00 后恢复。”。错误详情中的 scope_kind、period、budget、used、limit、window_end 可供业务系统程序化判断。
排查顺序：
- 根据错误信息定位对象（服务、部门、职能组、个人或这把 Key）和周期；
- 在「可用范围与配额」页签核对该对象的额度池用量，或在 Key 详情的「额度」区域核对；
- 需要放宽时调整对应周期的上限；
- 错误码为
TRAFFIC_RATE_LIMITED、TRAFFIC_CONCURRENCY_LIMITED或TRAFFIC_CIRCUIT_OPEN时，拒绝来自流量保护，检查第 15 章的流量规则和全局限额。