Hoppa till huvudinnehåll
Python SDK passar för backendtjänster, datauppgifter, automatiserade agenter och batchskript. acedatacloud ansvarar för API-anrop, och acedatacloud-x402 ansvarar för att signera begärandehuvudet PAYMENT-SIGNATURE. Källkod och paketadresser:

Installera beroenden

Om du vill använda upto måste du även köra Permit2 approve CLI en gång, och denna CLI är beroende av web3:
Installations- och importkontrollutdata för en ren Python venv:
Resultatförklaring:
  • Både acedatacloud och acedatacloud-x402 kan installeras och importeras från PyPI.
  • pip install 'acedatacloud-x402[cli]' inkluderar CLI:n approve-permit2, som används för förauktorisering av upto.

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.
Python SDK returnerar för närvarande en 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:
Solana-flödet bygger och skickar en SPL USDC-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ör AsyncAceDataCloud:

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:
Programkörningsresultat för Base upto:
Bekräftelse på kedjan:
Resultatförklaring:
  • content ADC_BASE_UPTO_OK visar att begäran faktiskt nådde modell-API:t.
  • settled value 3 atomic USDC visar att upto avräknas enligt faktisk användning, i stället för att hela gränsen debiteras.
  • settlement tx kan ö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:
Programsätt:
Denna helper är idempotent. Om allowance redan är tillräcklig returnerar den {"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:
Lågnivåfunktioner passar för testning, proxylager, gateway-integrationer eller inofficiella SDK:er. Vanlig affärskod bör i första hand använda create_x402_payment_handler.