Passer au contenu principal
Le SDK Python convient aux services backend, aux tâches de données, aux Agents automatisés et aux scripts de traitement par lots. 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 :

Installer les dépendances

Si vous souhaitez utiliser upto, vous devez également appeler une fois la CLI d’approbation Permit2, cette CLI dépend de web3 :
La sortie de vérification de l’installation et des imports dans un venv Python propre :
Explication des résultats :
  • acedatacloud et acedatacloud-x402 peuvent tous deux être installés et importés depuis PyPI.
  • pip install 'acedatacloud-x402[cli]' inclut la CLI approve-permit2, utilisée pour l’autorisation préalable de upto.

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.
Le SDK Python renvoie actuellement un 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 :
Le chemin Solana construit et soumet une transaction SPL USDC 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é avec AsyncAceDataCloud :

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é :
Résultat d’exécution du programme Base upto :
Confirmation on-chain :
Explication des résultats :
  • content ADC_BASE_UPTO_OK indique que la requête est réellement entrée dans l’API du modèle.
  • settled value 3 atomic USDC indique que upto est réglé selon l’utilisation réelle, plutôt que de déduire la limite complète.
  • settlement tx peut ê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 :
Méthode programmatique :
Ce helper est idempotent. Si l’allowance est déjà suffisante, il renverra {"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 :
Les fonctions de bas niveau conviennent aux tests, à la couche proxy, à l’intégration de passerelles ou aux SDK non officiels. Le code métier ordinaire doit utiliser en priorité create_x402_payment_handler.