Перейти к основному содержанию
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. Платный повтор 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:
Результат выполнения программы Base 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:
Способ через программу:
Этот helper идемпотентен. Если allowance уже достаточно, он вернёт {"skipped": true} и не будет повторно отправлять on-chain транзакцию.

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

Если вы не используете SDK, можно напрямую вызывать низкоуровневую функцию подписи:
Низкоуровневые функции подходят для тестирования, прокси-слоя, интеграции шлюзов или неофициальных SDK. Для обычного бизнес-кода приоритетно использовать create_x402_payment_handler.