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.
Платный повтор Solana уже вернул HTTP 200 и ADC_SOLANA_E2E_OK в production API. В этом публичном RPC-запросе возникло ограничение частоты, поэтому не удалось стабильно подтвердить on-chain signature; при необходимости сверки используйте свой Solana RPC для запроса этой транзакции.
Async-клиент
Тот же payment handler можно использовать дляAsyncAceDataCloud:
Использование upto для постоплаты по фактическому потреблению
Фактическая стоимость API, таких как чат-дополнения и вызовы моделей, может быть известна только после завершения ответа. В этом случае API может одновременно возвращать exact и upto. Если требуется отдавать приоритет upto:
upto:
content ADC_BASE_UPTO_OKозначает, что запрос действительно поступил в 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.
