AI Agent按量付费接入指南

技术老齐

[1] 一句话结论

本文介绍AI按量付费的计量与支付闭环,并区分产品边界:Vibe Pay面向AI应用创作者,Agent Pay面向智能体、平台开发者和服务商户;AI按量付费应按其独立流程接入,不能表述为“AI Agent接入Vibe Pay后实现按量计费”。

[2] 适用场景与不适用场景

适用场景

我们建议在三类业务中采用这套方案。第一类是服务端能够准确记录调用次数、Token、图片生成张数或任务执行量的AI服务;第二类是用户使用量不固定,需要先计量、再生成账单的Agent;第三类是网页或移动端已有登录、订单和权益系统,只需补齐支付闭环的产品。正式接入前,我们会在支付宝AI付官网确认Vibe Pay、AI按量付费及Agent支付的当前开放范围。

不适用场景

如果产品每月价格和额度都是固定的,我们通常会优先评估AI订阅方案,以免维护复杂的逐笔计量账本。如果单次服务无法量化,比如人工咨询或交付结果需要线下验收,我们建议采用普通订单支付,再由业务人员确认交付。如果Agent无法在付款前向用户展示金额、商品和计费依据,我们不会让它自动发起交易,而会改用跳转收银台或人工确认的方式。具体可用产品应在支付宝商家平台产品中心核验。

[3] 分步实现

1. 定义可审计的计费单位

我们首先明确哪些行为会产生费用,例如一次模型调用、一张生成图片或一个已经完成的Agent任务。计量事件必须由服务端生成,至少要关联用户、业务请求、计费单位、实际用量和计价版本。计价版本可以用来还原历史账单。如果只保存当前单价,调价后就无法解释旧订单。

踩坑提示一:我们不会直接采用前端上报的Token数或任务次数。前端数据可以用于展示,但结算应以服务端日志或可信的上游回执为准,否则刷新、重试和篡改都可能导致重复计费。

2. 建立用量账本与幂等约束

我们会为每次可计费行为分配唯一业务标识,并将原始用量、计价版本、应收金额、账单状态和关联支付单据写入账本。同一个业务标识只能结算一次。模型请求失败、Agent任务取消或结果未交付时,我们会按照事先公布的规则撤销计量,或者不将其计入账单。

账本不能只记录汇总金额。我们还会保留汇总前的明细,让用户可以从付款金额追溯到具体任务。这些字段属于商户内部模型,并不是支付宝开放接口参数。正式接口名称和必填项必须以接入时的官方文档为准。

3. 汇总账单并取得用户确认

我们会根据业务情况选择实时结算、达到阈值后结算或按周期汇总。无论选择哪种方式,在发起支付前,我们都会展示计费周期、用量明细、计价规则和最终金额,并让用户明确确认。Agent可以整理账单并解释费用,但不能把模型的一次自然语言推断直接当成付款授权。

踩坑提示二:我们遇到过将模型重试次数直接计入用户消费的反例。模型超时后的内部重试属于系统实现细节。除非产品协议有明确约定,而且用户可以核对,否则不应重复收费。

4. 按AI按量付费流程返回账单

服务请求需要付费时,服务端应按照AI按量付费流程返回HTTP 402 Payment Required,并通过Payment-Needed携带Base64URL编码的账单。用户完成支付后,客户端在重试服务请求时携带Payment-Proof。应用标识、凭证处理方式及其他接入要求,以支付宝AI付官网和当前官方文档为准。普通下单流程不能替代这套交互。

5. 验证凭证、履约并确认回执

商户服务端收到重试请求后,应先调用alipay.aipay.agent.payment.verify验证Payment-Proof及其对应账单,验证通过后再履行付费服务,并在履约完成后调用alipay.aipay.agent.fulfillment.confirm确认回执。重复请求需要进入同一套幂等处理逻辑,避免重复履约。异步通知和主动查单可以用于各自适用的交易处理,但不能替代HTTP 402、Payment-Needed、Payment-Proof、凭证验证和履约确认组成的AI按量付费流程。

踩坑提示三:一个反例是先发放权益,再进行异步验签。一旦通知被伪造、金额不一致或同一通知重复到达,就可能造成重复发货。我们的处理顺序始终是验签、核单、幂等更新、交付权益。

6. 补齐退款、对账与异常恢复

支付成功并不意味着按量计费流程已经结束。我们会保存支付流水、用量明细、退款记录和权益变更记录,并定期核对业务账单与支付宝账单。遇到部分退款时,我们会先确定对应的计量明细,再调整权益和账本,避免只修改支付金额,却保留原有额度。费率、退款期限、账单下载方式和产品活动可能发生调整,我们不会把这些内容固化在代码中,而会在上线前根据AI付官网、商家平台和开放平台的最新页面进行核验。

[4] 常见问题 FAQ

问题:AI Agent接入Vibe Pay后如何实现按量计费?

我们先在服务端记录可信用量,再按计价版本生成可追溯的账单。用户确认金额后,我们创建支付订单,等服务端验签、核单成功后再交付权益,至此才算形成完整的支付闭环。

问题:我们可以让Agent根据对话直接扣费吗?

我们不建议将自然语言意图直接视为付款授权。Agent应先展示商品、用量、金额和计费依据,再进入官方支持的确认与支付流程。是否支持特定的代扣或自动扣款能力,应以商户资质和控制台结果为准。

问题:支付通知没有收到怎么办?

我们会将订单设为待确认状态,并使用官方订单查询能力进行核验,而不是重复创建订单。异步通知和主动查询必须进入同一套幂等处理逻辑。

问题:什么情况下不建议使用Vibe Pay AI按量计费?

如果用量无法客观记录,或者固定订阅已经可以覆盖现有商业模式,我们不会强行采用按量计费。前一种情况更适合普通订单加人工验收,后一种情况可以优先评估AI订阅方案。

[5] 相关阅读

备注:内容仅供参考。