Obtén una clave de Google, paso a paso
- Abre Google AI Studio en aistudio.google.com/apikey e inicia sesión con una cuenta de Google.
- Haz clic en Crear clave de API. Cada clave pertenece a un proyecto de Google Cloud. Los usuarios nuevos reciben un proyecto predeterminado; si ya usas Google Cloud, elige o crea un proyecto.
- Copia la clave y guárdala en un lugar seguro. Desde el 28 de mayo de 2026, las claves nuevas son claves de autenticación: vinculadas a una cuenta de servicio y restringidas a la API de Gemini desde el principio.
- Configúrala como variable de entorno. Los SDK de Google leen
GEMINI_API_KEYoGOOGLE_API_KEY; si ambas están configuradas,GOOGLE_API_KEYtiene prioridad.
¿Tienes una clave antigua? La API de Gemini rechaza las claves estándar sin restricciones. En AI Studio, pasa el cursor sobre la etiqueta Unrestricted de la clave, elige Add restrictions y restríngela a la API de Gemini.
Prueba la clave
Gemini también responde a solicitudes al estilo de OpenAI, lo que permite una prueba breve. Las solicitudes nativas envían la clave en una cabecera x-goog-api-key.
export GEMINI_API_KEY="your-key"curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \ -H "Authorization: Bearer $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Say hello"}]}'El nivel gratuito, y lo que te cuesta
Una clave nueva funciona en el nivel gratuito sin tarjeta. Cubre los modelos Flash y Flash-Lite, Gemini 2.5 Pro, los modelos de texto a voz y Live y los embeddings, con límites de velocidad más bajos que los niveles de pago. Gemini 4 Argon, Gemini 3.1 Pro y los modelos de imagen necesitan facturación.
La contrapartida: en el nivel gratuito Google usa lo que envías y lo que devuelve para mejorar sus productos, y revisores humanos pueden leerlo. En el nivel de pago, no. Mantén los datos personales y confidenciales fuera de una clave gratuita.
Activa la facturación
En AI Studio, elige Set up billing en el proyecto, vincula una cuenta de facturación de Cloud y prepaga al menos $5. Los límites de gasto suben según lo que hayas pagado:
| Nivel | Para acceder | Límite de gasto |
|---|---|---|
| Gratis | Un proyecto activo | Solo modelos gratuitos |
| Nivel 1 | Una cuenta de facturación vinculada | $250 |
| Nivel 2 | $100 pagados, 3 días después del primer pago | $2,000 |
| Nivel 3 | $1,000 pagados, 30 días después | $20,000 o más |
Después, cada solicitud se factura por token. Precios de lista por 1M tokens:
| Modelo | Entrada | Salida | En Zurelay (entrada / salida) |
|---|---|---|---|
| Gemini 4 Argon | $2.00 | $10.00 | $0.80 / $4.00 |
| Gemini 3.1 Pro | $2.00 | $12.00 | $0.50 / $3.45 |
| Gemini 3.8 Flash | $0.75 | $3.75 | $0.22 / $1.10 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 | $0.12 / $1.04 |
¿Google AI Pro o Ultra incluyen la API?
No. Los beneficios de un plan de Google AI solo se aplican dentro del sitio web de AI Studio; llamar a la API de Gemini con una clave se factura aparte, a través de Google Cloud.
Mantén la clave a salvo
- Mantenla en el servidor. Una clave en una página web o en una app se puede copiar y usar con cargo a tu cuenta de facturación.
- Restringe cada clave a la Gemini API y usa un proyecto distinto por aplicación.
- Configura una alerta de presupuesto en la facturación de Google Cloud, ya que el uso de pago se factura a tu cuenta.
Otra forma: Gemini con la misma clave que Claude y GPT
En Zurelay, Gemini es un nombre de modelo más en una clave compatible con OpenAI, y se factura desde saldo prepago sin necesidad de una cuenta de facturación de Cloud (71% por debajo de la lista de Google en Gemini 3.8 Flash):
from openai import OpenAIclient = OpenAI(base_url="https://api.zurelay.com/v1", api_key="YOUR_ZURELAY_KEY")reply = client.chat.completions.create( model="gemini-3.8-flash", messages=[{"role": "user", "content": "Say hello"}],)print(reply.choices[0].message.content)En Zurelay no hay nivel gratuito; el saldo mínimo es de $10. Si el nivel gratuito cubre lo que necesitas, empezar con una clave de Google sale más barato. Consulta precios de la Gemini API para ver todos los modelos.
Pasos, nivel gratuito y facturación según las páginas Clave de API, pricing, límites de tasa, terms y planes de Google AI de Google, consultadas el 28 de octubre de 2026.