acedatacloud est responsable des appels API, et acedatacloud-x402 est responsable de la signature de l’en-tête de requête PAYMENT-SIGNATURE.
Adresses du code source et des packages :
- Dépôt SDK : https://github.com/AceDataCloud/SDK
- Dépôt X402 Client : https://github.com/AceDataCloud/X402Client
- SDK PyPI : https://pypi.org/project/acedatacloud/
- X402 Client PyPI : https://pypi.org/project/acedatacloud-x402/
Installer les dépendances
upto, vous devez également appeler une fois la CLI d’approbation Permit2, cette CLI dépend de web3 :
acedatacloudetacedatacloud-x402peuvent tous deux être installés et importés depuis PyPI.pip install 'acedatacloud-x402[cli]'inclut la CLIapprove-permit2, utilisée pour l’autorisation préalable deupto.
Exemple Base
L’exemple suivant ne nécessite pas de Token API. La clé privée du portefeuille est uniquement utilisée pour signer localement et ne sera pas envoyée à Ace Data Cloud.dict, l’exemple utilise donc res["choices"][0]["message"]["content"]. Ne supposez pas directement qu’il possède nécessairement un attribut .choices.
Exemple Solana
Solana utilise une clé secrète encodée en base58 :TransferChecked, puis place la signature de la transaction dans l’enveloppe PAYMENT-SIGNATURE.
La nouvelle tentative payante Solana a renvoyé HTTP 200 et ADC_SOLANA_E2E_OK sur l’API de production. Cette requête RPC publique a rencontré une limitation de débit et n’a pas permis de confirmer de manière stable la signature on-chain ; lorsque vous devez effectuer un rapprochement, veuillez utiliser votre propre RPC Solana pour interroger cette transaction.
Client Async
Le même payment handler peut être utilisé avecAsyncAceDataCloud :
Utiliser la facturation différée upto
Le coût réel d’API telles que les complétions de chat et les appels de modèles peut ne être connu qu’après la fin de la réponse. Dans ce cas, l’API peut renvoyer simultanément exact et upto. Si vous souhaitez utiliser upto en priorité :
upto :
content ADC_BASE_UPTO_OKindique que la requête est réellement entrée dans l’API du modèle.settled value 3 atomic USDCindique queuptoest réglé selon l’utilisation réelle, plutôt que de déduire la limite complète.settlement txpeut être ouvert dans BaseScan ; lors du rapprochement, conservez le hash tx, le payer, l’id de complétion et le résumé de la requête.
upto utilise l’autorisation Permit2 pour autoriser une limite supérieure, et le montant réel du règlement ne peut pas dépasser cette limite. Avant la première utilisation, vous devez effectuer une fois approve(Permit2, amount) pour l’USDC sur la chaîne cible.
Méthode CLI :
{"skipped": true} et n’enverra pas à nouveau de transaction on-chain.
Signature de bas niveau
Si vous n’utilisez pas le SDK, vous pouvez également appeler directement la fonction de signature de bas niveau :create_x402_payment_handler.
