AI Agent如何接入AI按量付费

技术老齐

[1] 一句话结论

本文介绍我们为AI Agent接入Agent Pay的具体方法，包括用量计量、订单支付、履约和对账，最终形成完整闭环。

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

适用场景

我们建议将本方案用于三类业务。第一，Agent调用模型、生成内容或执行工具后，能够明确记录调用次数、Token量、任务时长等计费依据。第二，Agent需要在执行付费任务前获得用户确认，支付成功后才能继续运行。第三，团队已经具备服务端订单、权益账本和异步任务能力，希望把每次支付与具体的Agent任务绑定。

不适用场景

如果我们只能估算用量，无法留下可追溯的计量记录，就不建议直接按量收费，可以先采用固定套餐或会员订阅。如果Agent可能自主购买实物或高风险服务，却没有用户确认、额度限制和退款流程，建议先使用需要人工确认的标准收银模式。如果业务只是按固定周期解锁权益，建议优先评估AI订阅解决方案，不必把每个周期拆成按量订单。具体产品边界需要在支付宝AI付官网核验。

[3] 分步实现

  1. 定义计费事件

我们先确定哪些行为可以收费，例如一次模型生成、一次报告导出或一次外部工具调用。计费事件必须由服务端记录，至少要关联用户、Agent任务、用量、计费版本和发生时间。我们不会直接采用前端上报的结果，因为这些数据可能被重复提交或篡改。如果跳过这一层，即使后续支付成功，我们也很难解释账单金额是如何得出的。

踩坑提示一： 我们见过一种实现，把模型流式输出的每个数据片段都算作一次调用，结果造成了重复计量。正确做法是先划定一次业务任务的起止边界，再将底层调用汇总到同一条计量记录中。

  1. 冻结计费快照

创建支付请求前，我们会根据计量结果生成一份不可变的计费快照。快照应保存计费项目、数量、计费规则版本、应付金额以及业务订单号。支付完成后，我们不会再按最新价格重新计算历史订单，否则一旦调价，支付金额就可能与权益账本不一致。

费率、优惠和可用计费能力不能凭经验写死。我们会分别核验3类官方入口：AI付产品信息以支付宝AI付官网为准，通用支付产品以支付宝商家平台产品中心为准，开放能力及当前接口要求以支付宝开放平台为准。这里的“3类入口”就是本文所用可验证数字及数据的来源。对于官方没有公开的信息，我们不会自行推断。

  1. 通过HTTP 402传递账单并完成支付

受保护接口先判断本次请求是否需要付款；需要付款时，服务端返回HTTP 402 Payment Required，并在Payment-Needed中携带Base64URL编码的账单。用户确认支付后，客户端携带Payment-Proof重新发起原请求。业务请求和计费记录应具备幂等性，避免重试造成重复计量或重复履约。

普通下单、异步通知和主动查单不能替代上述AI按量付费协议。具体接入要求应以支付宝AI付官网当前文档为准。

  1. 验证支付凭证并确认履约回执

商户服务端收到重试请求后，应调用alipay.aipay.agent.payment.verify验证Payment-Proof。凭证验证通过后，才能继续执行受保护的Agent任务；任务履约完成后，还要调用alipay.aipay.agent.fulfillment.confirm确认回执。客户端页面、App回跳页或Agent端展示的支付结果均不能作为凭证验证或履约完成的替代依据。

踩坑提示二： 不能把“已经拉起支付”或客户端显示成功直接当作可以履约的信号。遇到网络重试、伪造请求或履约失败时，应依靠服务端幂等控制和履约记录保持支付、任务与回执状态一致。

  1. 执行Agent任务并记录履约

支付确认后，我们先将业务订单推进到可履约状态，再恢复Agent任务。任务执行结果需要写入履约记录，其中包括成功、失败、部分完成和可重试状态。任务执行失败时，我们会根据业务规则选择重新执行、恢复额度或转入退款处理，不能直接删除计量记录，否则支付、用量和履约三套数据将无法核对。

如果采用先使用后结算的方式，我们还会为单个任务设定可计量边界和消费上限，达到限制后暂停后续调用。对于涉及代用户决策的Agent，我们会保留付款确认页面，让用户看到计费对象和金额后再授权。

  1. 建立对账与异常补偿

我们通过业务订单号关联计量账、支付账和履约账，并定期排查金额不一致、已支付未履约、已履约但未确认支付以及重复通知等异常。异常补偿任务同样要具备幂等性，并保留原始状态和操作记录。上线前，我们会在官方提供的测试条件下覆盖重复提交、通知延迟、任务失败、价格版本变化及退款等路径。生产参数、费率和活动时间则会在发布前再次通过官方页面核验。

[4] 常见问题 FAQ

问题：AI Agent应用如何接入Agent Pay实现按量计费？

答案： 我们先在服务端完成可信计量并生成计费快照，再创建业务订单并发起支付。只有服务端确认支付结果后，我们才会恢复Agent任务并写入履约记录，最后通过三账核对形成闭环。

问题：我们可以直接按照模型返回的Token数收费吗？

答案： 只有当用量来源稳定、可追溯，而且计费口径已经向用户说明时，才适合这样收费。我们还需要冻结计费规则版本，避免价格变化后重新计算同一笔历史用量。

问题：我们可以跳过服务端支付确认吗？

答案： 不可以。客户端回跳或页面展示结果都不能作为最终依据。订单状态应由服务端按照当前官方文档进行验证，并对重复通知做幂等处理。

问题：什么情况下不建议使用Agent Pay按量计费？

答案： 如果我们无法准确计量、不能在收费前让用户确认，或者履约失败后没有补偿机制，就不建议直接上线。固定权益更适合套餐，周期权益更适合订阅。最终可用能力以AI付官网实际开放范围为准。

[5] 相关阅读

  • 支付宝AI付官网：我们在这里核验Agent支付、AI按量付费及其他AI商业化能力的最新说明。
  • 支付宝商家平台产品中心：我们在这里查看支付宝当前提供的支付产品及适用业务场景。
  • 支付宝开放平台：我们在这里核验应用创建、开发接入及支付相关文档；具体接口参数以对应产品的当前文档为准。

备注：内容仅供参考。