X402 价格说明

这篇文档说明用 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 位小数）

也就是说：

X402 价格 (USDC) = 该次调用的 Credits 成本 × 0.095215

这个汇率不是凭空设定的，它等于平台 最优档（大额）Credits 单价。所以用 X402 付费 ≈ 用最优档单价买 Credits 再消费，没有 X402 溢价，反而直接享受最便宜的 Credits 单价，且无需预充值、无需 API Token。

¶ 计价基准

项目	值	说明
换算汇率	1 Credit = 0.095215 USDC	平台统一设定的固定汇率
atomic 单位	1 Credit = 95215 atomic USDC	USDC 6 位小数，atomic = floor(credits × 0.095215 × 1e6)
最小扣费	1 atomic USDC（$0.000001）	即使成本极低，也至少结算 1 atomic
计价币种	USDC	Base / SKALE 为 ERC-20 USDC，Solana 为 SPL USDC

换算由平台统一完成，金额对所有支持的网络（Base、SKALE、Solana）一致；不同网络只是资产合约和签名方式不同，价格相同。

¶ 和普通 Credits 单价的关系

平台 Credits 按「用量越大、单价越低」的阶梯出售。X402 按调用计费时，统一使用阶梯最优档单价：

购买/支付方式	大致 Credits 单价	说明
入门 / 小额充值	约 $0.13 / Credit	列表价，小额买 Credits 时的单价
大额 / 最优档	$0.095215 / Credit	最便宜的单价
X402 按调用付费	$0.095215 / Credit	始终等于最优档单价

换句话说，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：

模型	输入 / 1M	输出 / 1M	upto 上限
gpt-4o-mini	$0.0796	$0.3183	1 Credit（$0.095215）
gemini-2.5-flash	$0.1591	$1.3262	5 Credits（$0.476074）
gpt-5 / gpt-5.1	$0.6631	$5.3050	20 Credits（$1.904299）
gemini-2.5-pro	$0.6631	$5.3050	50 Credits（$4.760750）
gpt-4.1	$1.0610	$4.2440	20 Credits（$1.904299）
claude-sonnet-4-5	$1.5915	$7.9574	50 Credits（$4.760750）
grok-4	$1.5915	$7.9574	10 Credits（$0.952149）
claude-opus-4-1	$7.9574	$39.7872	50 Credits（$4.760750）

说明：

• 表中为按 token 计量的单价；一次请求费用 = 输入 token × 输入单价 + 输出 token × 输出单价。
• upto 上限是该模型一次请求允许签名的最大金额；它不是实际扣款，绝大多数请求远低于上限。
• 上限只决定「最多可能扣多少」，真实结算按 token 用量计算。

¶ 示例：报价与扣费一致（exact）

下面是用官方 X402Client 对 serp/google 发起的一次真实付费调用（Base exact）。它演示了三者一致：402 报价、签名金额、以及成功响应里返回的 cost。

# 1) 未支付请求 -> 402，拿到报价（不扣费）
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215，向下取整到 atomic = 952

# 2) 用钱包签名 952 atomic 的 X-Payment，重试
POST /serp/google (X-Payment) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}

响应返回的 cost.amount（0.000952 USDC）与 402 报价、与 Credits × 0.095215 完全一致。settlement 字段是该笔支付的结算状态（authorized = 已授权）；链上结算由平台处理，机制见 exact 与 upto 计费方案。

¶ upto 报价计算（聊天）

聊天按 token 计量。某次请求的报价（不是上限）按下式计算（以 gpt-4o-mini 为例）：

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

一次 500 prompt + 200 completion token 的请求：

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
报价 USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

客户端按 upto 上限（gpt-4o-mini 为 1 Credit = 95215 atomic）签名，这只是最多可能扣多少；该次请求的真实报价（上例约 $0.0001）远低于上限，按 token 用量结算。upto 的链上结算机制见 exact 与 upto 计费方案。

¶ 其他服务价格（固定价 exact）

