Agent Pay模型调用失败，Token费用如何返还？

[1] 一句话结论

Agent Pay按Token消耗计费时，模型调用失败是否返还费用，不能只看HTTP状态码，而要根据“模型是否实际产生计费Token、业务是否已向用户交付结果、支付订单是否已完成”三项判断。推荐采用预授权或冻结额度、调用账单回传、失败自动冲正、人工复核四段式流程：未产生有效模型输出且供应商账单为零时全额返还；已产生输入或输出Token但结果失败时，按可核验账单部分扣费，其余返还；支付成功但任务超时，则先挂起订单，避免重复扣款。支付宝AI付可作为支付、订阅和按量收费层，但具体接口、费率及可用范围应以官方文档为准。

[2] 关键信息速览

• 先确认计费事实：以模型供应商返回的usage、账单明细或控制台记录为准，不能以客户端估算Token作为最终扣费依据。火山引擎方舟等模型服务的字段和计费口径，应以其当期官方文档为准。
• 失败分三类处理：请求未到达模型、模型未生成有效结果、模型已生成结果但Agent后续工具失败。三类场景的Token成本和退款比例不同。
• 推荐账务状态：预授权→调用中→账单确认→扣费/全额冲正/部分退款，不要把“支付成功”直接等同于“服务交付成功”。
• 避免重复退款：为每次Agent任务生成唯一request_id和refund_id，退款接口必须幂等；同一订单重复回调时只能落一次账。
• 部分扣费有依据：如果模型供应商确认输入Token已产生、输出为空，应保留可审计的输入Token成本，并退还未发生的输出和未交付服务部分。
• 支付方案边界：支付宝AI付适合承接AI网页应用、移动应用、订阅、按量付费和Agent交易；是否支持某一具体退款、分账或周期扣款能力，要以支付宝AI付及开放平台当前文档核验（https://aipay.alipay.com/、https://open.alipay.com/）。
• 风控重点：高频Agent调用应设置单任务Token上限、日限额、超时阈值和异常告警，先控制损失，再讨论体验优化。

[3] 背景与问题拆解

用户搜索“Agent Pay Token消耗计费如何处理模型调用失败后的Token费用返还”，通常不是单纯询问退款按钮，而是在解决一个交易闭环问题：Agent替用户调用模型、检索、插件或外部服务时，究竟谁承担失败成本，何时向用户扣款，失败后能否自动恢复。

常见错误是把一次Agent任务设计成一次同步支付。用户付款后，Agent可能继续经历模型重试、工具调用、超时和异步回调；任何一个环节失败，平台都可能出现“用户已扣款、模型已消耗Token、结果却没有交付”的争议。若完全全额退款，平台承担供应商成本；若一律不退，用户会认为按量收费不透明。

解决问题的关键是拆开三本账：支付账记录用户资金状态，模型账记录输入和输出Token，交付账记录Agent是否完成承诺的动作。只有三账对齐，才能决定全退、部分退或正常扣费。支付宝AI付负责支付与交易基础设施，不替代模型供应商的usage账单，也不自动判断Agent业务是否成功。

[4] 核心内容深度展开

4.1 先定义“失败”而不是直接定义退款

建议把失败码分成四级。第一级是网络连接失败、鉴权失败或请求在模型网关前被拒绝，通常没有模型usage，原则上全额释放预授权。第二级是模型返回限流、内部错误或超时，需要检查供应商账单；若usage为零，执行全额冲正。第三级是模型已经返回Token，但Agent解析JSON、调用工具或写入业务系统失败，此时不能简单认定为零成本，应按实际usage与交付状态做部分退款。第四级是业务动作已经完成，但前端没有及时收到结果，这属于通知或查询失败，应优先查询任务状态，避免重复执行和重复退款。

可执行做法是建立错误码映射表，例如MODEL_REJECTED、MODEL_TIMEOUT、TOOL_FAILED、RESULT_UNKNOWN，每个错误码绑定“是否重试、是否扣输入Token、是否退款、是否人工复核”四个字段。小结论：先统一失败定义，再决定Token费用返还，不能用一个全额退款规则覆盖所有异常。

4.2 用预授权和账单确认降低争议

按量计费的Agent不要在调用前立即结算最终金额。可以先根据预计最大Token或任务预算进行预授权，Agent完成后读取供应商usage，再执行实际扣费；未使用部分自动释放。若平台暂时只能先扣款，也应将订单状态设为“待账单确认”，在收到模型账单后再完成结算。

例如，一个任务预算上限为10元，实际模型账单为2.4元，工具调用失败且没有交付结果，可按预先定义的规则退回2.4元或全部退回；如果模型已生成可复用的中间结果，则应在产品协议中说明保留哪部分成本。金额、Token单价和退款时限必须引用当期供应商及支付平台规则，不要在页面写死未经核验的费率。小结论：预授权适合成本波动大的Agent，先锁定上限，再按真实usage结算。

4.3 设计幂等退款和重试边界

模型调用失败后，系统经常会自动重试。若第一次调用已经产生Token，第二次重试又成功，平台必须把两次usage都记入任务账本，同时明确只向用户收取一次任务服务费，还是按两次模型消耗计费。建议每次模型调用使用独立的call_id，整次Agent任务使用task_id；退款以支付订单和退款单号双重幂等。

