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:
- SDK-Repository: https://github.com/AceDataCloud/SDK
- X402-Client-Repository: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
Abhängigkeiten installieren
upto zu verwenden, muss außerdem einmalig die Permit2-approve-CLI aufgerufen werden; diese CLI hängt von web3 ab:
- Sowohl
acedatacloudals auchacedatacloud-x402können von PyPI installiert und importiert werden. pip install 'acedatacloud-x402[cli]'installiert die CLIapprove-permit2, die für die vorherige Autorisierung vonuptoverwendet 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.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: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ürAsyncAceDataCloud 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:
upto:
content ADC_BASE_UPTO_OKzeigt, dass die Anfrage tatsächlich die Modell-API erreicht hat.settled value 3 atomic USDCzeigt, dassuptonach der tatsächlichen Nutzung abrechnet, anstatt den vollständigen Höchstbetrag abzuziehen.settlement txkann 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:
{"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:create_x402_payment_handler verwendet werden.
