Перейти до основного вмісту
Python SDK підходить для бекенд-сервісів, завдань обробки даних, автоматизованих Agent і скриптів пакетної обробки. acedatacloud відповідає за API-виклики, а acedatacloud-x402 — за підписування заголовка запиту PAYMENT-SIGNATURE. Вихідний код і адреси пакетів:

Встановлення залежностей

Якщо потрібно використовувати upto, також необхідно одноразово викликати Permit2 approve CLI, цей CLI залежить від web3:
Вивід перевірки встановлення та імпорту в чистому Python venv:
Пояснення результатів:
  • acedatacloud і acedatacloud-x402 можна встановити та імпортувати з PyPI.
  • pip install 'acedatacloud-x402[cli]' додає CLI approve-permit2, який використовується для попередньої авторизації upto.

Приклад Base

Наведений нижче приклад не потребує API Token. Приватний ключ гаманця використовується лише для локального підписування та не надсилається до Ace Data Cloud.
Python SDK наразі повертає dict, тому в прикладі використовується res["choices"][0]["message"]["content"]。Не слід напряму припускати, що він обов’язково має атрибут .choices.

Приклад Solana

Solana використовує secret key у кодуванні base58:
Шлях Solana створює та надсилає SPL USDC транзакцію TransferChecked, а потім поміщає підпис транзакції в envelope PAYMENT-SIGNATURE. Paid retry Solana на production API вже повернув HTTP 200 і ADC_SOLANA_E2E_OK。Цього разу публічний RPC-запит зіткнувся з обмеженням швидкості, тому не вдалося стабільно підтвердити on-chain signature; якщо потрібна звірка, використовуйте власний Solana RPC для запиту цієї транзакції.

Async клієнт

Той самий payment handler можна використовувати для AsyncAceDataCloud:

Використання постоплати upto

Фактична вартість API, таких як завершення чату та виклики моделей, може стати відомою лише після завершення відповіді. У такому разі API може одночасно повертати exact і upto。Якщо потрібно надавати пріоритет upto:
Результат виконання програми Base upto:
Підтвердження on-chain:
Пояснення результатів:
  • content ADC_BASE_UPTO_OK означає, що запит справді надійшов до model API.
  • settled value 3 atomic USDC означає, що upto розраховується за фактичним використанням, а не стягує весь ліміт.
  • settlement tx можна відкрити в BaseScan; для звірки зберігайте tx hash, payer, completion id і підсумок запиту.
upto використовує авторизацію Permit2 для верхнього ліміту, фактична сума розрахунку не може перевищувати цей ліміт. Перед першим використанням необхідно один раз виконати approve(Permit2, amount) для USDC у цільовому ланцюзі. Спосіб CLI:
Програмний спосіб:
Цей helper є ідемпотентним. Якщо allowance вже достатній, він поверне {"skipped": true} і не надсилатиме повторну on-chain транзакцію.

Низькорівневе підписування

Якщо ви не використовуєте SDK, також можна напряму викликати низькорівневу функцію підписування:
Низькорівневі функції підходять для тестування, proxy-рівнів, інтеграції gateway або неофіційних SDK. Для звичайного бізнес-коду пріоритетно використовуйте create_x402_payment_handler.