SubLaneSubLane

用量分配计量与结算

比例预算、固定上限、重置周期与待处理用量。

首次配置请看用量分配。一条规则属于一个工作空间内的专用资源组;规则存在期间,池内账号保持固定。普通成员需要资源组直授,并创建绑定该规则的个人 Key。普通 Key 不会自动转换;同一成员绑定该规则的多把 Key 共用账本。

按总预算比例分配

选择「按比例」时,可使用每日/每月总预算,也可添加最多八个时长窗口,为每个窗口分别填写总预算。合计不超过 100% 的成员百分比应用于各窗口。可选择两种计量依据:

  • **按 Token 比例:**总量以 M Token 填写。请求上报的输入加输出 Token 计入成员份额;缓存输入已包含在输入中,不重复计算。
  • **按金额比例:**总量为内部 USD。请求的输入、缓存输入和输出按规则版本保存的模型价格折算。这些价格不代表供应商对订阅的实际扣量规则。

成员在每个窗口的上限等于该窗口总预算乘以百分比,向下取整到最小单位;正份额取整为零时拒绝保存。例如,100 万 Token 的 25% 是 25 万 Token。未分配份额不会自动借给其他成员。放行同时检查成员和资源组总预算,包含已离开成员的消费;同一资源组共用账本,不按订阅账号重置。

这些都是内部预算:填写的 Token 总量不是订阅账号的真实容量,内部 USD 也不是现金余额或账单。SubLane 仍检查上游额度;上游可能先于内部预算耗尽。

按时间窗口分配金额限额

「按时间窗口」是独立的分配类型。最多添加八项条件,每项使用整数小时/天数(1 小时到 365 天)和内部 USD 统一上限。选择成员后,成员各自记账,也可按某项条件单独覆盖。某项金额留空表示该条件不限量;不限量条件仍记录用量,但不施加额度或风险暂占限制。每条已结算请求只计价一次,同时计入所有已配置窗口。任一已设置上限的条件耗尽或风险暂占达到边界,就暂缓新请求。

时长窗口从生效时起独立重置;5 小时重置不会清除周用量。这些是固定周期窗口,不是滚动回看限额,也不跟随上游订阅重置。实例时区只影响时刻显示。

成员调整与排期

选择「调整当前成员」可即时调整份额或成员上限,保留已用量和已发起请求的暂占。增加额度必须符合所有当前共享窗口的资金校验,移除后重新加入不会清空用量。例如总预算 100、A 已用 40,此时给 A/B/C 各 33 需要 106,会被拒绝;40/30/30 可以成立。重置后也须重新校验所有窗口,不能用普通排期绕过缺口。

总预算、窗口默认上限和价格仍在已保存的排期时间,或当前计划的下一边界生效;多窗口使用当前最长时长的下一边界。普通修改保留各窗口边界和已用量,不会重新发放整份预算。短窗口可能正在周期中途,新上限低于已用量时会暂停后续请求;价格更新不重算旧请求。

普通预算/价格编辑原样保留已保存的成员段,即使某位成员已不在当前有权限的成员列表中。保留配置不会恢复资源组访问权限;新增成员和新的结构替换仍须校验当前权限。

如果排期存在独立的成员计划,即时调整会发生冲突,需要明确修改或取消该指令,不能自动覆盖。其他兼容的价格/预算排期会保留。后台刷新不会给未保存的旧草稿附上新版本号;遇到冲突后使用「刷新并核对」。

更改计量单位、分配类型或重置计划,需要明确确认结构替换。它保留规则、资源组和 Key 的 ID,并在排期生效时使用声明的新计量锚点。仅改价格或成员不能借确认标记获得新周期。

「顺延至下个边界」只移动到已存生效时间之后严格的下一个自然边界,按当前计划计算;首次生效前使用初始排期的计划。核对服务端返回的时刻后确认;条件过期或变化返回冲突,不会自动顺延。

