因为专注所以专业
助力成长与创新,汇集前沿AI开发观点

客户年初按旧价预充了一整年的API额度,上游中途调价,2026年这笔账该按充值日算还是按调用日算?

2026年11月16日 阅读:22

结论先说:2026年做AI API聚合、网关或分销,客户年初按旧价预充了一整年额度、上游中途调价后再来问按哪天算,较稳的处理是两条线分开走——已经发生的调用,按调用时点生效的价目表版本结算;还没消费的余额怎么折,回到充值当时的合同计价口径去解释。想做到分段结,前提是账本里存着单价版本这一层;存不住,就只能协商一次性折让,或者把差额放到下个账期抵扣。

把这句话拆开,其实是在回答两个不同的问题:已消费部分是「历史事实怎么记」,未消费部分是「合同怎么解释」。混在一起谈,客户和你都容易越说越乱。

一、为什么「充值日还是调用日」在分销里特别容易吵

Token差价生意的毛利,来自上游成本与下游售价之间的价差。GPT、Claude、Gemini、通义、DeepSeek这些模型族调价节奏各不一样,一年里出现一两次价格变动属于常见情况。客户预充进去的是钱,拿到手的是额度,中间隔着单价这一层;单价一变,「我年初充的这笔钱现在还值多少额度」就从技术问题变成了合同解释问题。

更麻烦的是三套账的坐标系对不齐:上游按token计费,输入、输出、缓存命中、批处理往往不同价;网关按请求记账;分销商按套餐或额度包卖给客户。三套账各算各的,客户看到的「还剩多少」和上游看到的「用了多少」就不在一个维度上,谁都能拿出对自己有利的那本。

  • 客户看余额、上游看token,中间少了单价版本这一层,争议最后只能靠人拍板。
  • 同一模型族的输入价、输出价、缓存价倍数不同,谈时点口径前必须先说清按哪一个算。
  • 多模态请求按张、秒、次计价,和文本token不能直接折算,混在一起重算很容易对不上。

二、四层计量链:时点口径到底落在哪一层

与其等争议发生后再回头翻账,不如在上线时就把计量拆成四层,这里把它叫作四层计量链:能力层 → 业务层 → 载体 → 数据与风控。这样分层的理由很直接——调价只应该改业务层的价目表,不该动能力层的调用方式,更不该让载体上显示的余额自己跳变。每层各有一个容易漏的点:

  1. 能力层(模型与多模态路由):记录模型族、模态类型、上下文档位、是否命中缓存;把「模型别名」和「上游真实模型」分开存,否则上游改名后历史账对不上。
  2. 业务层(计价与套餐):价目表要版本化,标清计价单元(千token、次、秒、张)、折扣比例、生效时间点;不能只留「当前生效」一行,历史版本必须查得到。
  3. 载体(控制台、小程序、APP、H5):客户看到的余额、明细、发票口径来自同一份账本;载体上不做二次换算,换算统一放业务层。
  4. 数据与风控(用量账本与对账):每条请求落请求ID、单价版本、扣费单元、结束原因、时间窗。缺了单价版本,事后任何按日切分的算法都只能靠估。

四层里常被省掉的是第四层。省的时候没感觉,等客户拿截图来问「为什么这一笔比上个月扣得多」,才发现能给的只有一个总数。

三、交付现场:一次调价,两个人补了两三周台账

约束条件比较典型:小团队自研网关,上线时为省表只存了每请求的扣费金额和总量,没存单价版本;甲方是做分销的运营方,预充客户几十家,年度预充金额在几万到几十万区间,账期按月结。2026年某个常用模型族调价后,一家年初预充的客户按官方页面截图要求把剩余余额按新价折算,另外几家很快跟着问同样的问题。

做法上没有当场答应补差,而是按请求ID拉一段区间做核对:能带出单价版本的记录按生效点分段结,带不出的只能按当月加权均价估算,并把这部分单列成一张对账附件。结果是重算前后差出一段谁也说不清的部分,甲方不接受一次性折让,最后补签一份价格变更条款,约定生效点之前按旧价、之后按新价。代价是经验上两个人前后补了两到三周的数据核对与口径解释,明显高于当初多建一张价目表版本表的投入。

