Choix du protocole
Choisissez le protocole adapté à votre application et aux fonctionnalités à conserver.
AGTCloud propose plusieurs protocoles pour appeler les modèles de langage. Vous pouvez conserver le SDK et la structure de requête de votre application, ou choisir un autre protocole selon les fonctionnalités nécessaires.
Pour une première intégration, commencez par OpenAI Chat
Si aucun SDK ni protocole particulier n’est requis, utilisez OpenAI Chat Completions pour effectuer votre premier appel.
Qu’est-ce qu’un protocole d’appel ?
Un protocole API définit l’URL de requête, l’authentification, les champs de requête, la structure des réponses et le format des événements de streaming. Chaque protocole utilise ses propres structures ; le client doit envoyer et analyser les données conformément au protocole choisi.
Cette page présente uniquement les protocoles des modèles de langage, et non les API d’image, de vidéo ou d’audio.
Comment choisir un protocole
Le protocole détermine les champs de requête, la structure des réponses et l’organisation des événements de streaming ; le modèle détermine les capacités d’IA utilisées. Pour choisir, procédez dans cet ordre :
Conserver le mode d’appel du projet existant
Un projet existant peut conserver le protocole de son SDK actuel afin de limiter les modifications des requêtes et de l’analyse des réponses.
Identifier les fonctionnalités nécessaires
Si votre application dépend de structures de contenu, d’appels d’outils, d’informations de raisonnement ou d’une gestion d’état particulière, choisissez un protocole capable de représenter ces champs.
Vérifier les modèles disponibles
Consultez le Catalogue de modèles pour vérifier le modèle cible et les autorisations du compte, puis utilisez la référence API correspondante.
Protocoles pris en charge
| Protocole | Cas d’utilisation | Structures principales | API Reference |
|---|---|---|---|
| OpenAI Chat Completions | Conversations générales ou applications OpenAI Chat existantes | messages, choices | Chat Completions |
| OpenAI Responses | Applications utilisant la structure de requête Responses | input, Response Items | OpenAI Responses |
| Anthropic Messages | Applications utilisant le SDK Anthropic ou la structure Messages | messages, Content Blocks | Anthropic Messages |
| Gemini Generate Content | Applications utilisant le SDK Gemini ou la structure Contents/Parts | contents, Parts | Gemini Generate Content |
Les noms de champs et les structures de réponse varient selon le protocole. Construisez les requêtes et analysez les réponses selon la référence API de l’endpoint choisi, sans mélanger les champs de protocoles différents.
Endpoints d’appel
Les URL d’appel suivantes s’adaptent automatiquement au site actuel :
URL de l’endpoint:
POST https://api.agtcloud.cn/v1/chat/completionsURL de l’endpoint:
POST https://api.agtcloud.cn/v1/responsesURL de l’endpoint:
POST https://api.agtcloud.cn/v1/messagesURL de l’endpoint:
POST https://api.agtcloud.cn/v1beta/models/{model}:generateContent
Cas courants
- Projet OpenAI Chat existant : choisissez Chat Completions.
- Projet OpenAI Responses existant : choisissez OpenAI Responses.
- Projet utilisant le SDK Anthropic : choisissez Anthropic Messages.
- Projet utilisant le SDK Gemini : choisissez Gemini Generate Content.
- Aucun mode d’appel existant : commencez par un appel minimal avec Chat Completions.
AGTCloud prend en charge la conversion de protocoles, mais celle-ci ne garantit pas une compatibilité totale des paramètres.
Vérifications avant l’intégration
- Vérifiez l’identifiant du modèle et les autorisations du compte dans le Catalogue de modèles.
- Vérifiez l’endpoint, l’authentification et les champs de requête dans la référence API correspondante.
- Testez dans un environnement de test les requêtes classiques, le streaming ou les appels d’outils réellement utilisés par votre application.