SubLaneSubLane

用量分配

在工作空间内设置按比例、金额或 Token 的成员用量限制。

用量分配是可选功能。如果只是让成员使用订阅账号,在成员管理中授权资源组即可。需要为成员设置用量上限时,再为专用资源组添加用量分配。

在哪里设置

先在左侧栏顶部选择工作空间,再进入管理 → 用量分配 → 添加用量分配。表单里可选 按比例、按金额、按 Token、按时间窗口 四种方式。

如果「添加用量分配」按钮不可用,请先确认当前空间有已启用、包含订阅账号、尚未设置用量分配的资源组。保存前,池内账号不能同时属于本空间的其他池。

按 Token 分配的表单示例(合成成员和额度):

用量分配表单,已选择资源组、按 Token 和成员额度

先准备资源组和成员

  1. 在「订阅账号」接入并验证一个账号。
  2. 在「资源组」创建已启用的资源组,把该账号加入池中。需要额度时,应先把池内账号从本空间其他池移除。
  3. 在「成员管理」为需要使用该池的普通成员授予「资源组权限」。所有者和管理员可直接使用已启用的资源组。只有能使用该池的人才能分到额度。

新接入账号默认未分配到池;新成员也不会自动获得资源组权限。这几步都要在同一个当前工作空间中完成。

选择分配方式

表单选项适合什么情况怎么计量何时重置
按比例把设定的总预算按成员百分比分配可选择内部金额总量或 Token 总量,按所选单位计量每日/每月日历周期,或各自独立的时长窗口
按金额给每人设置内部 USD 额度根据保存的模型价格计算输入、缓存输入和输出用量按实例时区选择每日时分或每月日期及时分
按 Token设置明确的 Token 上限输入加输出 Token;缓存输入不重复计入按实例时区选择每日时分或每月日期及时分
按时间窗口动态添加多项内部 USD 上限,可按成员覆盖统一值每位成员独立记账;同一条计价请求同时计入全部已配置窗口从生效时起,各窗口按自身时长重置

「按比例」下面可选「按 Token 比例」或「按金额比例」:前者累计上报的输入加输出 Token,缓存输入不重复计算;后者依据保存的模型价格折算内部 USD。选择日历总预算,或为最多八个时长窗口分别填写总预算,再设置共同的成员百分比。总预算不是订阅账号的真实 Token 容量或上游现金余额,上游额度也可能先耗尽。Token 总量以 M 填写,1 M 等于 100 万 Token。

创建并使用

  1. 点击「添加用量分配」,填写分配名称并选择专用资源组。
  2. 选择一种方式。「按比例」下再选择 Token 或金额依据,填写日历总预算,或各时长窗口的总预算及共同成员百分比;比例预算必须为正,不使用留空不限量;「按时间窗口」可添加最多八项条件,每项填写整数小时/天数及统一内部 USD 上限,再选择参与成员,需要时覆盖某位成员的具体条件。某项金额留空表示该条件不限量;其他方式填写一个固定上限。成员区各方式都支持「全选成员」;按比例还可点击「平均分配」,比例合计不得超过 100%。
  3. 「按金额」、「按金额比例」或「按时间窗口」的模型价格会在保存时从资源组支持的模型自动回填并固定到规则版本。缺少当前目录价格的模型如有历史价格会沿用旧价;否则其请求暂时无法通过此分配。管理员可看到当前的价格覆盖提示。只有完全没有可用价格时才无法保存。每日/每月方式还需设置重置时分或日期及时分。
  4. 选择生效时间并保存;延迟生效须核对服务端时刻并点击「确认生效时间」。管理员在用量分配中点击「查看用量」;成员在自己的「用量」页面查看余额。
  5. 保存时,会将方案内成员在此资源组中已有且未撤销的密钥自动关联到本方案,密钥值、暂停/过期状态及客户端配置保持不变。未加入方案的成员,其已有密钥将无法继续使用此资源组。没有密钥的成员再创建新密钥。历史上未关联方案的旧密钥,在具备权限时可通过「恢复使用」重新关联;也可通过「更换资源组」切换到当前工作空间内本人有权使用的其他资源组。计划下周期生效的方案仍需等到生效后才能使用。

一个资源组只能设置一条用量分配。保存后,即使暂停,也不能随意更改池内账号。暂停用量分配会阻止后续请求,不会把专用池变回自由使用。「调整当前成员」可即时修改份额/上限并保留用量,但必须满足剩余共享预算。预算/价格编辑保留排期和窗口边界,更改单位/分配类型/周期须确认新的计量周期;授权或暂停的变化影响后续请求。编辑表单会在保存前显示按当前周期计算的预计生效时间;当前最长窗口很长时,调整可能延迟接近整个窗口时长,最多 365 天。已开始的请求可能超过当时显示的剩余额度。

首次生效前,可在已保存初始规则的完整编辑器中修正成员和个人上限,保留已确认的生效时间及计量锚点。对于已排期的结构替换,再次勾选新周期确认即可编辑目标成员;普通预算/价格编辑可以不勾选,保留原计划。

比例计算与人工修正的细节见计量与结算参考。

分配额度阈值提醒

工作空间 Webhook 启用后,成员已结算用量达到分配额度的 80% 和 95% 时也会提醒。沿用账务模块的当前窗口、份额额度和成员覆盖值;跳过不限额、已暂停或无访问权限的分配,不把待结算暴露量当作已结算用量。

每个阈值在同一计量周期仅触发一次,成员/价格编辑不重新触发;重启后保留去重状态,下周期重新启用。新增 allowance_low 事件的 subject 包含有界本地标识,cycle 是基于原始锚点版本及重置时刻的标记。观察失败不会误报恢复,每个工作空间最多观察 4,096 个阈值命中。通知发送到管理员 Webhook,不直接发成员邮件,也不改变准入或计费。