「取消排期变更」必须已有当前有效版本。只有首次排期时不能取消,可暂停或改期;初始改期在同一事务中替换完整版本。暂停不取消或推迟生效,也不删除可读配置;即使初始版本随后生效,暂停状态仍阻止网关使用。

首次生效前,初始成员配置可通过完整编辑器(PATCH /api/allocations/{id})修正。须提交已核对的版本对和生效时间,保留原排期及计量锚点,并重新校验目标成员的资源组权限。此修正仅适用于没有当前版本、也没有已记录请求的初始排期。版本、元数据及审计在同一事务内提交,失败或跨过生效时刻全部回滚;初始排期仍不能取消。

当已批准的下一版本相对当前版本确有结构差异时,即使草稿沿用下一版本的结构,界面也会提供既有的新周期确认入口。再次确认后可修改该排期的目标成员。普通预算/价格编辑不必重新确认,仍保留原成员与锚点;取消这项可选确认会恢复显示并提交已保存的成员方案。服务端仍要求替换目标相对当前版本存在真实结构差异。

金额类分配(「按金额」「按金额比例」「按时间窗口」)保存规则版本时,会读取专用资源组支持的模型并自动回填目录价格。手动提交的价格不能覆盖此快照。若某模型缺少当前目录价格,优先沿用规则中已有的价格;新发现且完全无价的模型不会进入快照,其请求在有价格的新版本生效前无法使用此分配。价格覆盖提示在读取规则时根据当前状态计算,不写入不可变版本:目录补价后「目录缺价」提示会自动消失,但尚未进入规则价格快照的模型仍会提示管理员重新保存规则。账号模型目录暂不可用时,会保留已有价格并提示,恢复发现后提示消失。只有完全没有可用价格时才无法保存;若既未加载价格目录、也无已保存的价格缓存,新建金额类规则无法完成,请先刷新目录或提供价格后备文件。

对尚未进入规则价格快照的模型,管理员提示会显示现在保存预计何时生效。按时间窗口分配时,该日期取决于当前最长窗口;反复保存不会让新价格立即可用。对于已经保存的待生效版本,提示会改用该版本自己的生效日期,并说明如果不在生效前保存修正版本,模型在它生效后仍会被拒绝。

固定上限与待处理用量

「按 Token」直接设置成员 Token 上限;「按金额」直接设置内部 USD 上限。计量方法分别与对应的比例依据相同。

可信最终用量直接结算,不等待上游百分比。缺少最终用量的请求保留待处理,部分计数可见但不扣账、不继续占额。进行中的请求按准入时捕获的成员上限,在每个有限窗口预留 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。

API 写入条件

读取保持原响应结构,并增加 write_conditions,提供可为空的 expected_current_revision_id 和 expected_next_revision_id。修改已有规则必须同时提供两者,包含完整 PATCH、成员更新、取消/改期和结构替换。缺失或过期返回 409,不自动覆盖。不要获取新 ID 后自动重放旧草稿;需要重新核对。显式启停和按请求 ID 修正待处理用量仍使用各自的原有契约。

未来版本写入还要求服务端确认的 UTC 秒时间戳 expected_effective_at;结构替换另需 confirm_replacement=true。POST /api/allocations/{id}/preview 的 action 可为 schedule、reschedule 或 replace;成员更新使用 POST /api/allocations/{id}/members,排期操作使用 POST /api/allocations/{id}/cancel、POST /api/allocations/{id}/reschedule。完整保存不能修改启停状态,请单独使用 POST /api/allocations/{id}/enabled。

首次创建不带时间条件时保留旧的即时/延迟行为;主动携带时必须选择 start_next=true。日历条件须匹配下一边界,时长条件须仍在未来且距离服务端当前时间不超过最长时长。显式 null 是缺少条件的冲突,非法格式返回 400,过期/变化返回 409。POST /api/allocations/preview 提供初始服务端时刻但不创建规则;确认失败不会回退为无条件创建。