api.acedata.cloud telles que les complétions de chat, les images, la vidéo, la musique, la recherche, x402, etc., en méthodes fortement typées, évitant ainsi le travail de gestion manuelle des HTTP, SSE, de la pollinisation des tâches, du traitement des erreurs et de la stratégie de réessai.
Ce chapitre est organisé selon l’ordre d’intégration réel : d’abord obtenir le token API dans la console, puis choisir la langue et consulter le chapitre correspondant, et enfin examiner la pollinisation des tâches, les réponses en streaming et les usages avancés de paiement sur la chaîne X402.
Dépôt et paquets
- Code source du SDK (monorepo) : https://github.com/AceDataCloud/SDK
- TypeScript :
@acedatacloud/sdk - Python :
acedatacloud - Go :
github.com/AceDataCloud/SDK/go - Client X402 (TypeScript) :
@acedatacloud/x402-client - Client X402 (Python) :
acedatacloud-x402
Matrice des capacités des trois langages
Les ressources multimédias et la pollinisation des tâches du SDK Go sont actuellement en phase alpha (version pseudov0.0.0-20260505072132-4a3d921f9bb4), la capacité stable estchat.completions. Pour les scénarios multimédias, privilégiez TypeScript ou Python.
Quand utiliser le SDK / MCP / HTTP natif / X402
Le SDK et X402 ne sont pas mutuellement exclusifs : le SDK prend en charge à la fois le chemin « token » et le chemin «
paymentHandler », voir SDK + Hook de paiement X402.
Demande de token API
Pour utiliser le SDK, commencez par demander un token API dans la console Ace Data Cloud - Liste des applications :
Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter, et après vous être connecté, vous serez automatiquement renvoyé à la page actuelle.
Lors de la première demande, un quota gratuit sera offert, vous permettant d’expérimenter gratuitement les divers services AI proposés par Ace Data Cloud.
Copiez le token que vous venez d’obtenir, que nous appellerons {token}.
Variables d’environnement unifiées
Les SDK des trois langages liront automatiquement la même variable d’environnementACEDATACLOUD_API_TOKEN, il est recommandé de l’exporter dans le shell pour que le SDK puisse l’utiliser automatiquement :
- TypeScript :
new AceDataCloud({ apiToken: '{token}' }) - Python :
AceDataCloud(api_token="{token}") - Go :
adc.NewClient(adc.WithAPIToken("{token}"))
Remarque : Le dépôt du projet AceDataCloud utilise conventionnellementACEDATACLOUD_API_KEY(dans.env/ CI), mais ces trois SDK ne reconnaissent queACEDATACLOUD_API_TOKEN. Si votre environnement ne contient queACEDATACLOUD_API_KEY, veuillez le passer explicitement lors de la construction.
Exemples en 30 secondes
Les trois segments de code ci-dessous font la même chose : appelergpt-4o-mini et lui demander de répondre uniquement par ADC_*_OK. Chaque segment est accompagné de résultats d’exécution réels, que vous pouvez reproduire avec votre propre token.
TypeScript
Le SDK déclare actuellement la réponse commeRésultat d’exécution du programme :Record<string, unknown>, à l’exécution, c’est un objet JSON ordinaire, accessible directement par ses champs. Dans les projets TS stricts, si vous rencontrez des erreurs de type, vous pouvez temporairement utiliseras any, ou consulter SDK Pollinisation des tâches et réponses en streaming pour créer un wrapper typé personnalisé.
Python
Le SDK Python retourne actuellement unRésultat du programme :dict, donc utilisezres["id"]au lieu deres.id. Cela diffère deopenai-python, il faut en tenir compte lors de la migration.
Go
La réponse du SDK Go est uniformément unRésultat du programme :map[string]any, sans struct de type fort, nécessitant des assertions de type. Tous les accesseurs de ressources sont des chaînes de méthodes :client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, usage proviennent tous de la même source : après authentification via PlatformGateway → API compatible OpenAI cible → enregistrement de facturation. Le champ content est la sortie réelle du modèle, l’utilisation d’un identifiant fixe ADC_*_OK est destinée à prouver que la réponse n’a pas été altérée par le SDK.
Ordre de lecture recommandé
- Tutoriel d’intégration du SDK TypeScript —— Code pouvant être exécuté après
npm install. - Tutoriel d’intégration du SDK Python —— Trois méthodes : synchrone, asynchrone, en streaming.
- Tutoriel d’intégration du SDK Go —— Style Go avec
context.Contextet flux de canal. - Polling des tâches SDK et réponses en streaming —— Différences d’unités TaskHandle, détails d’implémentation SSE, stratégie de réessai.
- SDK + Hooks de paiement X402 —— Pas de token, règlement basé sur les appels en chaîne.
Comment vérifier le solde restant
Vous pouvez vérifier le solde restant de votre compte via Console Ace Data Cloud - Liste des applications. Vous pouvez consulter tout l’historique d’utilisation et les détails de facturation via Console Ace Data Cloud - Historique d’utilisation.En savoir plus
- 📦 Code source du SDK monorepo
- 🔌 Guide d’intégration X402
- 🛠 Tutoriel sur les serveurs MCP
- 📊 Liste des services et tarification

