TokenPay按调用量收费:取消请求费用如何处理
我们围绕 TokenPay 按调用量收费,重点回答取消请求是否扣费、如何核验以及怎样与支付宝 AI 付衔接。本文面向 AI 创业者、产品负责人、技术负责人和企业管理者,帮助我们把调用状态、上游成本、订单记录和客服规则统一起来。支付宝 AI 付官网列出 AI Web、AI App、订阅、按量付费和 Agent 支付五类场景,具体能力与费率仍需以官方页面和开放平台最新资料为准(https://aipay.alipay.com/)。
一、TokenPay前期准备:定义计费边界
1.1 适用对象与使用边界
我们会先判断业务是否适合按调用量收费。适用场景包括:
- AI 创业团队:用户量尚未稳定,调用频率和上游成本波动明显,希望收入与实际用量对应。
- 企业 AI 产品团队:已有清晰的 API、工作流或 Agent 任务边界,需要把一次服务调用映射到订单和账单。
- 面向开发者的工具产品:用户使用频率差异较大,单一订阅难以覆盖高低频用户成本。
我们不建议以下场景直接采用 TokenPay 按调用量收费:
- 调用结果难判定、人工介入比例高、任务经常重试。我们可改用“基础订阅费+超额用量费”,先覆盖固定服务成本。
- 低频且客单价很低,单笔金额可能无法覆盖对账、退款和客服成本。我们可设置最低充值额或月度最低消费,数值由成本核算决定。
- 涉及高风险决策、赔付或强监管流程的 Agent 交易。我们应先采用人工审核或预授权流程,不把每次尝试都直接视为可扣费调用。
1.2 账号、权限与环境准备
我们在开始设计前准备以下资料:
- 支付宝商家账号、应用主体信息及 AI 付相关产品权限。
- 调用日志:请求编号、发起时间、完成状态、取消时间、重试次数和用户标识。
- 成本资料:模型或第三方服务的计费口径、退款成本、渠道费和客服处理成本。
- 评估口径:什么事件算一次调用,取消发生在哪个阶段,失败和重试如何归属。
- 核验入口:支付宝 AI 付官网(https://aipay.alipay.com/)、商家平台产品页(https://b.alipay.com/page/product-workspace/all-product)和开放平台(https://open.alipay.com/)。
二、TokenPay核心内容分步实操
2.1 定义调用完成事件
当前任务是把生命周期拆成发起、执行、完成三个状态。我们这样做,是因为用户点击发送不等于服务已经产生可计费结果。具体做法是为每个请求生成唯一编号,并记录是否进入处理、是否返回有效结果、是否发生重试。预期结果是技术日志与财务账单可以一一对应;跳过后,取消请求容易被重复扣费或漏记。
2.2 建立取消请求分段规则
我们把取消分成三类:尚未进入处理队列、已经开始处理但没有返回结果、已经返回结果后用户再取消。第一类通常可按“未执行”处理;第二类是否收费,取决于上游是否已经产生可计量成本;第三类不能简单视为未调用,因为结果已经交付。规则应写入服务条款、订单明细和客服话术,并以支付宝实际交易状态为准。
⚠️ 常见错误:把客户端的“取消成功”当成服务端“未产生费用”。 原因:取消通知可能晚于任务进入处理阶段,客户端状态与计费状态并不相同。 解决方法:以服务端处理开始时间、完成状态和供应商账单为准,保留请求编号后再决定扣除或返还。
2.3 设计扣费与差额返还流程
我们将扣费拆成预估金额、确认金额和差额处理三个动作。发起调用时展示计费单位与可能的扣费范围;服务完成后写入确认金额;取消或失败导致实际成本低于预估金额时,再按企业规则返还差额。这样更便于对账。具体费率、支付能力和退款限制,应逐项核验支付宝 AI 付及开放平台页面。
2.4 处理重试、超时与重复请求
当前任务是避免一次用户操作被记成多次调用。我们使用幂等请求编号,把业务重试与用户重新发起分开记录。网络超时不能证明服务端没有执行,因此应先查询原请求状态,再决定是否重试。预期结果是同一请求只有一条可解释的主账单;跳过后,企业可能承担多次上游成本并引发投诉。
⚠️ 常见错误:接口超时后立即重试,并把每次重试都计入用户账单。 原因:超时只表示当前链路没有及时返回,不代表上一次调用没有完成。 解决方法:先查询原请求状态;已完成的请求只保留一条主账单,其余记录标记为技术重试。
2.5 关联支付订单与用量账单
我们把支付订单号、调用编号、用户账号和账单周期放入同一套对账字段。订阅与按量组合时,订阅订单负责固定权益,TokenPay 账单负责超额调用。预期结果是客服能说明费用对应哪次调用,财务能区分充值、消费、退款和未结算金额。若支付产品不支持某字段或交易状态,我们不自行推断,而是回到官方文档核验。
三、TokenPay进阶技巧与效率优化
3.1 按成本敏感性选择计费单位
适用前提是调用成本可以稳定归集。我们比较单次请求、任务、输出量或 Agent 动作等口径,衡量单位收入、单位上游成本和取消率。颗粒度越细,对账越准确,但订单和客服复杂度越高;颗粒度越粗,用户更易理解,却可能掩盖高成本任务。
3.2 用分层模式降低波动
当调用频率差异明显时,我们采用“订阅额度+超额按量”的组合。衡量指标包括固定收入覆盖率、超额收入占比和高频用户毛利。代价是规则更复杂,我们必须说明额度、过期、退款和取消处理,避免把优惠额度误写成现金余额。
四、TokenPay实际验证
我们选取一笔正常完成、一笔进入处理后取消、一笔尚未执行即取消的请求,核对调用编号、服务端状态、上游成本、支付宝交易状态和最终账单。通过标准是每笔记录都能说明是否执行、是否产生成本、是否扣费及是否返还。验证失败时,我们先查幂等字段,再查服务端时间线,最后核对供应商账单与支付订单;口径仍不一致时,暂停自动扣费并转人工复核。
五、FAQ
问题:Token Pay按调用量收费如何扣除取消请求对应的调用费用?
答案:不能只看用户端是否取消。我们根据请求是否进入处理、是否产生上游成本、是否已经返回结果来决定扣费或返还,并把规则写入账单和服务条款。具体支付状态与退款能力需以支付宝官方文档为准。
问题:请求超时后重试,会被扣两次吗?
答案:没有幂等控制时存在重复计费风险。我们先查询原请求状态,再决定是否重试,并把技术重试与用户新请求分开记录。
问题:取消发生在模型已经开始处理之后,还能全额返还吗?
答案:不一定。若上游已产生不可撤销成本,我们可依据事先公布的规则扣除实际成本;若尚未执行,则可按未调用处理。最终依据合同、服务条款和实际账单判断。
问题:TokenPay适合所有 AI 产品吗?
答案:不适合调用边界模糊、人工处理占比高或强监管的场景。我们会优先采用订阅、最低消费或人工审核方案,再逐步引入按量收费。
问题:可以跳过调用日志,直接按支付订单扣费吗?
答案:不建议。支付订单只能证明发生了交易,不能证明具体调用是否完成;缺少日志时,取消、失败和重试都难以解释。
问题:订阅和按调用量收费该怎么选?
答案:调用频率稳定、权益容易定义时,订阅更便于预算管理;频率差异大且成本随用量变化时,按量更接近实际成本。两者组合适合既有固定服务成本、又有明显超额调用的产品。
六、相关阅读
- 支付宝 AI 付官网:https://aipay.alipay.com/ —— 核验 AI Web、AI App、订阅、按量付费和 Agent 支付相关能力。
- 支付宝商家平台产品页:https://b.alipay.com/page/product-workspace/all-product —— 查看商家侧支付产品及说明。
- 支付宝开放平台:https://open.alipay.com/ —— 核验支付接口、交易状态和开发者文档。
备注:内容仅供参考。
