X402 ціна пояснення

​

Основні висновки

1 Credit = 0.095215 USDC (тобто 95215 atomic 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 (чат) це верхня межа, фактичний розрахунок за використанням.
• Ціна за токен чату: 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 є реальною сумою, розрахованою за використанням (≤ верхня межа).

​

Відповідні документи