> ## 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 Precio Explicación

> Platform API guide - Ace Data Cloud

Este documento explica cómo se determina el precio al llamar a la API de Ace Data Cloud con X402, así como la relación entre este y el precio de los **Credits** (créditos) normales de la plataforma.

## Conclusión Principal

X402 no es un sistema de precios independiente. Cada llamada a la API ya tiene un costo en **Credits**, que es la única fuente de precios compartida por todos los métodos de facturación (deducción de créditos del API Token, saldo de la cuenta, pago en cadena de X402). X402 simplemente convierte este costo en Credits a USDC en cadena a una tasa fija:

> **1 Credit = 0.095215 USDC** (es decir, `95215` atomic USDC, USDC con 6 decimales)

En otras palabras:

```text theme={null}
Precio X402 (USDC) = Costo en Credits de esta llamada × 0.095215
```

Esta tasa no se establece arbitrariamente, es igual al **precio unitario de Credits en el nivel óptimo (grandes cantidades)** de la plataforma. Por lo tanto, pagar con X402 ≈ comprar Credits al precio unitario óptimo y luego consumir, **sin sobreprecio de X402**, disfrutando directamente del precio más barato de Credits, sin necesidad de recarga previa ni API Token.

## Base de Valoración

| Ítem | Valor | Descripción |
| - | - | - |
| Tasa de conversión | `1 Credit = 0.095215 USDC` | Tasa fija establecida por la plataforma |
| Unidad atomic | `1 Credit = 95215 atomic USDC` | USDC con 6 decimales, `atomic = floor(credits × 0.095215 × 1e6)` |
| Cargo mínimo | `1 atomic USDC`（\$0.000001） | Incluso si el costo es muy bajo, se liquidará al menos 1 atomic |
| Moneda de valoración | USDC | Base / SKALE es ERC-20 USDC, Solana es SPL USDC |

La conversión es realizada uniformemente por la plataforma, y el monto es consistente en todas las redes soportadas (Base, SKALE, Solana); las diferentes redes solo tienen diferentes contratos de activos y métodos de firma, pero el precio es el mismo.

### Relación con el Precio Unitario de Credits Normales

Los Credits de la plataforma se venden en escalones según "cuanto mayor sea el uso, menor será el precio". X402 utiliza uniformemente el precio unitario óptimo en el momento de la facturación por llamada:

| Método de compra/pago | Precio unitario aproximado de Credits | Descripción |
| - | - | - |
| Entrada / Recarga pequeña | Aproximadamente `$0.13 / Credit` | Precio de lista, precio unitario al comprar Credits en pequeñas cantidades |
| Entrada / Nivel óptimo | `$0.095215 / Credit` | Precio más barato |
| **X402 pago por llamada** | **`$0.095215 / Credit`** | **Siempre igual al precio unitario óptimo** |

En otras palabras, X402 liquida cada llamada al precio unitario óptimo de Credits. Los usuarios que compran Credits con recargas pequeñas tendrán un precio más alto que X402; solo los usuarios que recargan grandes cantidades tendrán un precio igual al de X402.

## Dos Formas de Precio: `exact` y `upto`

En la respuesta 402 de X402, `maxAmountRequired` es el monto que debes firmar. Tiene dos formas:

* **`exact` (precio fijo)**: El precio se puede determinar antes de procesar la solicitud (imágenes, videos, música, búsqueda, pago de pedidos). `maxAmountRequired = Costo en Credits de esta llamada × 0.095215`, es decir, el monto a pagar por esta llamada (coincide con `cost.amount` en la respuesta exitosa).
* **`upto` (medición posterior al uso)**: Interfaces como la de completado de chat donde "solo se sabe cuántos tokens se usaron al final de la respuesta". `maxAmountRequired` es un **límite** (convertido según el límite establecido por este modelo: límite en Credits × 0.095215), liquidándose realmente según el uso real, sin exceder el límite.

Para detalles del protocolo sobre estos dos esquemas, consulta [`exact` y `upto` esquemas de facturación](https://platform.acedata.cloud/documents/x402-metered-upto). A continuación, solo se hablará de precios.

## Precio de Chat (completado de chat)

El completado de chat se mide como `upto`: se factura según el uso real de tokens de prompt / completion. El precio por millón (1M) de tokens = `Costo en Credits de este modelo por 1M de tokens × 0.095215`, que coincide completamente con el precio en USD mostrado en el directorio de modelos de la plataforma (`/api/v1/models?with_pricing=true`).

La siguiente tabla muestra los precios reales (tomados del directorio de modelos, según la tasa de X402), en USD / 1M de tokens:

| Modelo | Entrada / 1M | Salida / 1M | Límite `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） |

Notas:

* La tabla muestra el precio unitario medido por token; el costo de una solicitud = tokens de entrada × precio unitario de entrada + tokens de salida × precio unitario de salida.
* El límite `upto` es el monto máximo que se permite firmar en una solicitud para ese modelo; no es el monto real a deducir, la gran mayoría de las solicitudes están muy por debajo del límite.
* El límite solo determina "cuánto se puede deducir como máximo", la liquidación real se calcula según el uso de tokens.

### Ejemplo: Cotización y deducción coinciden (`exact`)

A continuación se muestra una **llamada de pago real** iniciada con el cliente oficial X402Client a `serp/google` (Base `exact`). Demuestra la coincidencia de los tres: cotización 402, monto firmado y el `cost` devuelto en la respuesta exitosa.

```text theme={null}
# 1) Solicitud no pagada -> 402, obtén la cotización (sin deducción)
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215, redondeado hacia abajo a atomic = 952

# 2) Firma del monedero de 952 atomic como PAYMENT-SIGNATURE, reintenta
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 precio = el costo de créditos de esta llamada × `0.095215`, y el precio es **el mismo** que el de los créditos normales, solo que se liquida en USDC en la cadena.
* `0.095215`/Crédito es el **mejor nivel** (grandes cantidades) del precio por crédito; la compra de créditos en pequeñas cantidades tiene un precio por crédito más alto, por lo que X402 automáticamente obtiene el mejor precio.
* La cantidad firmada en la interfaz `exact` (imágenes / videos / música / búsqueda / pedidos) es el monto a pagar; la interfaz `upto` (chat) firma el límite, liquidándose según el uso real.
* El precio autoritativo se basa en el `maxAmountRequired` devuelto por 402: `exact` es el monto a pagar (coincide con `cost.amount` de la respuesta exitosa, ya se ha probado); `upto` es el límite, el `cost.amount` de la respuesta exitosa es el monto real liquidado según el uso (≤ límite).

## Documentos relacionados

| Documento | Enlace |
| - | - |
| Guía de integración X402 (visión general) | [Guía de integración X402](https://platform.acedata.cloud/documents/x402-integration) |
| Comenzar rápidamente | [X402 Comenzar rápidamente](https://platform.acedata.cloud/documents/x402-quickstart) |
| Planes de facturación `exact` y `upto` | [Descripción de planes de facturación](https://platform.acedata.cloud/documents/x402-metered-upto) |
| Redes y métodos de pago | [Redes y métodos de pago](https://platform.acedata.cloud/documents/x402-networks) |
| Tutorial de pago de pedidos | [Tutorial de pago de pedidos](https://platform.acedata.cloud/documents/x402-order-payment) |


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