acedatacloud ansvarar för API-anrop, och acedatacloud-x402 ansvarar för att signera begärandehuvudet PAYMENT-SIGNATURE.
Källkod och paketadresser:
- SDK-lagringsplats: https://github.com/AceDataCloud/SDK
- X402 Client-lagringsplats: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
Installera beroenden
upto måste du även köra Permit2 approve CLI en gång, och denna CLI är beroende av web3:
- Både
acedatacloudochacedatacloud-x402kan installeras och importeras från PyPI. pip install 'acedatacloud-x402[cli]'inkluderar CLI:napprove-permit2, som används för förauktorisering avupto.
Base-exempel
Exemplet nedan behöver ingen API-token. Plånbokens privata nyckel används endast för lokal signering och skickas inte till Ace Data Cloud.dict, så exemplet använder res["choices"][0]["message"]["content"]. Anta inte direkt att den nödvändigtvis har attributet .choices.
Solana-exempel
Solana använder en base58-kodad secret key:TransferChecked-transaktion och lägger sedan transaktionssignaturen i PAYMENT-SIGNATURE-envelope.
Solana paid retry har redan returnerat HTTP 200 och ADC_SOLANA_E2E_OK på produktions-API:t. Denna publika RPC-förfrågan stötte på hastighetsbegränsning, så signaturen på kedjan kunde inte bekräftas stabilt; använd din egen Solana RPC för att fråga denna transaktion när avstämning behövs.
Async-klient
Samma payment handler kan användas förAsyncAceDataCloud:
Använd upto för efterföljande mätning
Den faktiska kostnaden för API:er som chattkompletteringar och modellanrop kanske inte är känd förrän svaret har avslutats. Vid detta tillfälle kan API:t returnera både exact och upto. Om du vill prioritera upto:
upto:
content ADC_BASE_UPTO_OKvisar att begäran faktiskt nådde modell-API:t.settled value 3 atomic USDCvisar attuptoavräknas enligt faktisk användning, i stället för att hela gränsen debiteras.settlement txkan öppnas i BaseScan; spara tx-hash, payer, completion id och begärandesammanfattning vid avstämning.
upto använder Permit2 för att auktorisera en övre gräns, och det faktiska avräkningsbeloppet får inte överstiga denna gräns. Före första användningen måste USDC på målkedjan få en engångs-approve(Permit2, amount).
CLI-sätt:
{"skipped": true} och skickar inte någon upprepad on-chain-transaktion.
Lågnivåsignering
Om du inte använder SDK kan du även direkt anropa lågnivåsigneringsfunktionen:create_x402_payment_handler.
