Основной вывод
X402 — не отдельная система ценообразования. Каждый вызов API изначально имеет стоимость в Credits, которая является единым источником цены, общим для всех способов оплаты (списание Credits через API Token, баланс аккаунта, ончейн-платёж X402). X402 лишь конвертирует эту стоимость в Credits в ончейн USDC по фиксированному курсу:
1 Credit = 0.095215 USDC (то есть 95215 atomic USDC, USDC имеет 6 знаков после запятой)
То есть:
Основа расчёта цены
Конвертация выполняется платформой централизованно, а сумма одинакова для всех поддерживаемых сетей (Base, Solana); между сетями различаются только контракт актива и способ подписи, цена одинакова.
Связь с обычной ценой Credits
Credits на платформе продаются по ступенчатой модели «чем больше объём, тем ниже цена за единицу». При оплате X402 за вызов всегда используется цена оптимального тарифа:
Другими словами, X402 рассчитывает каждый вызов по цене Credits оптимального тарифа. У пользователей, покупающих Credits небольшими пополнениями, цена за единицу будет выше, чем при X402; только у пользователей с крупными пополнениями цена за единицу совпадает с X402.
Две формы цены: exact и upto
В ответе 402 X402 поле maxAmountRequired — это сумма, которую вы должны подписать. Она имеет две формы:
exact(фиксированная цена): цена может быть определена до обработки запроса (изображения, видео, музыка, поиск, оплата заказа).maxAmountRequired = Credits cost of this call × 0.095215, то есть сумма к оплате за этот вызов (совпадает сcost.amountв успешном ответе).upto(измерение потребления после выполнения): для интерфейсов вроде chat completions, где «количество использованных token становится известно только после завершения ответа».maxAmountRequired— это верхний предел (конвертируется из установленного для этой модели лимита: лимит Credits × 0.095215), фактический расчёт производится по реальному потреблению и не превышает верхний предел.
exact и upto. Ниже рассматриваются только цены.
Цены Chat (чат-дополнений)
Чат-дополнения используют измерениеupto: оплата взимается по фактическому потреблению token prompt / completion. Цена за миллион (1M) token = Credits cost of the model per 1M token × 0.095215, что полностью совпадает с USD-ценой за единицу, отображаемой в публичном каталоге моделей платформы (/api/v1/models?with_pricing=true).
В таблице ниже указаны реальные цены (взяты из каталога моделей, рассчитаны по курсу X402), единица измерения — USD / 1M token:
Примечания:
- В таблице указаны цены за единицу при измерении по token; стоимость одного запроса = входные token × цена ввода за единицу + выходные token × цена вывода за единицу.
- Лимит
upto— это максимальная сумма, разрешённая для подписи в одном запросе для этой модели; это не фактическое списание, большинство запросов значительно ниже лимита. - Лимит определяет только «сколько может быть списано максимально», фактический расчёт выполняется по потреблению token.
Пример: котировка и списание совпадают (exact)
Ниже приведён один реальный платный вызов к serp/google, выполненный официальным X402Client (Base exact). Он демонстрирует совпадение трёх величин: котировки 402, суммы подписи и возвращаемого в успешном ответе cost.
cost.amount (0.000952 USDC) полностью соответствует котировке 402 и Credits × 0.095215. Поле settlement — это статус расчёта данного платежа (authorized = авторизован); ончейн-расчёт обрабатывается платформой, механизм описан в схемах тарификации exact и upto。
Расчёт котировки upto (чат)
Чат измеряется в токенах. Котировка (не верхний предел) для одного запроса рассчитывается по следующей формуле (на примере gpt-4o-mini):
upto (для gpt-4o-mini 1 Credit = 95215 atomic), это лишь максимально возможная сумма списания; фактическая котировка данного запроса (в приведённом примере около $0.0001) значительно ниже верхнего предела, расчёт производится по использованию токенов. Механизм ончейн-расчёта upto описан в схемах тарификации exact и upto。
Цены на другие сервисы (фиксированная цена exact)
Для таких API, как изображения, видео, музыка и поиск, цена может быть определена при запросе, используется exact. В таблице ниже приведены реальные цены, полученные из 402 maxAmountRequired, возвращаемого онлайн-API для неоплаченных запросов (запрос котировки не приводит к списанию средств):
Примечания:
- Цена одного и того же сервиса меняется в зависимости от модели, разрешения, длительности и действия (особенно для видео). В таблице выше указаны реальные значения для одного набора параметров, только для ориентира по масштабу.
- Для таких API с фиксированной ценой (
exact)maxAmountRequiredв ответе 402 данного запроса является суммой к оплате за этот запрос (совпадает сcost.amountуспешного ответа, что уже проверено в предыдущем разделе). - Каждая цена получается путём округления вниз
Credits × 0.095215до единицы atomic (см. базу расчёта выше), используется та же конвертация, что и для чата. Из-за представления чисел с плавающей точкой и округления отдельные значения могут отличаться от простого произведения на 1 atomic ($0.000001); всегда ориентируйтесь на значение, возвращённое 402.
Цена оплаты заказа
При оплате заказов через консоль X402 (покупка пакета / пополнение Credits) ориентируйтесь на цену, отображаемую на странице заказа, аamount в 402 является окончательным основанием для подписи. Оплата заказа проходит через API платформы и требует токена аккаунта; подробности см. в руководстве по оплате заказа。
Реальный пример из руководства по оплате заказа (покупка 10 Credits):
0.095215/Credit; оплата заказа производится по цене пакета, а разница между ценой создания и суммой окончательного расчёта определяется руководством по оплате заказа。
Как получать цены в реальном времени
Цены меняются в зависимости от модели и параметров, получайте их программно в реальном времени, не хардкодьте:- Цена за вызов: отправьте целевому API запрос без
PAYMENT-SIGNATURE(а также безAuthorization) и прочитайте возвращённый 402accepts[].maxAmountRequired. На этом этапе средства не списываются. Для APIexactэто окончательная цена; для APIupto(чат) это верхний предел, а фактический расчёт производится по использованию. - Цена чата за токен:
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).
Итог
- Цена X402 = стоимость Credits за этот вызов ×
0.095215, это та же цена, что и при обычном биллинге Credits, только расчёт производится в ончейн USDC. 0.095215/Credit — это лучший тариф (для крупных объёмов) платформы за Credits; при небольших пополнениях цена Credits выше, поэтому X402 автоматически предоставляет лучшую цену.- Для интерфейсов
exact(изображения / видео / музыка / поиск / заказы) сумма подписи является суммой к оплате за этот вызов; для интерфейсовupto(чат) подписывается верхний лимит, а расчёт производится по фактическому использованию. - Авторитетной ценой является
maxAmountRequired, возвращаемый 402: дляexactэто сумма к оплате (совпадает сcost.amountв успешном ответе, проверено на практике); дляuptoэто верхний лимит, аcost.amountв успешном ответе является фактической суммой, рассчитанной по использованию (≤ верхнего лимита).

