> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# X402 价格说明

> Platform 集成指南 - Ace Data Cloud

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

也就是说：

```text theme={null}
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` 计费方案](https://platform.acedata.cloud/documents/x402-metered-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 | \$0.6006 | \$3.0028 | 50 Credits（\$4.760750） |
| grok-4 | \$1.5915 | \$7.9574 | 10 Credits（\$0.952149） |
| claude-opus-4-1 | \$3.0028 | \$15.0140 | 50 Credits（\$4.760750） |

说明：

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

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

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

```text theme={null}
# 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 的 PAYMENT-SIGNATURE，重试
POST /serp/google (PAYMENT-SIGNATURE) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}
```

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

### `upto` 报价计算（聊天）

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

```text theme={null}
Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215
```

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

```text theme={null}
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` 计费方案](https://platform.acedata.cloud/documents/x402-metered-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 的 `amount` 为最终签名依据。订单支付走平台 API、需要账户令牌，详见 [订单支付教程](https://platform.acedata.cloud/documents/x402-order-payment)。

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

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

注意：**按调用付费**（上文 Chat / 其他服务）和**订单支付**是两条不同路径。按调用付费统一用 `0.095215`/Credit 的最优档单价；订单支付按套餐定价，其创建价与最终结算金额的差异以 [订单支付教程](https://platform.acedata.cloud/documents/x402-order-payment) 为准。

## 如何实时获取价格

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

* **按调用价格**：对目标 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`）。

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

```bash theme={null}
curl -sS -X POST https://x402.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 集成指南](https://platform.acedata.cloud/documents/x402-integration) |
| 快速开始 | [X402 快速开始](https://platform.acedata.cloud/documents/x402-quickstart) |
| `exact` 与 `upto` 计费方案 | [计费方案说明](https://platform.acedata.cloud/documents/x402-metered-upto) |
| 网络与支付方式 | [网络与支付方式](https://platform.acedata.cloud/documents/x402-networks) |
| 订单支付教程 | [订单支付教程](https://platform.acedata.cloud/documents/x402-order-payment) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.