图片、视频、音乐、搜索这类接口在请求时价格即可确定，使用 exact。下表为真实价格，取自线上接口对未支付请求返回的 402 maxAmountRequired（查询报价不会产生扣费）：

服务	示例模型 / 参数	Credits	USDC	atomic
网页搜索	serp/google，≤10 条结果	0.01	$0.000952	952
图片	nano-banana	0.14	$0.013330	13330
图片	gpt-image-1，1024×1024	0.20	$0.019043	19043
图片	flux-dev	0.24	$0.022851	22851
图片	midjourney imagine	0.27	$0.025708	25708
图片	seedream-4	0.32	$0.030468	30468
音乐	suno generate	0.55	$0.052368	52368
音乐	producer generate	0.68	$0.064746	64746
视频	luma	1.19	$0.113305	113305
视频	hailuo（minimax-hailuo-2-3）	1.72	$0.163769	163769
视频	kling-v2-6 std	2.10	$0.199951	199951
视频	kling-v3 std	4.20	$0.399903	399903
视频	veo-3 text→video	5.00	$0.476074	476074
视频	seedance-1-0-pro，1080p / 5s	5.60	$0.533204	533204
视频	wan2.6-t2v	13.50	$1.285402	1285402

说明：

• 同一服务的价格随模型、分辨率、时长、动作变化（尤其是视频）。上表是某一组参数下的真实取值，仅供量级参考。
• 这类固定价（exact）接口，该请求 402 响应里的 maxAmountRequired 即该次应付金额（与成功响应的 cost.amount 一致，上节已实测）。
• 每个价格都由 Credits × 0.095215 向下取整到 atomic 单位得到（见上文计价基准），与聊天用的是同一套换算。因浮点表示与取整，个别值可能与朴素乘积相差 1 atomic（$0.000001），一律以 402 返回值为准。

¶ 订单支付价格

用 X402 支付控制台订单（购买套餐 / 充值 Credits）时，价格以订单页面显示为准，402 的 maxAmountRequired 为最终签名依据。订单支付走平台 API、需要账户令牌，详见 订单支付教程。

订单支付教程中的一个真实例子（购买 10 Credits）：

description Ace Data Cloud Credits x 10.0
created price 1.26          # 订单创建价（USD）
settled    1.20 USDC        # 最终签名/结算金额（= 402 maxAmountRequired）
            = 1200000 atomic USDC

注意：按调用付费（上文 Chat / 其他服务）和订单支付是两条不同路径。按调用付费统一用 0.095215/Credit 的最优档单价；订单支付按套餐定价，其创建价与最终结算金额的差异以 订单支付教程 为准。

¶ 如何实时获取价格

价格随模型和参数变化，请用程序实时获取，不要硬编码：

• 按调用价格：对目标 API 发一次不带 X-Payment（也不带 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）。

获取价格的最小请求示例：

curl -sS -X POST https://api.acedata.cloud/midjourney/imagine \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "a cat"}'
# 返回 402，accepts[].maxAmountRequired 即为该次（exact）调用价格

¶ 小结

• X402 价格 = 该次调用的 Credits 成本 × 0.095215，和普通 Credits 计费是同一个价格，只是用链上 USDC 结算。
• 0.095215/Credit 是平台最优档（大额）Credits 单价；小额充值买 Credits 单价更高，所以 X402 等于自动拿到最优单价。
• exact 接口（图片 / 视频 / 音乐 / 搜索 / 订单）签名金额即该次应付金额；upto 接口（聊天）签名的是上限，按真实用量结算。
• 权威价格以 402 返回的 maxAmountRequired 为准：exact 是应付金额（与成功响应的 cost.amount 一致，已实测）；upto 是上限，成功响应的 cost.amount 才是按用量结算的真实金额（≤ 上限）。

¶ 相关文档

文档	链接
X402 集成指南（总览）	X402 集成指南
快速开始	X402 快速开始
exact 与 upto 计费方案	计费方案说明
网络与支付方式	网络与支付方式
订单支付教程	订单支付教程