静觅 ·

X402 `exact` 与 `upto` 计费方案

💡 原文中文，约5400字，阅读约需13分钟。

📝

内容提要

Ace Data Cloud X402 提供两种计费方案：exact 和 upto。exact 适用于固定价格服务，确保请求前确定价格；upto 允许客户端设定最大扣款上限，实际费用根据使用量结算，适合动态计费场景。使用时需确保授权和签名参数一致性，以确保顺利结算。

🎯

🔎

在选择计费方案时，用户应根据具体需求进行判断。对于固定价格的服务，如图片生成和订单支付，建议使用exact方案，以确保费用透明。而对于动态计费场景，如聊天补全，upto方案更为合适，因为它允许设定最大扣款上限，灵活应对使用量变化。

在使用upto方案时，确保客户端的授权和签名参数一致性至关重要。如果实际用量超过设定的上限，Facilitator会拒绝结算，用户需重新授权更高的上限。这一过程可能导致额外的时间和资源消耗，因此在请求前应仔细确认相关参数。

使用upto方案时，虽然可以设定最大扣款上限，但实际扣款可能低于该上限，用户需注意这一点。此外，若未提前完成Permit2的授权，可能会导致请求失败。因此，用户在使用前应确保所有必要的授权和设置已到位，以避免不必要的错误和延误。

❓

exact 计费方案适合固定价格的图片生成、视频任务创建、搜索或工具 API 和订单支付。

upto 计费方案允许客户端设定最大扣款上限，实际费用根据使用量结算，适合动态计费场景。

使用时需确保授权和签名参数一致性，以确保顺利结算。

如果实际用量超过上限，Facilitator 应拒绝结算，客户端需要重新授权更高上限。

固定价格 API 使用 exact，聊天补全优先使用 upto。

upto 方案支持实际金额为 0 的情况，Facilitator 会返回成功，但不会发链上交易。

🏷️