X402 Ценовое описание

​

Основные выводы

1 Credit = 0.095215 USDC (то есть 95215 атомарных USDC, USDC с 6 знаками после запятой)

Цена X402 (USDC) = Стоимость Credits за вызов × 0.095215

​

Базовые цены

​

Связь с обычной ценой Credits

​

Две ценовые формы: exact и upto

• exact (фиксированная цена): цена может быть определена до обработки запроса (изображения, видео, музыка, поиск, оплата заказов). maxAmountRequired = Стоимость Credits за вызов × 0.095215, то есть сумма, подлежащая оплате за этот вызов (соответствует cost.amount в успешном ответе).
• upto (после измерения объема): интерфейсы, такие как дополнение чата, где «количество токенов становится известно только после завершения ответа». maxAmountRequired - это максимум (по установленному лимиту для этой модели: лимит Credits × 0.095215), фактическая сумма рассчитывается по реальному объему и не превышает лимит.

​

Цены на Chat (дополнение чата)

• В таблице указана цена за токен; стоимость одного запроса = входные токены × цена за вход + выходные токены × цена за выход.
• Лимит upto - это максимальная сумма, которую разрешено подписывать за один запрос для этой модели; это не фактический вычет, большинство запросов значительно ниже лимита.
• Лимит определяет только «максимально возможную сумму», фактический расчет производится по объему токенов.

​

Пример: цена и вычет совпадают (exact)

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

​

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 цена = стоимость Credits за этот вызов × 0.095215, и обычная стоимость Credits та же самая, просто расчет производится в цепочном USDC.
• 0.095215/Credit — это оптимальная ставка (крупные) Credits; при небольших пополнениях цена за Credits выше, поэтому X402 автоматически получает оптимальную цену.
• Сумма подписи интерфейса exact (изображение / видео / музыка / поиск / заказ) — это сумма к оплате; сумма подписи интерфейса upto (чат) — это верхний предел, расчет производится по фактическому использованию.
• Авторитетная цена определяется по maxAmountRequired, возвращаемому 402: exact — это сумма к оплате (соответствует cost.amount успешного ответа, уже протестировано); upto — это верхний предел, cost.amount успешного ответа — это реальная сумма, рассчитанная по использованию (≤ верхнего предела).

​

Связанные документы