Présentation des SDK
Choisissez un SDK client OpenAI, Anthropic ou Gemini selon le protocole et effectuez les vérifications préalables à l’intégration.
AGTCloud fournit des endpoints compatibles OpenAI, Anthropic et Gemini. Les projets côté serveur utilisant déjà le SDK officiel correspondant peuvent généralement conserver leur mode d’appel principal et remplacer l’adresse API, l’API Key et l’ID du modèle par la configuration AGTCloud.
Un SDK organise les requêtes uniquement selon son propre protocole. Vérifiez les protocoles pris en charge par le modèle avant de choisir, sans déduire la compatibilité de son seul nom.
Choisir un SDK client
| SDK | Protocole | Authentification | Cas d’utilisation |
|---|---|---|---|
| OpenAI SDK | Chat Completions, Responses | Bearer API Key | Projets OpenAI SDK existants, conversations, Typed Items, streaming et appels d’outils |
| Anthropic SDK | Anthropic Messages | x-api-key et Header de version | Projets Anthropic Messages existants, Content Blocks et structure d’outils Anthropic |
| Gemini SDK | Gemini Generate Content | Bearer API Key | Projets Gemini SDK existants, contents, parts et structure de contenu native Gemini |
Les SDK ne convertissent pas automatiquement les protocoles
Les messages ou input OpenAI, les Content Blocks Anthropic et les contents et parts Gemini ont des structures différentes. Choisissez le tutoriel correspondant à votre code métier ; pour une refonte entre protocoles, lisez d’abord Migration depuis les SDK officiels.
Principales différences entre les trois protocoles
| Critère | OpenAI SDK | Anthropic SDK | Gemini SDK |
|---|---|---|---|
| Endpoint principal | Chat Completions, Responses | Messages | Generate Content |
| Entrée de conversation | messages ou input | messages et Content Blocks | contents et parts |
| Sortie de texte ordinaire | Chat Message ou Responses Output Items | Blocs content | candidates[].content.parts |
| Structure du streaming | Chat Delta ou événements response.* | Événements SSE Messages | Stream Generate Content |
| Structure des outils | Function Tools et outils intégrés Responses | tool_use, tool_result | functionCall, functionResponse |
Consultez la Référence API correspondante pour les champs, les énumérations et la structure complète des réponses. Les tutoriels SDK expliquent surtout l’installation, l’initialisation et la lecture des résultats, sans reprendre tous les Schema.
Préparer l’intégration
Créer une API Key
Créez une API Key AGTCloud dans API Keys et conservez-la dans une variable d’environnement côté serveur ou un service de gestion des secrets.
N’inscrivez pas de véritable API Key dans du code de navigateur, un package d’application mobile, un dépôt public, une capture d’écran ou un journal.
Vérifier le modèle et le protocole
Copiez l’ID complet dans le catalogue de modèles et vérifiez le support du protocole et des capacités que vous souhaitez utiliser.
Dans cette rubrique, MODEL_ID désigne un identifiant fictif. Remplacez-le avant tout appel par l’ID d’un modèle accessible à votre API Key.
Choisir un environnement côté serveur
Les SDK Python et TypeScript doivent s’exécuter dans un environnement serveur fiable. Installez la version stable actuelle et figez la version utilisée dans le fichier de verrouillage des dépendances du projet.
Ordre de validation recommandé
- Installez le SDK et vérifiez que l’application peut lire l’API Key.
- Configurez la Base URL donnée par le tutoriel, sans saisir le chemin complet d’un endpoint métier.
- Envoyez une requête sans streaming avec du texte brut et un minimum de champs.
- Vérifiez le texte, l’état de fin et la consommation de Token.
- Validez ensuite le streaming, les outils, le multimodal ou les sorties structurées selon vos besoins.
- Ajoutez des journaux et des tentatives contrôlées pour les délais dépassés, les limites de débit et les erreurs serveur.
La présence d’un protocole ne garantit pas toutes les capacités du modèle
Les modèles utilisant un même protocole peuvent différer en matière de modalités d’entrée, d’outils, de sorties structurées et de streaming. Si un champ n’est pas pris en charge ou si un modèle est indisponible, vérifiez d’abord ses informations et la Référence API correspondante.
Étapes suivantes
- Utilisez OpenAI SDK pour appeler Chat Completions ou Responses.
- Utilisez Anthropic SDK pour appeler Messages.
- Utilisez Gemini SDK pour appeler Generate Content.
- Pour un projet utilisant un SDK officiel, consultez les vérifications de Migration depuis les SDK officiels.
- En cas d’échec, consultez Erreurs et dépannage.