Accès compatible OpenAI à l’API Gemini est utile pour deux parcours de migration différents. Google documente un point de terminaison directement compatible OpenAI pour Gemini, et Flatkey offre aux équipes une voie via un routeur lorsqu’elles veulent accéder à Gemini dans la même passerelle à clé unique qu’elles utilisent pour d’autres modèles.
Le parcours direct de Google consiste à remplacer l’URL de base par https://generativelanguage.googleapis.com/v1beta/openai/ avec une clé API Gemini. Le parcours Flatkey conserve la forme du SDK OpenAI, mais dirige votre client vers https://router.flatkey.ai/v1, utilise une clé Flatkey et sélectionne un identifiant de modèle Gemini dans le catalogue Flatkey avant de tester les journaux, les coûts et la prise en charge des fonctionnalités.
Ce guide explique comment utiliser en toute sécurité une route compatible OpenAI à l’API Gemini. Il couvre ce que les documents de compatibilité de Google prennent réellement en charge, en quoi un routeur change le modèle opérationnel et ce qu’il faut vérifier avant de déplacer le trafic de production.
Réponse rapide : routage compatible avec OpenAI pour l’API Gemini
Si votre application utilise déjà le SDK OpenAI Python ou JavaScript, une migration compatible avec l’API Gemini OpenAI commence par la configuration, pas par une réécriture.
| Décision | API Gemini directe | Gemini via Flatkey |
|---|---|---|
| Clé API | Clé API Gemini de Google AI Studio | Clé API Flatkey |
| URL de base | https://generativelanguage.googleapis.com/v1beta/openai/ |
https://router.flatkey.ai/v1 |
| Objectif principal | Appeler Gemini en utilisant la syntaxe du SDK OpenAI | Faire passer Gemini avec d’autres fournisseurs de modèles derrière une seule clé |
| Choix du modèle | ID de modèle Google Gemini provenant de la documentation Google | ID de modèle Gemini Flatkey provenant de la tarification ou du tableau de bord |
| Validation | Réponse, comportement du modèle, facturation Google | Réponse, journal d’utilisation Flatkey, unité de tarification, quota, retour arrière |
Utilisez le point de terminaison Google direct lorsque vous n’avez besoin que de Gemini et que vous souhaitez un contrôle de compte natif du fournisseur. Utilisez le routeur Flatkey lorsque Gemini doit côtoyer GPT, Claude, DeepSeek, Qwen, l’image, la vidéo et d’autres accès aux modèles derrière une seule clé, un seul tableau de bord et une seule interface de facturation.
Ce que confirment les docs de compatibilité OpenAI de Google
La documentation de compatibilité OpenAI de Google indique que les modèles Gemini peuvent être utilisés avec les bibliothèques OpenAI pour Python et JavaScript, ainsi qu’en REST, en mettant à jour la clé API, l’URL de base et le modèle. L’URL de base directe documentée est https://generativelanguage.googleapis.com/v1beta/openai/.
La même page montre des exemples pour les complétions de chat, les réponses en streaming, l’appel de fonctions, la compréhension d’images et les embeddings. Elle précise aussi que le téléversement et le téléchargement de fichiers compatibles OpenAI ne sont actuellement pas pris en charge, donc les workflows de fichiers doivent s’appuyer sur la gestion du client Google GenAI plutôt que de supposer une parité complète avec OpenAI pour les fichiers.
C’est la principale leçon pour tout guide Gemini API OpenAI compatible : la compatibilité dépend du point de terminaison et des fonctionnalités. Une complétion de chat peut se limiter à une migration propre de l’URL de base, tandis que les workflows de téléversement de fichiers, d’images, de lots, d’outils ou d’embeddings méritent encore leurs propres tests.
Où Flatkey change la configuration Gemini
Flatkey ne vous demande pas de remplacer une application compatible OpenAI par un nouveau SDK fournisseur pour le premier test. L’interface publique du produit Flatkey est conçue autour d’une seule clé API, sans comptes fournisseurs séparés, avec une tarification claire, une facturation unifiée et un tableau de bord unique pour les clés, l’utilisation et le routage. Elle affiche également l’URL de base du routeur compatible OpenAI sous la forme https://router.flatkey.ai/v1.
Pour une route Gemini API OpenAI compatible via Flatkey, le changement important ne concerne pas le nom de la méthode du SDK OpenAI. Le changement important est opérationnel :
- Vous sélectionnez un identifiant de modèle Gemini depuis Flatkey, et pas seulement depuis la documentation de Google.
- Vous vérifiez l’utilisation et le coût dans Flatkey après la requête, et pas seulement dans la réponse de l’application.
- Vous conservez Gemini dans le même flux de routage et de quotas que les autres fournisseurs.
- Vous évitez de créer un chemin de compte fournisseur distinct pour chaque équipe ou outil.
- Vous gardez la possibilité de revenir en arrière simplement en contrôlant l’URL de base, la clé et le modèle via la configuration.
L’instantané de tarification en direct de Flatkey consulté pour cet article incluait des lignes de catalogue nommées Gemini, mais la disponibilité et les noms exacts des modèles peuvent changer. Considérez le catalogue comme une source de vérité à la date de publication : choisissez le modèle dans tarification ou dans le tableau de bord, puis testez l’identifiant exact du modèle avant le trafic de production.
Schéma de migration de l’URL de base
Commencez par séparer la migration en trois variables d’environnement :
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_GEMINI_MODEL="replace-with-flatkey-gemini-model-id"Cela vous offre un basculement propre pour tout client Gemini API compatible avec OpenAI. Le code de l’application conserve le chemin du SDK compatible OpenAI. La configuration décide si la requête est envoyée directement à Google, à Flatkey ou à un autre point de terminaison compatible.
| Élément de configuration | Pourquoi c’est important | Ce qu’il faut éviter |
|---|---|---|
| URL de base | Garde le choix du routeur en dehors de la logique métier. | Coder en dur les URL des fournisseurs dans de nombreux fichiers. |
| Clé API | Sépare les identifiants directs du fournisseur des identifiants du routeur. | Réutiliser d’anciennes clés de fournisseur pour une route Flatkey. |
| ID du modèle | Vous permet d’associer délibérément un modèle Google à un modèle du catalogue Flatkey. | Supposer que chaque alias de modèle fournisseur existe derrière le routeur. |
| Valeurs de retour arrière | Vous permet de restaurer rapidement l’itinéraire précédent. | Faire en sorte que le retour arrière nécessite un déploiement de code. |
Modèle Python pour le routage Flatkey Gemini
Modèle uniquement : exécutez ceci avec une clé Flatkey valide et un ID de modèle Flatkey Gemini confirmé avant de l'utiliser en production.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ["FLATKEY_GEMINI_MODEL"],
messages=[
{
"role": "user",
"content": "Répondez par une seule phrase confirmant que la route Gemini est configurée.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)La méthode du SDK OpenAI est familière, mais ne considérez pas cela comme une migration Gemini API compatible avec OpenAI achevée tant que le journal d'utilisation Flatkey n'affiche pas la requête, le modèle, l'utilisation des jetons, le statut et le coût.
Modèle JavaScript pour le routage Flatkey Gemini
Modèle uniquement : exécutez-le avec une clé Flatkey valide et un ID de modèle confirmé provenant du catalogue Flatkey actuel.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: process.env.OPENAI_BASE_URL || "https://router.flatkey.ai/v1",
});
const response = await client.chat.completions.create({
model: process.env.FLATKEY_GEMINI_MODEL,
messages: [
{
role: "user",
content: "Reply with one sentence confirming the Gemini route is configured.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);Pour les équipes qui utilisent déjà des SDK compatibles avec OpenAI, cela réduit la portée de la migration. Le travail de production consiste à valider les fonctionnalités, le mappage des modèles, les quotas et les vérifications de facturation.
Liste de contrôle des fonctionnalités avant la production
Utilisez cette liste de contrôle avant de considérer une route Gemini API compatible avec OpenAI comme prête.
| Fonctionnalité | Signal dans la documentation Google | Vérification du routeur Flatkey |
|---|---|---|
| Complétions de chat de base | Les exemples du SDK OpenAI et de l’API REST sont documentés. | Confirmez la réponse et le journal d’utilisation de Flatkey. |
| Streaming | Google documente le streaming avec des appels de style OpenAI. | Testez la gestion du flux, le délai d’attente et l’analyse des sorties partielles. |
| Appel de fonctions | Google documente l’appel d’outils/fonctions via des exemples de compatibilité. | Testez votre schéma d’outil exact et le comportement du choix d’outil. |
| Compréhension d’images | Google documente l’entrée d’image via des complétions de chat. | Confirmez que le modèle Flatkey accepte le format d’image envoyé par votre SDK. |
| Embeddings et batch | Google documente les embeddings et des exemples liés au batch. | Testez cela comme un chemin de point de terminaison séparé, et non comme une hypothèse de chat. |
| Téléversement/téléchargement de fichiers | Google indique que le téléversement/téléchargement compatible avec OpenAI n’est actuellement pas pris en charge. | Utilisez un plan de fichiers natif à un autre fournisseur si votre flux de travail dépend des fichiers. |
| Tarification | Google maintient une page de tarification de l’API Gemini Developer. | Utilisez la tarification Flatkey pour l’usage routé, puis vérifiez les journaux de coût réels. |
Smoke Test Runbook
Un test de validation Gemini API compatible OpenAI doit prouver à la fois le comportement de l’API et la visibilité du routeur.
- Choisissez un ID de modèle Gemini dans le catalogue Flatkey actuel.
- Créez ou sélectionnez une clé Flatkey à faible risque pour les tests.
- Définissez
OPENAI_BASE_URLsurhttps://router.flatkey.ai/v1. - Exécutez une invite de chat simple sans flux.
- Confirmez que la forme du message de l’assistant correspond à votre analyseur d’application.
- Vérifiez dans les journaux d’utilisation Flatkey le modèle, le statut, les jetons et le coût.
- Exécutez un test avec un mauvais modèle et consignez la forme de l’erreur.
- Exécutez le streaming, les appels d’outils, la vision ou les embeddings uniquement si votre application les utilise.
- Définissez un petit quota avant l’envoi de tout trafic réel.
- Conservez l’URL de base du fournisseur précédent et le modèle comme configuration de retour arrière.
L’objectif n’est pas seulement de faire apparaître une réponse Gemini. L’objectif est de savoir où la requête est passée, combien elle a coûté, à quoi ressemblent les échecs et à quelle vitesse vous pouvez revenir en arrière.
Erreurs courantes
- Utiliser l’URL de base Gemini OpenAI-compatible directe de Google alors que vous vouliez tester Flatkey.
- Utiliser un identifiant de modèle Google sans vérifier la chaîne du modèle dans le catalogue Flatkey.
- Supposer que l’envoi/le téléchargement de fichiers fonctionne via chaque chemin compatible avec OpenAI.
- Ne tester que les complétions de chat alors qu’en production vous utilisez le streaming ou des outils.
- Ignorer la vérification du journal d’utilisation et de la facturation après une réponse réussie.
- Publier des extraits de code avec des clés qui semblent réelles ou des identifiants de modèle de production non testés.
Ce sont de petits détails, mais c’est là que la plupart des migrations Gemini API OpenAI compatible échouent. Un routeur facilite l’accès ; il ne supprime pas la nécessité de tester la forme exacte de la requête.
Comment cela s’intègre aux guides de migration Flatkey existants
Si c’est votre première migration de routeur, commencez par le guide plus général de migration de l’API compatible OpenAI. Il couvre le modèle d’URL de base, les variables d’environnement, les tests de validation, le rollback et les vérifications du tableau de bord qui s’appliquent à tout fournisseur.
Utilisez ensuite ce guide spécifique à Gemini pour les détails du fournisseur : le point de terminaison de compatibilité directe de Google, la sélection des modèles Gemini, la prise en charge des fonctionnalités et les limites de gestion des fichiers. Pour les schémas d’accès aux modèles adjacents, comparez le guide d’accès à l’API DeepSeek et le guide proxy vs routeur de l’API Claude.
FAQ
Gemini API est-elle compatible avec OpenAI ?
Google documente la compatibilité OpenAI pour Gemini via les bibliothèques Python et JavaScript OpenAI, ainsi que des exemples REST. Cela ne signifie pas que chaque endpoint ou paramètre OpenAI ait un comportement identique ; testez donc précisément la fonctionnalité utilisée par votre application.
Quelle est l’URL de base directe Gemini OpenAI ?
L’URL de base directe compatible OpenAI documentée par Google est https://generativelanguage.googleapis.com/v1beta/openai/. Utilisez-la lorsque vous appelez Google directement avec une clé API Gemini.
Quelle URL de base dois-je utiliser pour Gemini via Flatkey ?
Utilisez https://router.flatkey.ai/v1 pour une route Flatkey compatible OpenAI. Choisissez ensuite un ID de modèle Gemini dans la tarification Flatkey ou dans le tableau de bord, puis testez la requête avant la mise en production.
Puis-je utiliser le même ID de modèle que dans la documentation de Google dans Flatkey ?
Pas automatiquement. Les chaînes de modèle et leur disponibilité peuvent varier selon le catalogue et la route. Choisissez l’ID de modèle fourni par Flatkey le jour de vos tests et conservez-le dans la configuration.
Compatible avec OpenAI signifie-t-il une parité complète des fonctionnalités ?
Non. Compatible avec OpenAI signifie généralement que les formes courantes des requêtes et des réponses fonctionnent pour les endpoints pris en charge. Google précise en particulier que le téléversement et le téléchargement compatibles OpenAI ne sont actuellement pas pris en charge, donc des tests au niveau des fonctionnalités sont nécessaires.
Comment dois-je budgéter Gemini via un routeur ?
Utilisez la documentation tarifaire de Google pour le contexte direct Gemini et la tarification Flatkey pour l’usage routé. Vérifiez ensuite le coût réel de la requête dans les journaux Flatkey, car les unités de modèle, de cache, de lot et de modalité peuvent différer.
Consultez les tarifs avant d’acheminer le trafic de production
L’accès Gemini API compatible OpenAI est un chemin de migration pratique lorsque votre application utilise déjà des appels SDK de style OpenAI. Gardez le changement limité : mettez à jour l’URL de base, utilisez une clé Flatkey, sélectionnez un modèle Gemini actuel, exécutez les tests de validation, et vérifiez l’utilisation et les tarifs avant le déploiement.
Consultez les tarifs pour confirmer les options actuelles de modèles Gemini Flatkey et les unités de coût avant d’envoyer du trafic de production.
