WorkbuddyAPI 账单怎么按项目对账、把共用一个密钥的消耗拆到各个项目?
WorkbuddyAPI 账单按项目对账的关键,是在调用发生前就把项目和计费单元绑定:每个项目单独签发密钥,或在请求头、metadata 里固定带项目标识,再用账单明细和自建用量表按请求 ID 与统一时间口径双向核对。多项目共用一把密钥又没打标的,账单侧无法回溯拆分,只能靠日志重建并接受误差。
WorkbuddyAPI 的账单可以按项目对账,前提是项目维度在计费发生之前就写进了调用里——要么每个项目单独签发 API Key,要么在请求头或 metadata 里固定携带项目标识;如果多个项目共用一把密钥又没有打标,账单明细里只有某把密钥某天消耗多少,事后无法准确还原到项目,只能靠业务日志按比例分摊。这一步决定了后面是核对还是估算,两种做法的工作量差一个量级。
对账差额的大头通常不是平台算错,而是口径没对齐。对账前先把三件事写成书面约定:时间口径,即平台账单按 UTC 还是本地时间切日;计费口径,即输入与输出分别计价还是按调用次数,失败请求和流式中断是否计费;结算口径,即预充值扣减顺序、赠送金抵扣顺序、月末出账与补扣规则。三条里任何一条两端不一致,逐笔比对时就会出现成批的假差异,把真正的异常掩盖掉。
项目拆分优先选一项目一密钥。原因是密钥本身就是平台侧天然存在的计费主体,账单和用量明细按密钥聚合时不需要额外解析,导出即用;密钥轮换也天然对应项目生命周期,项目下线直接吊销,不会牵连其他调用方。代价是密钥数量变多,必须配套命名规范和归属台账,否则半年后没人说得清哪把密钥属于哪个项目、由谁负责。
代码不方便改造、或者由第三方服务商代调用而无法分密钥时,退一步用请求头或 metadata 打项目标识。前提是平台的用量明细能把这层标识透出到账单或用量接口;如果标识只落日志、不进明细,那它只能当排障线索,不能当对账依据。上线前先用一笔测试调用验证标识能否在明细里查回来,再批量铺开,这一步花十分钟,能省掉一个月的返工。具体字段名与控制台入口以官方说明为准。
两头都做不到的老系统,只能在网关或代理层注入标识。做法是自建一层统一转发,把来源系统映射成项目号,同时把自己的转发日志记全:请求 ID、项目、模型、调用时间、token 用量、状态码。这时的对账关系变成平台账单与网关日志比对,比平台账单直接对业务系统少一跳,差异定位快很多,也便于在不改动业务代码的前提下先把账对起来。
账单明细至少要取到这几类字段再谈对账:调用时间、模型名称、项目或密钥标识、输入与输出用量、单价、金额、请求状态。缺状态字段,就无法回答失败请求到底扣没扣,而这恰恰是日常差异里最常见的一类。导出时优先要原始明细而不是汇总表,汇总表做过四舍五入和跨日归并,后续无法逐笔追到具体某一笔调用,差异归因会卡在这里。
自建侧也要有一张能对得上的用量表,核心字段是请求 ID。平台明细和自建日志都有请求 ID 时,可以做一对一匹配,差异立刻收敛到具体某几笔;只能按天按项目比总额时,就只能看到差额,无法归因。所以在封装调用层或接入 SDK 时,把请求 ID、项目、模型、时间、用量落库,是后续所有对账工作的地基,越早做越省事。
常见差异可以列成一张清单逐条排除:客户端超时重试导致同一请求被计费两次;流式响应中断但已产生部分用量;批量或异步任务跨日入账,落在第二天的账单里;缓存命中部分适用不同单价;免费额度和赠送金先抵扣,导致账单金额低于用量乘以单价;月末出账与实时扣减之间存在时间差。每一条都有明确的判定方法,比笼统看总额差异高效得多,也更适合写成排查手册交给新人。
一个完整周期的操作顺序可以固定下来:月初导出上月原始明细,按项目、模型两级聚合;同时从自建库导出同口径用量;先比总金额,再比项目金额,再比单模型金额,最后落到请求 ID 级的逐笔比对;对每一笔差异标注原因分类,例如重试、跨日、免费额度、真异常;把结论写进关账记录并归档原始文件。顺序不跳步,是因为跳步会把结构性差异误判成个案,越查越偏。
项目多、调用量大的团队应把比对做成脚本或看板,而不是每月手工导表。可自动化的部分是导表、聚合、按阈值产出差异清单;不可自动化的是差异归因,仍然要人看。建议设两条告警线:单项目日消耗突增并超出日常波动区间,抓的是异常调用;单项目月度消耗接近预算阈值,抓的是预算失控。两者触发后的处置动作不同,不要合成一条告警。
适用边界要说清:一项目一密钥适合长期存在、成本需要独立核算的项目;临时实验、个人调试、一周内下线的验证项目用独立密钥反而增加管理成本,更适合挂在共享密钥下按标签统计,并明确接受这部分不做严格对账。对账精度不是越高越好,要和项目金额量级、结算对象的需求匹配,一个月消耗很小的项目不值得为它单独建一条对账流水线。