Gemini API au format compatible OpenAI

Utiliser Gemini API en direct, c'est avoir un compte Google, créer une clé dans Google AI Studio, puis payer selon la facturation de Google. Ici, cette partie est remplacée : vous rechargez un solde chez RelaySwitch, vous utilisez une clé RelaySwitch, et la requête part vers une passerelle qui la transmet à Gemini. Pour votre code, seules l'adresse et la clé changent ; l'id du modèle reste l'id Gemini.

Gemini a son propre format de requête (generateContent), mais la plupart des outils et du code existants sont écrits pour OpenAI Chat Completions. Google fournit lui-même une couche compatible OpenAI et précise dans sa documentation que cette prise en charge est encore en bêta. La démarche est la même ici : chaque id Gemini du tableau des prix peut être appelé au format OpenAI, si bien que porter du code OpenAI vers Gemini revient à changer le champ model.

Vérifiez d'abord la clé et l'adresse avec curl. La clé s'envoie dans l'en-tête Authorization: Bearer, et par rapport à un exemple OpenAI classique, seuls la Base URL, la clé et model changent.

La Base URL s'écrit avec /v1, puis le SDK ajoute lui-même /chat/completions. Pour le streaming, mettez stream à true ; la réponse arrive en server-sent events, au même format que chez OpenAI. Le nombre de tokens dans usage est le même que celui inscrit sur le reçu.

Le code écrit d'après la documentation compatible OpenAI de Google utilise déjà le SDK OpenAI : le corps des requêtes n'a donc pas à changer. Les champs propres à Gemini que la documentation de Google fait passer par extra_body ne sont pas testés un à un sur cette page ; si vous les utilisez, testez d'abord avec une requête et vérifiez que la facturation du reçu correspond à ce que vous attendez.

Seules trois choses changent :

• base_url : de l'adresse de la documentation Google à https://api.relayswitch.io/v1.
• api_key : de la clé Google AI Studio à une clé RelaySwitch qui commence par sk-relay-.
• model : faites correspondre l'id avec le tableau des prix de cette page et utilisez celui qui y figure à ce moment-là ; un id erroné reçoit 404 model_not_found.

Un programme déjà écrit au format de requête de Google n'a pas à être réécrit, tant que l'id Gemini utilisé sert cette route. Le chemin est /v1beta/models/{model}:generateContent, directement derrière https://api.relayswitch.io, sans /v1. La clé s'envoie dans l'en-tête x-goog-api-key, pas dans l'URL : une clé placée en paramètre de requête est refusée par la passerelle. Le corps de la requête et de la réponse suit la structure de Google, contents en entrée et candidates en sortie.

Les messages d'erreur suivent chacun leur format. Au format OpenAI, le code est dans error.code ; au format natif, la forme suit celle de Google, par exemple un 401 avec error.status à UNAUTHENTICATED quand la clé n'est pas envoyée. Les deux formats partagent la même clé, le même solde et les mêmes prix. Le tableau des codes d'erreur par statut est sur la page OpenAI API et s'applique entièrement quand Gemini est appelé au format OpenAI.

En USD par million de tokens, lus dans le catalogue au rendu de la page. La facturation utilise trois prix : entrée, entrée en cache et sortie, et les prix du tableau sont ceux qui sont débités du solde.

Gemini sert souvent à lire de longs contenus : un contrat entier, un dépôt de code ou la transcription d'une réunion. Le coût de ces requêtes tient presque entièrement à l'entrée : pour choisir un modèle, regardez donc d'abord le prix d'entrée et la longueur du contexte, puis le prix de sortie. Si le même contenu est interrogé plusieurs fois, la partie répétée touche le cache dès la deuxième requête et est facturée au prix de l'entrée en cache ; le reçu compte ces tokens à part.

Un nom de modèle qui contient le mot preview est une version préliminaire que Google remplacera plus tard par un nom définitif : l'id écrit dans le code doit donc suivre celui du tableau à ce moment-là. Inutile de deviner pour choisir un modèle : tous les id Gemini sont sur la même clé, envoyez donc le même prompt à chacun, puis comparez les réponses et le coût sur leurs reçus. Comparer avec GPT ou Claude revient aussi à changer model.

Pour la production, créez une clé distincte, donnez-lui un budget en dollars et un plafond de dépenses quotidien, puis limitez-la par une liste d'autorisation de modèles à l'id Gemini que vous avez choisi. Les programmes qui lisent de longs documents ont le plus besoin de ces limites, car une seule requête qui envoie par erreur tout un répertoire peut contenir des centaines de milliers de tokens d'entrée. Pour une requête en échec, lisez l'en-tête retry-after avant de réessayer. La création d'une clé et la pose de ses limites sont expliquées sur la page Clé API Claude.