X402 Precio Explicación

​

Conclusión Principal

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

Precio X402 (USDC) = Costo en Credits de esta llamada × 0.095215

​

Base de Valoración

​

Relación con el Precio Unitario de Credits Normales

​

Dos Formas de Precio: exact y upto

• 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.

​

Precio de Chat (completado de chat)

• 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)

# 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"}

​

upto 报价计算（聊天）

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

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

​

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

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

​

订单支付价格

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

​

如何实时获取价格

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

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