Zum Hauptinhalt springen
Das Python SDK eignet sich für Backend-Dienste, Datenaufgaben, automatisierte Agents und Batch-Skripte. acedatacloud ist für API-Aufrufe zuständig, acedatacloud-x402 ist für das Ausstellen des Request-Headers PAYMENT-SIGNATURE zuständig. Quellcode- und Paketadressen:

Abhängigkeiten installieren

Um upto zu verwenden, muss außerdem einmalig die Permit2-approve-CLI aufgerufen werden; diese CLI hängt von web3 ab:
Installations- und Importprüfungs-Ausgabe einer sauberen Python-venv:
Ergebniserklärung:
  • Sowohl acedatacloud als auch acedatacloud-x402 können von PyPI installiert und importiert werden.
  • pip install 'acedatacloud-x402[cli]' installiert die CLI approve-permit2, die für die vorherige Autorisierung von upto verwendet wird.

Base-Beispiel

Das folgende Beispiel benötigt kein API-Token. Der private Schlüssel der Wallet wird nur lokal signiert und nicht an Ace Data Cloud gesendet.
Das Python SDK gibt derzeit ein dict zurück, daher verwendet das Beispiel res["choices"][0]["message"]["content"]. Gehe nicht direkt davon aus, dass es zwingend ein Attribut .choices hat.

Solana-Beispiel

Solana verwendet einen base58-kodierten Secret Key:
Der Solana-Pfad erstellt und übermittelt eine SPL-USDC-TransferChecked-Transaktion und legt anschließend die Transaktionssignatur in den PAYMENT-SIGNATURE-Envelope. Der kostenpflichtige Solana-Retry hat auf der Produktions-API bereits HTTP 200 und ADC_SOLANA_E2E_OK zurückgegeben. Bei dieser öffentlichen RPC-Abfrage trat Rate Limiting auf, daher konnte die On-Chain-Signatur nicht stabil bestätigt werden; verwende bei Bedarf für den Abgleich deinen eigenen Solana RPC, um diese Transaktion abzufragen.

Async-Client

Derselbe Payment Handler kann für AsyncAceDataCloud verwendet werden:

Nachgelagerte Abrechnung mit upto verwenden

Die tatsächlichen Kosten von APIs wie Chat Completions und Modellaufrufen können möglicherweise erst nach Abschluss der Antwort bestimmt werden. In diesem Fall kann die API gleichzeitig exact und upto zurückgeben. Um upto bevorzugt zu verwenden:
Programmausgabe von Base upto:
On-Chain-Bestätigung:
Ergebniserklärung:
  • content ADC_BASE_UPTO_OK zeigt, dass die Anfrage tatsächlich die Modell-API erreicht hat.
  • settled value 3 atomic USDC zeigt, dass upto nach der tatsächlichen Nutzung abrechnet, anstatt den vollständigen Höchstbetrag abzuziehen.
  • settlement tx kann in BaseScan geöffnet werden; speichere beim Abgleich den Tx-Hash, den Payer, die Completion-ID und die Anfragezusammenfassung.
upto verwendet eine Permit2-Autorisierung für einen Höchstbetrag, und der tatsächlich abgerechnete Betrag darf diesen Höchstbetrag nicht überschreiten. Vor der ersten Verwendung muss für USDC auf der Ziel-Chain einmal approve(Permit2, amount) ausgeführt werden. CLI-Methode:
Programmatische Methode:
Dieser Helper ist idempotent. Wenn die Allowance bereits ausreicht, wird {"skipped": true} zurückgegeben, und es wird keine weitere On-Chain-Transaktion gesendet.

Signierung auf niedriger Ebene

Wenn du das SDK nicht verwendest, kannst du auch direkt die Signierfunktion auf niedriger Ebene aufrufen:
Funktionen auf niedriger Ebene eignen sich für Tests, Proxy-Schichten, Gateway-Integrationen oder nicht offizielle SDKs. Für normalen Geschäftscode sollte vorrangig create_x402_payment_handler verwendet werden.