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에서 설치 및 import할 수 있습니다.pip install 'acedatacloud-x402[cli]'는upto사전 승인을 위한approve-permit2CLI를 포함합니다.
Base 예시
아래 예시는 API Token이 필요하지 않습니다. 지갑 개인 키는 로컬에서만 서명에 사용되며 Ace Data Cloud로 전송되지 않습니다.dict를 반환하므로, 예시는 res["choices"][0]["message"]["content"]를 사용합니다. 이것이 반드시 .choices 속성을 가진다고 직접 가정하지 마세요.
Solana 예시
Solana는 base58로 인코딩된 secret key를 사용합니다: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를 우선 사용하려면:
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 방식:
{"skipped": true}를 반환하며, 온체인 트랜잭션을 반복 전송하지 않습니다.
저수준 서명
SDK를 사용하지 않는 경우에도 저수준 서명 함수를 직접 호출할 수 있습니다:create_x402_payment_handler를 우선 사용하세요.
