用量分配计量与结算
比例预算、固定上限、重置周期与待处理用量。
首次配置请看用量分配。一条规则属于一个工作空间内的专用账号池;规则存在期间,池内账号保持固定。普通成员需要账号池直授,并创建绑定该规则的个人 Key。普通 Key 不会自动转换;同一成员绑定该规则的多把 Key 共用账本。
按总预算比例分配
选择「按比例」时,需要填写一个总预算、每日或每月重置周期,以及合计不超过 100% 的成员百分比。可选择两种计量依据:
- **按 Token 比例:**总量以 M Token 填写。请求上报的输入加输出 Token 计入成员份额;缓存输入已包含在输入中,不重复计算。
- **按金额比例:**总量为内部 USD。请求的输入、缓存输入和输出按规则版本保存的模型价格折算。这些价格不代表供应商对订阅的实际扣量规则。
成员上限等于总预算乘以所填百分比,并向下取整到最小计量单位。例如,100 万 Token 总预算的 25% 是 25 万 Token。未分配的比例和取整余量不会自动分给其他成员。同一规则的账号池共用一套成员账本,不按订阅账号分别重置。
这些都是内部预算:填写的 Token 总量不是订阅账号的真实容量,内部 USD 也不是现金余额或账单。SubLane 仍检查上游额度;上游可能先于内部预算耗尽。
按时间窗口分配金额限额
「按时间窗口」是独立的分配类型。最多添加八项条件,每项使用整数小时/天数(1 小时到 365 天)和内部 USD 统一上限。选择成员后,成员各自记账,也可按某项条件单独覆盖。某项金额留空表示该条件不限量;不限量条件仍记录用量,但不施加额度或风险暂占限制。每条已结算请求只计价一次,同时计入所有已配置窗口。任一已设置上限的条件耗尽或风险暂占达到边界,就暂缓新请求。
所有窗口从规则生效时开始,分别按自身实际时长重置。它们是内部窗口,不随池内各订阅账号的上游重置时间变化;实例时区只影响重置时刻的显示,不改变窗口时长。修改生效中规则的条件,会在当前最长窗口的下一边界生效,并重新开始各条件。因此,30 天窗口可能使调整延迟接近 30 天;保存前表单会显示按当前周期计算的预计生效时间。暂停访问仍会立即生效。
金额类分配(「按金额」「按金额比例」「按时间窗口」)保存规则版本时,会读取专用账号池支持的模型并自动回填目录价格。手动提交的价格不能覆盖此快照。若某模型缺少当前目录价格,优先沿用规则中已有的价格;新发现且完全无价的模型不会进入快照,其请求在有价格的新版本生效前无法使用此分配。价格覆盖提示在读取规则时根据当前状态计算,不写入不可变版本:目录补价后「目录缺价」提示会自动消失,但尚未进入规则价格快照的模型仍会提示管理员重新保存规则。账号模型目录暂不可用时,会保留已有价格并提示,恢复发现后提示消失。只有完全没有可用价格时才无法保存;若既未加载价格目录、也无已保存的价格缓存,新建金额类规则无法完成,请先刷新目录或提供价格后备文件。
对尚未进入规则价格快照的模型,管理员提示会显示现在保存预计何时生效。按时间窗口分配时,该日期取决于当前最长窗口;反复保存不会让新价格立即可用。对于已经保存的待生效版本,提示会改用该版本自己的生效日期,并说明如果不在生效前保存修正版本,模型在它生效后仍会被拒绝。
固定上限与待处理用量
「按 Token」直接设置成员 Token 上限;「按金额」直接设置内部 USD 上限。计量方法分别与对应的比例依据相同。
已完成且用量明确的请求会直接扣账,不需要等待上游额度百分比更新。已发送给上游但缺少可信 Token 总数的请求仍保留为待处理,供管理员修正。已观察到的部分 Token 数量仍可查看,但待确认记录在核实前既不计入已用额度,也不暂占额度。系统在每个已设置上限的当前窗口,为每条进行中的请求暂按该窗口成员上限的 10%(至少一个最小计量单位)预留风险余量。最多允许四条请求同时进行;下一条请求所需的暂占量超过放行余量时也会暂缓放行。请求结束即释放暂占,暂占不是实际扣账。放行检查只针对新请求,不会中途打断已放行的流;这些保护无需额外配置。窗口之外的待处理记录仍可修正;同一记录仍可能出现在另一项已配置窗口。管理员列表优先显示最新的 256 条待处理记录,修正较新记录后可继续查看更早记录。单次大请求仍可能超过成员上限,因此这是软上限,无法保证绝对不超额。
对于 Codex 流,客户端断开后 SubLane 最多再读取上游 3 秒,以获取可信的最终用量。若失败终结事件仍提供完整用量,也可据此扣账。连续上游失败会使对应账号暂时冷却;正常结束但缺少最终用量的请求仅保留为待处理,不会使账号冷却。若记账写入暂时失败,SubLane 会重试该请求的结算;受影响成员的新额度请求须待结算恢复,其他成员可继续使用。
每日/每月规则按实例时区设置重置时分,或每月重置的日期及时分。若当月没有指定日期,则在当月最后一天重置。默认每日 00:00 或每月 1 日 00:00。修改百分比、总预算、固定上限、价格、计量方式或重置时间会在现行重置周期的下一边界生效。暂停规则或撤销账号池权限立即阻止后续请求和 WebSocket 回合,但不会清除已记录用量或待处理条目。
新建时间窗口规则时若选择「从下个周期开始」,则在最长条件的时长过后生效。
查看余额与修正
成员在「用量」查看自己的余额;工作空间管理员在「用量分配 → 查看用量」查看整条规则。所有已配置时间窗口归在同一成员下,分别显示上限、已用、剩余、风险暂占和重置时刻;成员状态取限制最严格的条件。金额余额显示内部 USD 和上报 Token;Token 余额使用 M,1 M = 100 万 Token。个人报告不暴露订阅账号身份。
余额把已用(已结算用量)与本周期的进行中、待确认用量分开显示。临时暂占量只来自进行中的请求;待确认记录继续显示以便修正,不计入已用额度,也不会占用放行余量。放行余量包含自动风险缓冲,不是额外可消费额度。因此,即使实际剩余为正,当下一次请求所需暂占量超过放行余量,或已有四条请求进行中时,也会显示「新请求暂缓」。状态与网关使用同一套本周期风险判断;请求结束后,状态会随下一次刷新变化。当前周期之外的待处理记录仍可修正,也不会暂停本周期放行。
待处理条目无法自动解决时,管理员可依据可信证据填写输入、输出和缓存输入 Token 总数。修正沿用请求保存的计量规则,并写入审计记录。不要把缺失用量当成零,也不要填写猜测的数量。
工作空间管理员通过 /api/allocations 管理规则;成员通过 /api/me/allocations 查看个人余额。Key 创建时用 scheme_id 绑定规则。另见工作空间和个人 API Key。