Acceso compatible con OpenAI de Gemini API es útil para dos rutas de migración diferentes. Google documenta un endpoint directo compatible con OpenAI para Gemini, y Flatkey ofrece a los equipos una ruta de enrutador cuando quieren acceso a Gemini dentro de la misma pasarela de una sola clave que usan para otros modelos.
La ruta directa de Google es un cambio de base URL a https://generativelanguage.googleapis.com/v1beta/openai/ con una clave de API de Gemini. La ruta de Flatkey mantiene la forma del SDK de OpenAI, pero apunta su cliente a https://router.flatkey.ai/v1, usa una clave de Flatkey y selecciona un ID de modelo Gemini del catálogo de Flatkey antes de probar registros, costo y compatibilidad de funciones.
Esta guía explica cómo usar de forma segura una ruta compatible con OpenAI de Gemini API. Cubre qué admiten realmente los documentos de compatibilidad de Google, dónde un enrutador cambia el modelo operativo y qué verificar antes de mover tráfico de producción.
Respuesta rápida: Enrutamiento compatible con OpenAI de la API de Gemini
Si tu app ya usa el SDK de OpenAI para Python o JavaScript, una migración compatible con OpenAI de la API de Gemini empieza con la configuración, no con una reescritura.
| Decisión | API de Gemini directa | Gemini a través de Flatkey |
|---|---|---|
| Clave de API | Clave de API de Gemini de Google AI Studio | Clave de API de Flatkey |
| URL base | https://generativelanguage.googleapis.com/v1beta/openai/ |
https://router.flatkey.ai/v1 |
| Objetivo principal | Llamar a Gemini usando la sintaxis del SDK de OpenAI | Enrutar Gemini junto con otros proveedores de modelos detrás de una sola clave |
| Elección de modelo | ID de modelo Gemini de Google desde la documentación de Google | ID de modelo Gemini de Flatkey desde precios o panel |
| Validación | Respuesta, comportamiento del modelo, facturación de Google | Respuesta, registro de uso de Flatkey, unidad de precio, cuota, reversión |
Usa el endpoint directo de Google cuando solo necesites Gemini y quieras control de cuenta nativo del proveedor. Usa el enrutador de Flatkey cuando Gemini deba estar junto con GPT, Claude, DeepSeek, Qwen, imagen, video y otros accesos a modelos detrás de una sola clave, un solo panel y una sola superficie de facturación.
Qué confirman los documentos de compatibilidad de OpenAI de Google
La documentación de compatibilidad con OpenAI de Google dice que se puede acceder a los modelos Gemini con las bibliotecas de OpenAI para Python y JavaScript, además de REST, actualizando la clave de API, la URL base y el modelo. La URL base directa documentada es https://generativelanguage.googleapis.com/v1beta/openai/.
La misma página muestra ejemplos de completions de chat, respuestas en streaming, llamada a funciones, comprensión de imágenes e embeddings. También señala que la carga y descarga de archivos compatibles con OpenAI no se admiten actualmente, por lo que los flujos de trabajo con archivos necesitan el manejo del cliente Google GenAI en lugar de asumir una paridad completa con los archivos de OpenAI.
Esa es la principal lección para cualquier guía de Gemini API OpenAI compatible: la compatibilidad depende del endpoint y de la función. Un completion de chat puede ser una migración limpia de la URL base, mientras que los flujos de trabajo de carga de archivos, imágenes, lotes, herramientas o embeddings aún merecen sus propias pruebas.
Where Flatkey Changes The Gemini Setup
Flatkey no te pide que reemplaces una aplicación compatible con OpenAI con un nuevo SDK de proveedor para la primera prueba. La superficie pública del producto de Flatkey está construida alrededor de una sola clave API, sin cuentas separadas de proveedores, precios claros, facturación unificada y un solo panel para claves, uso y enrutamiento. También muestra la URL base del router compatible con OpenAI como https://router.flatkey.ai/v1.
Para una ruta Gemini API OpenAI compatible a través de Flatkey, el cambio importante no es el nombre del método del SDK de OpenAI. El cambio importante es operativo:
- Seleccionas un ID de modelo de Gemini desde Flatkey, no solo desde la documentación de Google.
- Verificas el uso y el costo en Flatkey después de la solicitud, no solo en la respuesta de la aplicación.
- Mantienes Gemini dentro del mismo flujo de trabajo de enrutamiento y cuotas que otros proveedores.
- Evitás crear una ruta de cuenta de proveedor separada para cada equipo o herramienta.
- Mantienes el rollback simple al controlar la URL base, la clave y el modelo mediante configuración.
La instantánea de precios en vivo de Flatkey revisada para este artículo incluía filas de catálogo con nombre Gemini, pero la disponibilidad y los nombres exactos de los modelos pueden cambiar. Trata el catálogo como la fuente de verdad del día de publicación: elige el modelo en pricing o en el panel, y luego prueba el ID exacto del modelo antes del tráfico de producción.
Patrón de migración de URL base
Comienza separando la migración en tres variables de entorno:
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_GEMINI_MODEL="replace-with-flatkey-gemini-model-id"Eso te da un cambio limpio para cualquier cliente Gemini API compatible con OpenAI. El código de la app mantiene la ruta del SDK compatible con OpenAI. La configuración decide si la solicitud va directamente a Google, a Flatkey o a otro endpoint compatible.
| Config Item | Why It Matters | What To Avoid |
|---|---|---|
| Base URL | Mantiene la elección del router fuera de la lógica de negocio. | Codificar en duro URLs de proveedores en muchos archivos. |
| API key | Separa las credenciales directas del proveedor de las credenciales del router. | Reutilizar claves antiguas del proveedor para una ruta de Flatkey. |
| Model ID | Te permite mapear deliberadamente un modelo de Google a un modelo del catálogo de Flatkey. | Asumir que cada alias de modelo del proveedor existe detrás del router. |
| Rollback values | Te permite restaurar rápidamente la ruta anterior. | Hacer que el rollback requiera un despliegue de código. |
Plantilla de Python para el enrutamiento de Flatkey Gemini
Solo plantilla: ejecuta esto con una clave Flatkey válida y un ID de modelo Flatkey Gemini confirmado antes de usarlo en producción.
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": "Responde con una sola frase confirmando que la ruta de Gemini está configurada.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)El método del SDK de OpenAI es familiar, pero no trates esto como una migración compatible con la API de Gemini de OpenAI completada hasta que el registro de uso de Flatkey muestre la solicitud, el modelo, el uso de tokens, el estado y el costo.
Plantilla de JavaScript para el enrutamiento Gemini de Flatkey
Solo plantilla: ejecútela con una clave Flatkey válida y un ID de modelo confirmado del catálogo actual de Flatkey.
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: "Responde con una sola frase confirmando que la ruta de Gemini está configurada.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);Para equipos que ya usan SDKs compatibles con OpenAI, esto mantiene pequeña la migración. El trabajo de producción está en la validación de funciones, el mapeo de modelos, las cuotas y las comprobaciones de facturación.
Lista de verificación de funciones antes de producción
Use esta lista de verificación antes de considerar una ruta Gemini API compatible con OpenAI como lista.
| Función | Señal en Google Docs | Verificación del enrutador Flatkey |
|---|---|---|
| Completaciones básicas de chat | Se documentan ejemplos de OpenAI SDK y REST. | Confirme la respuesta y el registro de uso de Flatkey. |
| Streaming | Google documenta streaming con llamadas al estilo de OpenAI. | Pruebe el manejo del flujo, el tiempo de espera y el análisis de salida parcial. |
| Llamadas a funciones | Google documenta llamadas a herramientas/funciones mediante ejemplos de compatibilidad. | Pruebe su esquema exacto de herramientas y el comportamiento de selección de herramientas. |
| Comprensión de imágenes | Google documenta entrada de imágenes mediante completaciones de chat. | Confirme que el modelo de Flatkey acepta el formato de imagen que envía su SDK. |
| Embeddings y lotes | Google documenta embeddings y ejemplos relacionados con lotes. | Pruebe como una ruta de endpoint separada, no como una suposición de chat. |
| Carga/descarga de archivos | Google dice que la carga/descarga compatible con OpenAI actualmente no es compatible. | Use un plan de archivos nativo de un proveedor separado si su flujo de trabajo depende de archivos. |
| Precios | Google mantiene una página de precios de la API para desarrolladores de Gemini. | Use los precios de Flatkey para el uso enroutado y luego verifique los registros de costo reales. |
Smoke Test Runbook
Una prueba de humo compatible con Gemini API OpenAI compatible debe demostrar tanto el comportamiento de la API como la visibilidad del router.
- Elija un ID de modelo Gemini del catálogo actual de Flatkey.
- Cree o seleccione una clave de Flatkey de bajo riesgo para pruebas.
- Configure
OPENAI_BASE_URLenhttps://router.flatkey.ai/v1. - Ejecute un prompt de chat simple sin streaming.
- Confirme que la forma del mensaje del asistente coincide con el parser de su aplicación.
- Revise los registros de uso de Flatkey para ver el modelo, el estado, los tokens y el coste.
- Ejecute una prueba de modelo incorrecto y registre la forma del error.
- Ejecute streaming, llamadas a herramientas, visión o embeddings solo si su aplicación los usa.
- Establezca una cuota pequeña antes de enviar tráfico real.
- Mantenga la URL base y el modelo del proveedor anterior como configuración de reversión.
El objetivo no es solo lograr que aparezca una respuesta de Gemini. El objetivo es saber por dónde pasó la ruta, cuánto costó, cómo se ven los fallos y con qué rapidez puede revertir.
Errores comunes
- Usar la URL base compatible con OpenAI de Gemini de Google directamente cuando pretendías probar Flatkey.
- Usar un ID de modelo de Google sin confirmar la cadena de modelo del catálogo de Flatkey.
- Asumir que la carga y descarga de archivos funciona a través de cada ruta compatible con OpenAI.
- Probar solo completaciones de chat cuando la producción usa streaming o herramientas.
- Omitir la comprobación del registro de uso y la facturación después de una respuesta exitosa.
- Publicar fragmentos de código con claves que parecen reales o IDs de modelo de producción no probados.
Son detalles pequeños, pero ahí es donde fallan la mayoría de las migraciones Gemini API compatible con OpenAI. Un router facilita el acceso; no elimina la necesidad de probar la forma exacta de la solicitud.
Cómo encaja esto con las guías de migración existentes de Flatkey
Si esta es tu primera migración de router, empieza con la guía más amplia de migración de API compatible con OpenAI. Cubre el patrón de URL base, las variables de entorno, las pruebas de verificación, la reversión y las comprobaciones del panel que aplican a cualquier proveedor.
Luego usa esta guía específica de Gemini para los detalles del proveedor: el endpoint de compatibilidad directa de Google, la selección de modelos Gemini, la compatibilidad de funciones y las limitaciones en el manejo de archivos. Para patrones adyacentes de acceso a modelos, compara la guía de acceso a la API de DeepSeek y la guía de proxy vs router de la API de Claude.
FAQ
¿La API de Gemini es compatible con OpenAI?
Google documenta la compatibilidad con OpenAI para Gemini a través de las bibliotecas Python y JavaScript de OpenAI, además de ejemplos REST. Eso no significa que todos los endpoints o parámetros de OpenAI tengan un comportamiento idéntico, así que prueba exactamente la función que usa tu app.
¿Cuál es la URL base directa de Gemini compatible con OpenAI?
La URL base directa compatible con OpenAI documentada por Google es https://generativelanguage.googleapis.com/v1beta/openai/. Úsala cuando llames a Google directamente con una clave API de Gemini.
¿Qué URL base debo usar para Gemini a través de Flatkey?
Usa https://router.flatkey.ai/v1 para una ruta de Flatkey compatible con OpenAI. Luego elige un ID de modelo de Gemini desde los precios de Flatkey o el panel y prueba la solicitud antes de producción.
¿Puedo usar el mismo ID de modelo de la documentación de Google en Flatkey?
No automáticamente. Las cadenas de modelo y la disponibilidad pueden variar según el catálogo y la ruta. Elige el ID de modelo de Flatkey el día que hagas la prueba y mantenlo en la configuración.
¿Compatible con OpenAI significa paridad total de funciones?
No. Compatible con OpenAI normalmente significa que las formas comunes de solicitud y respuesta funcionan para los endpoints compatibles. Google señala específicamente que la carga y descarga compatibles con OpenAI no están soportadas actualmente, por lo que se requiere probar a nivel de función.
¿Cómo debería presupuestar Gemini a través de un router?
Usa la documentación de precios de Google para el contexto directo de Gemini y los precios de Flatkey para el uso enrutado. Luego verifica el costo real de la solicitud en los registros de Flatkey porque el modelo, la caché, el lote y las unidades de modalidad pueden diferir.
Ver precios antes de enrutar tráfico de producción
El acceso compatible con OpenAI de Gemini API es una ruta de migración práctica cuando tu aplicación ya usa llamadas de SDK estilo OpenAI. Mantén el cambio pequeño: actualiza la URL base, usa una clave Flatkey, selecciona un modelo Gemini actual, ejecuta las pruebas de humo y verifica el uso y los precios antes del despliegue.
Ver precios para confirmar las opciones actuales de modelos Gemini de Flatkey y las unidades de costo antes de enviar tráfico de producción.
