Основний висновок
X402 не є окремою системою ціноутворення. Кожен виклик API спочатку має вартість у 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
У відповіді X402 зі статусом 402, maxAmountRequired — це сума, яку потрібно підписати. Вона має дві форми:
exact(фіксована ціна):ціну можна визначити до обробки запиту (зображення, відео, музика, пошук, оплата замовлення).maxAmountRequired = вартість виклику в Credits × 0.095215, тобто сума до сплати за цей виклик (збігається зcost.amountу відповіді після успішного виконання).upto(облік використання після завершення):для таких інтерфейсів, як чат-доповнення, де «лише після завершення відповіді відомо, скільки token було використано».maxAmountRequiredє верхньою межею (конвертується на основі встановленого для цієї моделі ліміту: ліміт Credits × 0.095215), фактичний розрахунок здійснюється за реальним використанням і не перевищує цієї межі.
exact та upto. Нижче розглядаються лише ціни.
Ціни Chat (чат-доповнення)
Чат-доповнення використовують облікupto: оплата стягується за фактичне використання token prompt / completion. Ціна за кожен мільйон (1M) token = вартість цієї моделі в Credits за 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у відповіді про успіх є фактичною сумою, розрахованою за використанням (≤ верхньої межі).

