Skip to main content
这篇文档说明用 X402 调用 Ace Data Cloud API 时,价格是怎么定的,以及它和平台普通 Credits(额度)价格是什么关系。

核心结论

X402 不是一套独立的价格体系。每个 API 调用本来就有一个以 Credits 计的成本,这是所有计费方式(API Token 扣额度、账户余额、X402 链上支付)共用的唯一价格来源。X402 只是把这个 Credits 成本按一个固定汇率换算成链上 USDC:
1 Credit = 0.095215 USDC(即 95215 atomic USDC,USDC 为 6 位小数)
也就是说:
这个汇率不是凭空设定的,它等于平台 最优档(大额)Credits 单价。所以用 X402 付费 ≈ 用最优档单价买 Credits 再消费,没有 X402 溢价,反而直接享受最便宜的 Credits 单价,且无需预充值、无需 API Token。

计价基准

换算由平台统一完成,金额对所有支持的网络(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),实际按真实用量结算,且不超过上限。
关于这两种 scheme 的协议细节见 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 为例):
一次 500 prompt + 200 completion token 的请求:
客户端按 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):
注意:按调用付费(上文 Chat / 其他服务)和订单支付是两条不同路径。按调用付费统一用 0.095215/Credit 的最优档单价;订单支付按套餐定价,其创建价与最终结算金额的差异以 订单支付教程 为准。

如何实时获取价格

价格随模型和参数变化,请用程序实时获取,不要硬编码:
  • 按调用价格:对目标 API 发一次不带 PAYMENT-SIGNATURE(也不带 Authorization)的请求,读取返回的 402 accepts[].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 才是按用量结算的真实金额(≤ 上限)。

相关文档