Ce que vous allez créer
Vous allez envoyer une requête native GeminiPOST /v1beta/models/\{model\}:generateContent, puis la comparer avec l’option compatible OpenAI POST /v1/chat/completions pour les applications qui utilisent déjà des formats de requête Chat Completions.
Prérequis
- Une clé API CometAPI stockée dans
COMETAPI_KEY - Un model ID de modèle de texte Gemini depuis la page Models
curl, Python 3.10+ ou Node.js 18+
Clé API, URL de base, authentification
Utilisez l’endpoint natif Gemini lorsque vous voulez des champs de requête Gemini :x-goog-api-key pour les requêtes HTTP natives Gemini directes :
Format natif Gemini
Les requêtes natives Gemini utilisentcontents, parts et generationConfig. Utilisez ce chemin lorsque vous avez besoin de champs spécifiques à Gemini comme les contrôles de réflexion, les parties média, l’ancrage Google Search ou les opérateurs de Streaming natifs.
Option compatible OpenAI
Utilisez la route compatible OpenAI lorsque vous migrez un SDK OpenAI existant ou une application Chat Completions existante et que vous n’avez pas besoin des champs de requête natifs Gemini.Explication du flux
Ne mélangez pas les deux formats de requête. Les champs natifs Gemini comme
contents et generationConfig appartiennent à la route generateContent. Les champs Chat Completions comme messages appartiennent à la route compatible OpenAI.
Dépannage / FAQ
Par quel chemin dois-je commencer
Par quel chemin dois-je commencer
Commencez avec le
generateContent natif Gemini lorsque vous créez un nouveau workflow Gemini. Utilisez la route compatible OpenAI lorsqu’une application existante dépend déjà du SDK OpenAI ou de formats de requête Chat Completions.Les champs natifs Gemini échouent sur Chat Completions
Les champs natifs Gemini échouent sur Chat Completions
Envoyez les requêtes
contents, parts, generationConfig et streamGenerateContent vers l’endpoint natif Gemini. La route compatible OpenAI attend messages et les paramètres Chat Completions.Le model ID Gemini échoue
Le model ID Gemini échoue
Confirmez que le model ID est disponible pour votre compte et prend en charge la route que vous appelez. Utilisez la page Models pour trouver les model IDs actuels.
Le SDK pointe vers le mauvais service
Le SDK pointe vers le mauvais service
Pour les requêtes du SDK Google GenAI, définissez l’URL de base sur
https://api.cometapi.com. Pour les requêtes du SDK OpenAI, définissez base_url en Python ou baseURL en Node.js sur https://api.cometapi.com/v1.Étapes suivantes
- Utilisez la référence de l’API native Gemini pour tous les champs de requête et de réponse
generateContent. - Consultez la référence de l’API Chat Completions pour le format de requête compatible OpenAI.
- Configurez les clients SDK OpenAI dans Utiliser CometAPI avec les SDK OpenAI.
- Listez les modèles disponibles avec Lister les modèles CometAPI disponibles.
- Ajoutez la gestion des nouvelles tentatives et des limites de débit avec Codes d’erreur et stratégie de nouvelle tentative.