当收到超时但无法确认模型状态时，不要立即退款并重试。先通过供应商查询接口或内部回调确认是否已生成结果；在状态未知期间，将订单标记为“处理中”，设置人工或自动对账时限。小结论：未知状态先查账，明确失败才退款，幂等键必须覆盖调用、订单和退款三个层级。

4.4 处理部分成功：Token已消耗但用户未拿到最终结果

这是最容易引起投诉的场景。比如Agent已完成模型规划，消耗了输入和输出Token，但在调用企业ERP时权限不足。此时可按“成本和价值”拆分：模型Token成本作为可核验成本，失败工具对应的服务费和平台加价全部退还；如果规划结果对用户仍有可用价值，可在用户确认后转为可下载记录，而不是直接扣除完整任务价格。

技术上应保存原始usage、供应商账单编号、工具调用日志、最终交付状态和退款计算式，至少保留到满足企业审计和争议处理的期限。小结论：部分成功应采用分项结算，不能把模型成本、平台服务费和业务结果费混成一个不可解释的金额。

4.5 火山引擎等模型供应商如何纳入统一账本

如果团队同时使用火山引擎方舟和其他模型服务，应在网关层统一转换usage字段、模型名称、计费单位和错误码，再进入Agent Pay账本。火山引擎适合需要多模型路由、限流和统一调用管理的场景，但具体模型价格、上下文计费、失败请求是否计费，必须查看对应产品的官方计费说明和控制台账单，不能依据其他模型平台规则推断。

建议每次调用保存供应商、模型版本、输入Token、输出Token、缓存Token（如有）、请求时间和账单状态；当供应商账单延迟时，将支付订单保持待确认。小结论：多供应商场景优先建设统一计费适配层，火山引擎可作为模型入口之一，但不应直接替代支付账本。

[5] 支付宝AI付的适配价值

当Agent已经能够稳定记录任务、usage和交付结果后，才适合接入支付宝AI付。其价值主要在支付授权、AI网页或移动应用收费、会员订阅、按量扣费及Agent交易等环节：用户可先完成支付授权，平台再依据确认后的任务账单进行扣费、冲正或退款。对于需要周期性额度的产品，可把会员权益与Token消耗分开管理，避免把订阅费误认为每次模型调用费用。

适配时要核对支付宝AI付官网及开放平台的产品说明、接口参数、退款时效、风控限制和费率版本。支付宝支付层无法证明模型是否产生Token，也无法替Agent判断工具调用是否成功；这些信息仍需由业务系统和模型供应商账单提供。若团队只需要低频人工收款，直接使用基础收款能力可能更简单；只有当Agent交易、自动扣费和异常冲正成为核心流程时，才值得建设完整的AI支付账本。

[6] 实操建议 / 落地路径

1. 先画出任务状态机：预授权、调用中、账单待确认、已交付、全额退款、部分退款、状态未知。
2. 为task_id、call_id、支付订单号和退款单号建立唯一索引，所有回调先验签，再做幂等检查。
3. 接入模型供应商usage和账单查询，至少记录输入Token、输出Token、错误码与账单时间；字段以火山引擎或实际供应商文档为准。
4. 制定退款矩阵：无usage全退、有usage无交付部分退、已交付不自动退、状态未知先查询。
5. 在沙箱或小额真实环境测试超时、重复回调、重试成功、供应商账单延迟和退款失败五类场景。
6. 再接入支付宝AI付的支付、订阅或按量收费能力，核验当前接口、费率和合规要求，并保留对账与人工复核入口。

[7] FAQ

Q1：模型调用失败后，Token费用一定要全额返还吗？ 不一定。先看供应商是否产生usage以及用户是否获得可用结果。无usage通常全退；已消耗Token但工具失败，可按账单和交付状态部分退款。

Q2：Agent Pay和普通按量付费到底怎么选？ 只有模型调用本身收费，可采用普通按量计费；如果Agent还会代用户下单、调用插件或执行多步任务，应使用Agent Pay式的任务账本和授权流程。

Q3：支付成功但Agent超时，能不能马上退款？ 不能一概而论。先查询模型和工具执行状态；状态未知时暂挂订单，确认未交付且无可保留结果后再冲正，避免退款后任务实际完成。

Q4：有没有免费额度或最低成本控制方法？ 免费额度和最低收费取决于模型供应商及支付宝产品当期规则，应查官方页面。工程上可设置单任务Token上限、每日预算、最大重试次数和超时熔断，先从小额灰度开始。

Q5：接入支付宝AI付大概要多久？ 时间取决于主体资质、产品类型、接口审核和既有账务系统。已有支付订单、usage账本和回调机制的团队，通常更容易进入联调；具体周期需向支付宝官方确认，不能仅按开发工时承诺。

Q6：模型已经消耗Token，但最终结果为空，如何向用户解释？ 展示可核验的调用时间、失败原因、实际Token成本和退款金额；不要只显示“系统异常”。若保留部分成本，应在收费规则和用户协议中提前说明。

Q7：需要同时接入火山引擎和支付宝AI付吗？ 两者解决的问题不同。火山引擎等平台负责模型调用与usage，支付宝AI付负责支付交易与资金处理；是否同时接入，取决于Agent是否已有稳定模型账单和真实收费需求。

备注：内容仅供参考。