四、三种时点口径的可核对对比

同样是「按哪天算」,落地路径有三种,差别不在诚意,在于你的账本支撑得起哪一种。选之前先确认一件事:历史账单能不能按请求拉出单价版本。能,就走分段;不能,就只能协商折让或放到下期抵扣。

  • 口径A 全按充值日锁价——已消费与未消费都按充值时的价目表算完。适合上线时间短、请求量在几十万级的项目,核对工作量经验区间3–10人日;代价是上游若持续降价,锁价期越长毛利被压缩得越多,压多少随模型族与折扣差异较大,常见区间是个位数到十几个百分点,需按自家价目表实测。
  • 口径B 按调用时点分段——生效点之前按旧价、之后按新价,差额只落在已充未消费的余额上,折算成额度或抵扣金并标清有效期。多数分销场景适用;要求价目表带生效时间点,解释成本相对低。
  • 口径C 折扣实时跟随——合同直接写「上游实时价×折扣」,价格天然跟着上游走,不存在时点争议。适合调用量稳定、客户能接受单价浮动的场景;代价是账单单价会波动,客服解释量一般比锁价模式高一些。

三种不是互斥的:常见做法是对新签客户走C、对存量预充客户走B,把A只留给金额小、账期短的个案。

五、适用与不适用边界

适合按调用时点分段处理的情况:客户是预充制、调用量中等、合同写明价格可随上游调整,且网关能按请求追溯到单价版本。这类项目把价目表版本与生效时间点做进后台,比事后逐个解释省力得多。

边界也要写清:如果合同是固定锁价、有效期明确,客户要求按降价重算就缺少合同依据,通常不必补;反过来,你卖的是「上游价×折扣」时,上游涨价也很难单方面让客户接受,得看调价与通知条款怎么约定。一句可摘的边界——按充值日还是按调用日,取决于合同计价口径与账本留痕,不取决于客户情绪,也不取决于上游降了多少。

还有一类不必上这套机制:单一客户、单一模型、调用量很小的内部工具(经验上每月几百次以内),按月结或包月更省事,硬做价目表版本化只是给自己加负担。

常见问题

客户预充后上游降价,按调用时点分段是不是等于全额补差?

不等同。分段只影响生效点之后的调用和已充未消费的余额,之前的调用仍按当时单价结清,差额范围通常比全额重算小不少。

价目表要不要在账单上给客户看版本号和生效时间?

建议标出来。客户能对上「什么时候开始按哪个价扣的」,多数争议在解释阶段就结束了,也顺手留下了通知记录。

上游涨价时,能不能对已经预充的客户直接执行新价?

看合同。写「随上游调整」的可以按约定生效点执行,写锁价的通常要等期满;提前通知期实践里常见15–30天,以条款为准。

网关要不要为价目表变更做告警?

要。改动后自动比对上一版本并通知受影响客户,比事后逐个解释便宜,也留下了通知证据链,便于对账时回查。


如果你正在做 2026 年的 API 聚合或分销项目,可以先做三件小事:翻一遍合同里的计价口径、给价目表加上版本号与生效时间字段、在账本里补上请求级单价版本。犀跃公司在 API 网关与分销后台的交付里,通常把这三件事放在上线前而不是争议后。适用边界也说清楚:调用量很小、单一客户的内部工具,不必为这套机制增加复杂度。

对这个话题感兴趣?
10 年技术团队,24 小时内出具参考方案
获取方案
准备好开始了吗,
那就与我们取得联系吧!
13370032918
了解更多服务,随时联系我们
请填写您的需求
您希望我们为您提供什么服务呢
您的预算
联
系
微信二维码
扫码添加客服微信
专业对接各类技术问题
联系电话
13370032918 (金经理)
电话若占线或未接到、就加下微信
联系邮箱
349077570@qq.com
提交成功
感谢您的信任,我们会尽快与您联系!
为您推荐以下案例