Toonflow 主子账号的 API 用量怎么拆分统计到每个子账号?

在 Toonflow 里拆分子账号 API 用量,靠的是入口标识、请求级明细、周期聚合三层:每个子账号一把独立 Key,或共享 Key 时在网关注入子账号标识,明细里存 request_id、模型与单价快照。共享 Key 且没有任何标识的调用,只能整体归到主账号,事后无法准确回推。

Toonflow 主子账号拆分 API 用量,可行的做法是三层:入口按子账号打标、请求级明细落库、周期聚合成账单,三层缺一层就只能给出估算值。这套方法适用于已有统一调用入口或调用日志的场景;如果所有子账号共用同一把 Key,请求里又不带任何身份信息,那么事后无法准确回推归属,只能按约定比例分摊。 最稳的归属键是每个子账号一把独立 API Key,并且 Key 与子账号 ID 在账号表里保持一对一映射。请求进入网关的第一跳就能确定归属,不依赖模型参数、不依赖客户端自报身份,统计链路最短、争议最少。Key 一旦共享,日志里只剩主账号身份,后续任何拆分都变成分摊而不是计量。 必须共享 Key 时,用请求头或请求体 metadata 透传子账号标识,并在网关侧校验标识与 Key 白名单的匹配关系。校验放在网关而不是客户端,是因为客户端传值可被伪造,伪造成功就能消耗别人的额度。更稳妥的做法是由服务端签发短期调用凭证,凭证里内置子账号 ID,用完即失效。 统计口径要和计费口径对齐:只有上游正常返回 usage 的请求才计入计费用量,失败与被拦截的请求单独记一类。网关如果自动重试,一次业务调用可能在上游留下多条记录,按条累加会虚高。解决办法是给每个业务请求分配 request_id,重试共享同一 request_id,聚合时按 request_id 去重并取最终成功的那条。 用量字段至少拆成输入、输出、缓存命中三类,并在每条明细里存模型标识和当时的单价快照。不同模型的计费倍率不同,同一个子账号跑两类模型,混在一起统计就失去了成本分析的意义。更关键的是调价之后历史账单不能重算,聚合时应当用明细里的快照价,而不是回头去查当前的价目表。 时间口径要在开工前定死:日志时间统一按 UTC 存,账期按业务所在时区切,两件事分开处理。只做其中一件,跨月调用的归属就会整体漂移一天,月底对账时出现无法解释的差额。聚合任务按账期分区重跑是可以接受的,但每次重跑要写版本号,保证同一账期有唯一有效版本。 流式请求按流结束时上游返回的 usage 记账,中途断开的请求记为未完成,不并入计费用量,但必须单独计数。中断的流可能已经产生部分输出,上游是否计费取决于其自身策略,这部分差异只能放到对账环节处理。把未完成请求混进计费用量,会让子账号看到的数字高于实际扣费,引发不必要的申诉。 用量查询不要直接扫全量请求明细,要用明细表加日、月两级聚合表的结构。明细表负责可追溯,聚合表负责出数和看板,子账号查自己的日用量走聚合表,主账号看汇总也走聚合表。聚合任务本身要幂等,用子账号 ID、模型 ID、账期日期组成唯一键,重复执行覆盖写而不是追加。 网关侧统计与上游账单之间一定存在差额,差额要按可解释项分类,而不是直接按比例抹平。常见类别包括自动重试造成的重复、缓存命中判定不一致、赠送额度抵扣、以及退款或补偿。分类之后,能解释的部分在明细里标注,不能解释的部分再走人工核对,比例分摊只能作为最后手段并且要在报表里注明。 子账号被删除或 Key 轮换后,历史用量必须保留快照,不能跟着账号一起软删。月度账单、预算复盘和审计都需要把三个月前的用量对应回当时的组织归属,账号一删数据就断链。做法是明细表只增不改,账号表用软删或版本化,报表按 ID 关联历史快照而不是关联当前账号状态。 权限上子账号只能看自己的明细,主账号看汇总和全部明细,导出行为要单独留日志。没有隔离时,子账号可以从用量波动反推兄弟团队的调用节奏和模型选型,这在多租户或外包协作场景里是实打实的信息泄露。隔离做在查询层,比做在前端隐藏入口更可靠。 落地时用五件事做自查:每个子账号一把独立 Key;每个业务请求一个 request_id 且重试复用;明细里存模型标识与单价快照;日志按 UTC 存、账期按时区切;明细只增不改、账号软删。五项都做到,主子账号的用量拆分基本可以作为结算依据;缺项越多,数字越接近参考值而不是账实相符的结果。