API Reference
Trouvez les API AGTCloud selon votre tâche et consultez les endpoints, paramètres, réponses et outils de test en ligne.
La référence API AGTCloud présente les adresses de requête, l’authentification, les Schema des paramètres, les structures de réponse, les exemples de code et les tests en ligne de chaque interface. Commencez par trouver l’interface correspondant à votre tâche, puis ouvrez la page de l’endpoint pour consulter tous les champs.
Votre premier appel API
Si vous n’avez pas encore de clé API ou n’avez pas défini la Base URL et l’identifiant du modèle, consultez d’abord le démarrage rapide. Si la configuration de base est terminée, choisissez directement l’interface souhaitée ci-dessous.
Fonctionnalités principales
Le texte, les images et la vidéo constituent les principales entrées de la référence API actuelle. Une même fonctionnalité peut proposer un format compatible OpenAI, un format fournisseur ou un format de tâche asynchrone AGTCloud. Choisissez selon votre SDK et votre modèle cible.
Texte et conversation
Générez du texte et gérez des conversations à plusieurs tours avec Chat Completions, Responses, Anthropic Messages, Gemini Generate Content et d’autres protocoles.
Génération d’images
Créez ou modifiez des images, générez des variantes, ou utilisez les interfaces de tâches asynchrones Grok Image et Midjourney.
Génération de vidéos
Créez et consultez des vidéos avec Video Generations de la plateforme, OpenAI Videos, Grok, Kling, Vidu et d’autres interfaces.
Autres interfaces
Traitement audio
Effectuez la synthèse vocale, la transcription et la traduction audio, la reconnaissance vocale asynchrone et le traitement des voix.
Embeddings
Convertissez du texte ou des tokens en vecteurs pour la recherche sémantique, le clustering et le calcul de similarité.
Rerank
Reclassez les documents candidats selon leur pertinence avec les formats Jina, Cohere ou Xinference.
Realtime
Traitez le texte, l’audio et les appels de fonctions en temps réel via des événements WebSocket.
Choisir selon le type d’interface
Le transport et le mode de récupération des résultats varient selon la fonctionnalité. Le client doit traiter les données selon le Content-Type et le type de réponse indiqués sur la page de l’endpoint.
| Type d’interface | Cas courants | Traitement côté client |
|---|---|---|
| JSON synchrone | Texte ordinaire, Embedding, Rerank | Analyser la réponse JSON une fois la requête terminée |
| Réponse SSE en streaming | Génération en streaming avec Chat, Responses et Gemini | Lire les événements en continu jusqu’à la fin du flux |
| Tâche asynchrone | Vidéo, Midjourney | Conserver l’identifiant de tâche et consulter son état et ses résultats |
| Téléversement Multipart | Édition d’images, transcription audio | Téléverser les fichiers et champs de formulaire selon les exigences de l’endpoint |
| Réponse binaire | Téléchargement de contenu vidéo ou audio | Enregistrer le fichier selon le type de média de la réponse |
| WebSocket | Realtime | Maintenir une connexion et échanger des événements en continu |
Lire une page d’endpoint
Vérifier l’Endpoint et l’authentification
Vérifiez la Method, le Path, l’adresse API et les Headers d’authentification requis. Consultez les conventions communes pour les règles générales.
Choisir un scénario de requête
Choisissez l’exemple le plus proche de votre tâche, puis ajustez les champs du Request Body, des Path Parameters ou des Query Parameters.
Vérifier les réponses et les erreurs
Analysez le résultat selon le statut HTTP et le type de média. En cas d’échec, conservez les informations d’erreur expurgées des données sensibles et le Request ID s’il est présent, puis consultez le dépannage.
Vérifier avec Try It
Le test en ligne utilise l’adresse API affichée sur cette page. Saisissez la clé API de votre compte et choisissez un modèle disponible dans la liste. N’utilisez pas de clé de production durable sur un appareil partagé.
Règles communes avant l’intégration
- Si vous hésitez entre les protocoles textuels, consultez d’abord le choix du protocole.
- Remplacez
MODEL_IDdans les exemples par un identifiant de modèle réellement disponible pour votre clé API. - Une fonctionnalité de même nom peut prendre en charge différents champs selon le modèle et le protocole ; fiez-vous à l’endpoint, aux droits du compte et à la réponse réelle.
- Ne codez jamais une clé API en dur dans le frontend du navigateur ou dans un paquet client de production. Try It sert uniquement au dépannage temporaire ; n’inscrivez pas de clé dans un dépôt public, une capture d’écran ou un journal.
Pour continuer : conventions communes · Clé API, Base URL et authentification