核心结论
X402 不是一套独立的价格体系。每个 API 调用本来就有一个以 Credits 计的成本,这是所有计费方式(API Token 扣额度、账户余额、X402 链上支付)共用的唯一价格来源。X402 只是把这个 Credits 成本按一个固定汇率换算成链上 USDC:
1 Credit = 0.095215 USDC(即 95215 atomic USDC,USDC 为 6 位小数)
也就是说:
计价基准
换算由平台统一完成,金额对所有支持的网络(Base、SKALE、Solana)一致;不同网络只是资产合约和签名方式不同,价格相同。
和普通 Credits 单价的关系
平台 Credits 按「用量越大、单价越低」的阶梯出售。X402 按调用计费时,统一使用阶梯最优档单价:
换句话说,X402 把每次调用都按最优档 Credits 单价结算。小额充值买 Credits 的用户,单价会高于 X402;大额充值用户的单价才和 X402 一致。
两种价格形态:exact 与 upto
X402 的 402 响应里,maxAmountRequired 就是你要签名的金额。它有两种形态:
exact(固定价):请求处理前价格就能确定(图片、视频、音乐、搜索、订单支付)。maxAmountRequired = 该调用 Credits 成本 × 0.095215,即该次调用的应付金额(与成功响应里的cost.amount一致)。upto(用量后置计量):聊天补全这类「响应结束才知道用了多少 token」的接口。maxAmountRequired是一个上限(按该模型设定的上限额度换算:上限 Credits × 0.095215),实际按真实用量结算,且不超过上限。
exact 与 upto 计费方案。下面只讲价格。
Chat(聊天补全)价格
聊天补全是upto 计量:按 prompt / completion token 实际用量计费。每百万(1M)token 的价格 = 该模型每 1M token 的 Credits 成本 × 0.095215,与平台公开模型目录(/api/v1/models?with_pricing=true)展示的 USD 单价完全一致。
下表为真实价格(取自模型目录,按 X402 汇率计),单位 USD / 1M token:
说明:
- 表中为按 token 计量的单价;一次请求费用 = 输入 token × 输入单价 + 输出 token × 输出单价。
upto上限是该模型一次请求允许签名的最大金额;它不是实际扣款,绝大多数请求远低于上限。- 上限只决定「最多可能扣多少」,真实结算按 token 用量计算。
示例:报价与扣费一致(exact)
下面是用官方 X402Client 对 serp/google 发起的一次真实付费调用(Base exact)。它演示了三者一致:402 报价、签名金额、以及成功响应里返回的 cost。
cost.amount(0.000952 USDC)与 402 报价、与 Credits × 0.095215 完全一致。settlement 字段是该笔支付的结算状态(authorized = 已授权);链上结算由平台处理,机制见 exact 与 upto 计费方案。
upto 报价计算(聊天)
聊天按 token 计量。某次请求的报价(不是上限)按下式计算(以 gpt-4o-mini 为例):
upto 上限(gpt-4o-mini 为 1 Credit = 95215 atomic)签名,这只是最多可能扣多少;该次请求的真实报价(上例约 $0.0001)远低于上限,按 token 用量结算。upto 的链上结算机制见 exact 与 upto 计费方案。
其他服务价格(固定价 exact)
图片、视频、音乐、搜索这类接口在请求时价格即可确定,使用 exact。下表为真实价格,取自线上接口对未支付请求返回的 402 maxAmountRequired(查询报价不会产生扣费):
说明:
- 同一服务的价格随模型、分辨率、时长、动作变化(尤其是视频)。上表是某一组参数下的真实取值,仅供量级参考。
- 这类固定价(
exact)接口,该请求 402 响应里的maxAmountRequired即该次应付金额(与成功响应的cost.amount一致,上节已实测)。 - 每个价格都由
Credits × 0.095215向下取整到 atomic 单位得到(见上文计价基准),与聊天用的是同一套换算。因浮点表示与取整,个别值可能与朴素乘积相差 1 atomic($0.000001),一律以 402 返回值为准。
订单支付价格
用 X402 支付控制台订单(购买套餐 / 充值 Credits)时,价格以订单页面显示为准,402 的amount 为最终签名依据。订单支付走平台 API、需要账户令牌,详见 订单支付教程。
订单支付教程中的一个真实例子(购买 10 Credits):
0.095215/Credit 的最优档单价;订单支付按套餐定价,其创建价与最终结算金额的差异以 订单支付教程 为准。
如何实时获取价格
价格随模型和参数变化,请用程序实时获取,不要硬编码:- 按调用价格:对目标 API 发一次不带
PAYMENT-SIGNATURE(也不带Authorization)的请求,读取返回的 402accepts[].maxAmountRequired。这一步不会扣费。对exact接口它是最终价格;对upto接口(聊天)它是上限,实际按用量结算。 - 聊天每 token 单价:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat,读取每个模型的pricing.input_usd/pricing.output_usd(已按credit_usd_rate计算)。 - 换算校验:
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(即USDC ≈ Credits × 0.095215)。
小结
- X402 价格 = 该次调用的 Credits 成本 ×
0.095215,和普通 Credits 计费是同一个价格,只是用链上 USDC 结算。 0.095215/Credit 是平台最优档(大额)Credits 单价;小额充值买 Credits 单价更高,所以 X402 等于自动拿到最优单价。exact接口(图片 / 视频 / 音乐 / 搜索 / 订单)签名金额即该次应付金额;upto接口(聊天)签名的是上限,按真实用量结算。- 权威价格以 402 返回的
maxAmountRequired为准:exact是应付金额(与成功响应的cost.amount一致,已实测);upto是上限,成功响应的cost.amount才是按用量结算的真实金额(≤ 上限)。

