Skip to main content

Ce que vous allez créer

Vous allez envoyer une requête native Gemini POST /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 :
Utilisez x-goog-api-key pour les requêtes HTTP natives Gemini directes :
Utilisez l’URL de base compatible OpenAI uniquement lorsque votre application utilise déjà Chat Completions :

Format natif Gemini

Les requêtes natives Gemini utilisent contents, 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

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.
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.
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.
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