Skip to main content
Ace Data Cloud propose des SDK clients officiels en TypeScript / Python / Go, encapsulant les capacités de 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

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 pseudo v0.0.0-20260505072132-4a3d921f9bb4), la capacité stable est chat.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’environnement ACEDATACLOUD_API_TOKEN, il est recommandé de l’exporter dans le shell pour que le SDK puisse l’utiliser automatiquement :
Vous pouvez également le passer explicitement lors de la construction du client, les noms de paramètres correspondants pour les trois langages sont :
  • 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 conventionnellement ACEDATACLOUD_API_KEY (dans .env / CI), mais ces trois SDK ne reconnaissent que ACEDATACLOUD_API_TOKEN. Si votre environnement ne contient que ACEDATACLOUD_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 : appeler gpt-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 comme 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 utiliser as any, ou consulter SDK Pollinisation des tâches et réponses en streaming pour créer un wrapper typé personnalisé.
Résultat d’exécution du programme :

Python

Le SDK Python retourne actuellement un dict, donc utilisez res["id"] au lieu de res.id. Cela diffère de openai-python, il faut en tenir compte lors de la migration.
Résultat du programme :

Go

La réponse du SDK Go est uniformément un 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(...).
Résultat du programme :
Dans les réponses des trois langages, 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é

  1. Tutoriel d’intégration du SDK TypeScript —— Code pouvant être exécuté après npm install.
  2. Tutoriel d’intégration du SDK Python —— Trois méthodes : synchrone, asynchrone, en streaming.
  3. Tutoriel d’intégration du SDK Go —— Style Go avec context.Context et flux de canal.
  4. 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.
  5. 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