acedatacloud відповідає за API-виклики, а acedatacloud-x402 — за підписування заголовка запиту PAYMENT-SIGNATURE.
Вихідний код і адреси пакетів:
- Репозиторій SDK: https://github.com/AceDataCloud/SDK
- Репозиторій X402 Client: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
Встановлення залежностей
upto, також необхідно одноразово викликати Permit2 approve CLI, цей CLI залежить від web3:
acedatacloudіacedatacloud-x402можна встановити та імпортувати з PyPI.pip install 'acedatacloud-x402[cli]'додає CLIapprove-permit2, який використовується для попередньої авторизаціїupto.
Приклад Base
Наведений нижче приклад не потребує API Token. Приватний ключ гаманця використовується лише для локального підписування та не надсилається до Ace Data Cloud.dict, тому в прикладі використовується res["choices"][0]["message"]["content"]。Не слід напряму припускати, що він обов’язково має атрибут .choices.
Приклад Solana
Solana використовує secret key у кодуванні base58: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:
upto:
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:
{"skipped": true} і не надсилатиме повторну on-chain транзакцію.
Низькорівневе підписування
Якщо ви не використовуєте SDK, також можна напряму викликати низькорівневу функцію підписування:create_x402_payment_handler.
