Toonflow 主账号统一充值、多个子账号共用额度时,API 用量要怎样按子账号拆分统计?

可靠做法是让一个子账号绑定一把独立密钥,在请求侧写入子账号标识,服务端日志按密钥维度归集 token 与调用次数,再按请求 ID 去重后与平台账单按月对账。若多个子账号共用主账号的同一把密钥,请求侧没有归属信息,事后无法从账单反推,拆分结果只能是估算。

Toonflow 主子账号的 API 用量拆分,靠的不是把主账号月度总量按人头平均,而是给每个子账号发一把独立密钥,让每笔请求在产生时就带上归属信息,再由日志按密钥维度归集、按请求 ID 去重,最后与平台账单对账。这套方法适用于主账号统一充值、多个子账号共享额度、需要按部门或项目分摊成本的团队;如果子账号直接共用主账号的同一把密钥,请求侧没有任何归属标记,事后无法从账单反推,任何拆分数字都只是估算。 拆分统计的本质是归属,不是除法。把主账号一个月的总消耗除以子账号数量,看起来得到了人均用量,但模型倍率、输入输出比例、是否走流式、是否命中缓存,在不同子账号之间差异很大,平均值既不能用于成本分摊,也不能用于限流决策。真正可用的拆分口径必须满足两点:每笔消耗能追溯到唯一责任主体,每个主体的消耗能被独立复核。 一子账号一密钥是整套方法的前提。密钥是请求进入平台时最稳定、最不容易被伪造的归属载体,比让调用方在业务代码里自报身份更可靠。落地时给每把密钥起可解析的名字,例如部门加用途加环境,并把密钥 ID 与子账号 ID 的映射关系固化在一张配置表里,后续所有归集、对账、告警都围绕这张表展开,换人换项目时只改映射不改代码。 请求侧要显式打标,防止密钥复用把归属冲掉。现实中常见的情况是子账号为了省事互相借密钥,或者一个项目组共用一把密钥跑多个业务线,这时密钥维度就退化成项目维度。解决办法是在请求头或元数据里携带子账号标识与业务标签,服务端日志同时记录密钥 ID 和这个自报标识,两者不一致时以密钥归属为准并触发告警,长期不一致说明该拆分的密钥没有拆干净。 日志的最小字段集决定了拆分能不能做成。至少要有请求时间戳、请求 ID、密钥 ID、子账号 ID、模型名、输入 token 数、输出 token 数、请求状态码、是否重试、是否命中缓存。少了请求 ID,重试和超时重发就会重复计量;少了状态码,失败请求是否计费无从判断;少了缓存标记,把未计费的命中量算进分摊,账目就会虚高。字段在接入层一次打全,比事后从业务库里拼凑便宜得多。 去重环节最容易出错,也最容易被忽略。客户端超时重发、网关自动重试、流式中断后重新发起,都会让同一次业务意图产生多条计费记录。处理方式是以请求 ID 作为幂等键,同 ID 只保留一条有效记录,重试产生的多条按最终成功那条计费,其余标记为冗余但不删除,保留审计线索。不做这一步,拆分出来的子账号用量会系统性偏高,且偏差随网络质量波动。 计费口径要先统一,再谈拆分。Toonflow 这类平台通常按 token 计费,输入与输出单价可能不同,不同模型之间还有倍率差异,图像与视频类任务则可能按次或按生成时长计量。拆分表里如果只写一个总金额,子账号负责人无法判断钱花在哪里。建议主表给金额,附表给模型维度和输入输出维度的明细,让每个子账号看到自己的消耗结构,而不只是一个总数。 免费额度、赠送余额与缓存命中不计费的部分,不能混进分摊。新账号测试金、活动赠送额度、命中缓存的请求,在账面上不产生实际支出,如果按调用次数平摊,等于让用得多的子账号替别人买单。正确做法是把计费消耗与免费消耗分成两列,分摊只基于计费消耗,免费部分单独统计用于容量规划。具体额度规则以平台官方说明为准。 对账是把方法从可用变成可信的关键一步。团队内部至少要维护三个数:接入层日志汇总、平台账单、财务分摊表。三者在月度总额上应当收敛,差异通常来自时间窗口不对齐、跨零点请求归属错位、月末延迟落库以及汇率或税率处理。把差异项列成固定检查表,每月按同一顺序核对,比每次重新排查快得多,也能及早发现密钥泄漏这类异常消耗。 权限设计要和拆分口径一起定,否则统计做出来也不能给人看。子账号默认只应看到自己的用量明细和限额,主账号看全量并保留导出能力,跨子账号的对比视图只对管理角色开放。日志与密钥映射表要设定留存周期,密钥按固定周期轮换,轮换时在映射表里保留历史密钥与子账号的对应关系,避免旧数据失去归属。 落地顺序建议固定为四步:先定归属键,再拆密钥,再补日志字段,最后做去重与对账。顺序颠倒会返工,例如先做报表再补字段,历史数据无法回溯;先拆密钥再定归属键,映射关系会反复调整。这套流程不依赖特定平台的报表能力,平台提供成员级用量导出时可以直接取数校验,没有提供时也能靠接入层日志独立成账。 最后要接受一个边界:拆分统计解决的是内部成本归属,不改变平台侧的计费结果。子账号之间的额度调剂、超额拦截、按项目重新分摊,都属于内部管理动作,需要在接入层做限流和配额控制,而不是指望账单自动完成。把归属、去重、口径、对账四件事做扎实,主账号下的每一分消耗都能说清是谁花的、花在哪个模型上、为什么花。