메인 콘텐츠로 건너뛰기
Python SDK는 백엔드 서비스, 데이터 작업, 자동화 Agent 및 배치 스크립트에 적합합니다. acedatacloud는 API 호출을 담당하고, acedatacloud-x402는 PAYMENT-SIGNATURE 요청 헤더 발급을 담당합니다. 소스 코드 및 패키지 주소:

종속성 설치

upto를 사용하려면 Permit2 approve CLI를 한 번 호출해야 하며, 이 CLI는 web3에 의존합니다:
깨끗한 Python venv의 설치 및 import 확인 출력:
결과 설명:
  • acedatacloud와 acedatacloud-x402는 모두 PyPI에서 설치 및 import할 수 있습니다.
  • pip install 'acedatacloud-x402[cli]'는 upto 사전 승인을 위한 approve-permit2 CLI를 포함합니다.

Base 예시

아래 예시는 API Token이 필요하지 않습니다. 지갑 개인 키는 로컬에서만 서명에 사용되며 Ace Data Cloud로 전송되지 않습니다.
Python SDK는 현재 dict를 반환하므로, 예시는 res["choices"][0]["message"]["content"]를 사용합니다. 이것이 반드시 .choices 속성을 가진다고 직접 가정하지 마세요.

Solana 예시

Solana는 base58로 인코딩된 secret key를 사용합니다:
Solana 경로는 SPL USDC TransferChecked 트랜잭션을 구성하고 제출한 다음, 트랜잭션 서명을 PAYMENT-SIGNATURE envelope에 넣습니다. Solana paid retry는 프로덕션 API에서 이미 HTTP 200과 ADC_SOLANA_E2E_OK를 반환했습니다. 이번 공개 RPC 조회에서는 속도 제한이 발생하여 온체인 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를 사용하여 상한을 승인하며, 실제 정산 금액은 해당 상한을 초과할 수 없습니다. 처음 사용하기 전에 대상 체인의 USDC에 대해 approve(Permit2, amount)를 한 번 수행해야 합니다. CLI 방식:
프로그램 방식:
이 helper는 멱등적입니다. allowance가 이미 충분하면 {"skipped": true}를 반환하며, 온체인 트랜잭션을 반복 전송하지 않습니다.

저수준 서명

SDK를 사용하지 않는 경우에도 저수준 서명 함수를 직접 호출할 수 있습니다:
저수준 함수는 테스트, 프록시 계층, 게이트웨이 통합 또는 공식 SDK가 아닌 경우에 적합합니다. 일반 비즈니스 코드에서는 create_x402_payment_handler를 우선 사용하세요.