Gemini API en formato compatible con OpenAI

Usar la Gemini API directamente significa tener una cuenta de Google, crear una key en Google AI Studio y pagar según la facturación de Google. Aquí esa parte se sustituye: recargas saldo en RelaySwitch, usas una key de RelaySwitch y la petición va a un gateway que la reenvía a Gemini. Para tu código solo cambian la dirección y la key; el id de modelo sigue siendo el de Gemini.

Gemini tiene su propio formato de petición (generateContent), pero la mayoría de las herramientas y del código existente están escritos para OpenAI Chat Completions. La propia Google ofrece una capa compatible con OpenAI y señala en su documentación que ese soporte sigue en beta. El enfoque aquí es el mismo: cada id de Gemini de la tabla de precios se puede llamar en formato OpenAI, así que pasar código de OpenAI a Gemini es cambiar el campo model.

Comprueba primero con curl que la key y la dirección son correctas. La key va en el header Authorization: Bearer, y respecto a un ejemplo normal de OpenAI solo cambian la Base URL, la key y model.

La Base URL se escribe con /v1 y el SDK añade /chat/completions por su cuenta. Para streaming, pon stream en true; la respuesta llega como server-sent events con el mismo formato que OpenAI. El número de tokens de usage coincide con el que queda en el recibo.

El código escrito siguiendo la documentación compatible con OpenAI de Google ya usa el SDK de OpenAI, así que el cuerpo de la petición no cambia. Los campos propios de Gemini que la documentación de Google envía mediante extra_body no se han probado uno por uno en esta página; si los usas, prueba primero con una petición y revisa que el cobro del recibo sea el esperado.

Solo cambian tres cosas:

• base_url: de la dirección de la documentación de Google a https://api.relayswitch.io/v1.
• api_key: de la key de Google AI Studio a una key de RelaySwitch, que empieza por sk-relay-.
• model: coteja el id con la tabla de precios de esta página y usa el que figure en ese momento; un id incorrecto recibe 404 model_not_found.

Un programa ya escrito con el formato de petición de Google no hay que reescribirlo, siempre que el id de Gemini que use atienda esta ruta. La ruta es /v1beta/models/{model}:generateContent, justo detrás de https://api.relayswitch.io y sin /v1. La key va en el header x-goog-api-key, no en la URL: el gateway rechaza una key puesta en un query parameter. El cuerpo de la petición y el de la respuesta usan la estructura de Google, contents de entrada y candidates de salida.

Los mensajes de error siguen el formato de cada caso. En formato OpenAI, el código está en error.code; en formato nativo, la forma es la de Google, por ejemplo un 401 con UNAUTHENTICATED en error.status cuando no se envía la key. Los dos formatos comparten key, saldo y precios. La tabla de códigos de error por estado está en la página de OpenAI API y se aplica por completo cuando Gemini se llama en formato OpenAI.

En USD por millón de tokens, leídos del catálogo al renderizar la página. El cobro usa tres precios: input, cached input y output, y el precio de la tabla es el que se descuenta del saldo.

Gemini se usa a menudo para leer material largo: un contrato entero, un repositorio de código o la transcripción de una reunión. El costo de una petición así está casi todo en el input, así que al elegir modelo mira primero el precio de input y la longitud de contexto, y después el precio de output. Si se pregunta varias veces sobre el mismo material, la parte repetida acierta en la caché desde la segunda petición y se cobra al precio de cached input; el recibo registra esos tokens por separado.

Un nombre de modelo que contiene la palabra preview es una versión preliminar que Google sustituirá más adelante por un nombre definitivo, así que el id escrito en el código debe seguir el que figure en la tabla en ese momento. Para elegir modelo no hay que adivinar: todos los id de Gemini están en la misma key, así que envía el mismo prompt a cada uno y compara las respuestas y el costo de sus recibos. Comparar con GPT o con Claude también es solo cambiar model.

Para producción, crea una key aparte, ponle un presupuesto en dólares y un límite de gasto diario, y restríngela con una lista de modelos permitidos a los id de Gemini que elijas. Los programas que leen documentos largos son los que más necesitan estos límites, porque una sola petición que envía por error un directorio entero puede llevar cientos de miles de tokens de input. Ante una petición fallida, lee el header retry-after antes de reintentar. Cómo crear la key y ponerle límites está en la página de Claude API key.