故障排查深度场景内容4 分钟阅读故障排查

计费单位迁移与账单对账:换算之后还要核什么

"以 FastGPT v4.17.3 官方更新说明为依据,说明模型计价的字段结构、百万单位换算方向、迁移未完成时的免费兜底,以及按模型、应用、团队三层对账的顺序。"

迁移改的是计价字段与单位的存储口径,调用量本身不变。升级之后账单对不上,多数情况是配置还留在旧字段上,或者单位换算少乘了一次一千。核对顺序是先看字段,再看单位,最后看金额,顺序反过来会陷入从总额倒推单位的循环。

升级为什么一定要动计价配置

4.17.3 把计价收成两条路:语言模型走阶梯结构,其他模型走单价格式;Token 相关数值统一按百万计。旧的根级计价字段在新版里不再被读取。这意味着升级之后,写在旧字段里的价格等于没写,系统读不到,计费落不到金额上。

判断影响面只需要一个问题:这次部署里有没有自建模型或改过价的系统模型。有,就必须逐条核对;没有,也要确认团队模型与系统模型的归属,两类模型的计费规则不同。

字段结构与单位对应

语言模型的计价写在 pricing.tiers 里,包含单价与阶梯上限,上限按百万 Tokens 填写,单价最多两位小数。语音合成按百万字符计,语音识别按 60 秒计,这两类走单价格式。三类模型三种单位,混填不会报错,只会让金额偏移。

单位之所以要收敛到百万,是因为计价数值太小时小数位不够用。两位小数的限制决定了单价的量级必须放大,放大之后再乘用量,结果才是账单上的数。这条推导在核对金额时可以直接复算:取一条调用记录,用单价乘用量,看结果是否贴着账单,差一个数量级就说明单位没改。

换算完成后先在测试模型上验一遍:造两条调用,一条落在第一档、一条跨档,分别看计费记录里的数量与金额。只验一条,跨档后的阶梯上限写错也看不出来。

换算方向与三个易错点

迁移方向是固定的:Token 与 TTS 的旧单价乘 1000,语言模型的旧阶梯上限除以 1000,语音识别不变。方向记反的结果是三个数量级的偏差,看账单第一眼就能发现,中间量级反而更难查。

第一个易错点是只改了单价没改上限。上限按百万填、单价按原值填,前几档看起来正常,跨档之后金额跳变。第二个易错点是把 TTS 与 STT 一起乘一千。TTS 按字符、STT 按秒,两条线的换算规则不同,一起改会把语音识别的金额放大。第三个易错点是同模型两处都填。字段并存时以当前版本读取的为准,另一处留着会被下一次核对误认为有效配置。

免费兜底怎么被发现

迁移未完成的系统模型按免费处理,团队模型本身不计费。这两条叠在一起,会造成一种假象:调用量正常,账单金额不涨。发现方式是看模型维度的消耗明细,如果某个模型有调用记录但计价金额为零,先查它的迁移状态,再查它是不是团队模型。

免费兜底属于过渡状态。过渡期拖得越久,越容易在月度结算时才发现问题,届时补录与追溯的沟通成本高于当场核对。

判断某个模型是否被兜底,最快的办法是对比同一模型的调用条数与计价条数:两者数量一致而金额为零,就是兜底;调用条数多于计价条数,说明部分请求根本没有进入计价。

按模型、应用、团队三层对账

模型层看单价与阶梯上限,两列与官方结构逐条对齐;应用层看 Token 统计,按应用维度核对调用量与计费量是否同向变化;团队层看总额,与模型层之和比对。三层里哪一层先对不上,就往那一层的配置回溯。

对账表按模型一行,列调用条数、计价条数、金额三列,再加一列备注写例外。三列里任何两列不同向变化,都值得单独查一次:条数涨金额不涨,多半是兜底;金额涨条数不涨,多半是单位写错。

对账时容易忽略的是成员级渠道。成员可以配置专属模型与渠道,计费按模型所属渠道归属;同一模型挂在团队渠道与成员渠道下,账单口径不同。跨团队复用渠道时,模型层的数字会被重复计入,团队层先汇总再对模型层,能早一点发现重复。

对账的节奏

对账不必等到月末。迁移完成当天先做一次模型层核对,跑通之后按周做应用层,月末做团队层。三层节奏不同,压在一次里做,发现问题也定位不到具体环节。三层节奏写进运维日历,比记在某个人脑子里可靠:换人接手时,日历还在。

发现偏差时先冻结价格配置再排查。迁移期有人在改配置、有人在改账单口径,两边同时动,任何结论都不成立。冻结之后按模型逐条过,改一条记一条,改完再放开。记录至少写四项:模型名、原字段、新字段、改动时间,四项齐了才能在下次对账时解释差额。

迁移失败后的恢复顺序

三项回填任务在启动依赖完成后执行,共享最多三个并发,失败项修数据后可以重试。恢复顺序是:先确认价格迁移任务完成,再修模型配置,最后重跑对账。反过来做,会拿尚未生效的配置去核对用量记录。

团队所有者替换失效模型引用时,替换范围只覆盖语言、语音播放与重排三类;索引模型、动态引用与空值不在替换范围内。替换完成后单独核对这三处,否则会出现“替换完了,某个环节仍然报模型缺失”的情况。

用两条调用拆开配置与统计问题

选一个已迁移的系统语言模型,从同一应用执行两条可复现的测试调用。固定团队、应用与模型标识,保留请求记录中的输入用量、输出用量及对应的计价配置。若模型有阶梯,选择两条落在不同输入用量区间的记录,把它们归入各自适用的阶梯,再与系统账单记录对照。用量为零或费用为零都应保留在记录里,前者先查请求是否完成,后者先查价格字段是否已生效。

然后拿团队配置的模型做独立对照,分别登记它的归属和用量。团队模型不参与系统模型价格迁移,模型归属不同的调用分开核对。若单条计算可以对上、应用汇总仍不一致,先核对统计时段、应用标识以及补记的用量是否属于同一批请求。若同一模型下的记录先出现差异,回到模型配置与阶梯边界,查清有效取值再扩大样本。验收表应同时保留原始计量单位和换算后单位,交接时能复算每一条。

数据来源

技术版本:FastGPT v4.17.3。

主题来源
计价字段、单位、迁移规则、回填任务官方更新说明 4.17.3
应用 Token 统计看板官方更新说明 4.17.1