Clave API de Gemini — cómo obtenerla y usarla con el SDK de OpenAI

Una clave de API de Gemini autentica tus llamadas a los modelos Gemini de Google: cada solicitud incluye la clave en el encabezado Authorization, y la plataforma mide y factura el uso mediante ella. Hay dos formas de obtener una clave de API de Gemini: directamente a través de Google AI Studio (la vía oficial) o mediante Kunavo, con una clave compatible con OpenAI que accede a Gemini, Claude, GPT y a los modelos de imagen y vídeo sin ningún proyecto de Google Cloud.

Opción 1: Google AI Studio (oficial)

Si Gemini es el único modelo al que llamarás, obtén la clave directamente de Google:

1. Abre aistudio.google.com e inicia sesión con una cuenta de Google.
2. Ve a Get API key → Create API key. Las claves comienzan por AIza… y solo se muestran una vez.
3. El nivel gratuito tiene límites de velocidad y es adecuado para crear prototipos. Para producción, vincula la clave a una cuenta de facturación de Google Cloud.

Esta es la vía adecuada mientras solo necesites Gemini. En cuanto también uses Claude, GPT o modelos de imagen y vídeo, tendrás que gestionar una clave, un SDK y una factura por proveedor.

Opción 2: Kunavo (recomendada para producción)

Kunavo sitúa Gemini detrás de una API compatible con OpenAI. Una sola clave sk-kn- accede a todos los modelos desde el mismo endpoint: ningún proyecto de Google Cloud, Gemini aproximadamente 70 % por debajo del precio de lista de Google ($0.09 / $0.75 por 1M de tokens), un saldo de Stripe y pago por uso desde una recarga de $10. El saldo cubre Gemini, Claude, GPT, imagen y vídeo conjuntamente, y nunca caduca.

1. Regístrate. Crea una cuenta de Kunavo en kunavo.com.
2. Recarga $10. Pago por uso desde una recarga mínima de $10; el saldo nunca caduca.
3. Crea la clave. Genera una clave en /app/keys. Comienza por sk-kn- y solo se muestra una vez; guárdala en una variable de entorno.
4. Haz la llamada. Apunta el SDK de OpenAI a https://api.kunavo.com/v1 y llama a un slug de Gemini.

Inicio rápido

Conserva el SDK oficial de OpenAI. Solo tienes que cambiar base_url y el nombre del modelo; nada más.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

El mismo patrón sirve para Node.js y curl; las tarifas por modelo y los ejemplos detallados aparecen en la guía de precios de la API de Gemini.

Cómo mantener segura la clave

• Variables de entorno, no código fuente. No hagas commit de la clave en el repositorio; léela desde una variable de entorno. Nunca la expongas en un bundle de navegador o móvil: pasa siempre por tu propio servidor.
• Una clave por proyecto o entorno. Así puedes revocar una clave filtrada sin romper nada más.
• Rotación periódica. Kunavo permite varias claves activas, por lo que la rotación puede hacerse mediante una superposición limpia en lugar de un corte brusco.
• Límites de gasto por clave. Establece límites por clave en el dashboard y supervisa el tráfico inesperado por clave en /app/usage.

Preguntas frecuentes