Cómo conseguir una API key de Gemini en 2026 (nivel gratuito, niveles de pago y límites)

Para conseguir una API key de Gemini, inicia sesión en Google AI Studio con una cuenta de Google, abre la página API Keys y haz clic en Create API key (crear clave de API). Los usuarios nuevos reciben automáticamente un proyecto y una clave predeterminados tras aceptar las condiciones. Los proyectos empiezan en el Free tier (nivel gratuito), que no requiere método de pago y cubre muchos modelos Flash, Flash-Lite y Gemma dentro de unos límites de uso. Gemini 2.5 Pro también es gratis, mientras que Gemini 4 Argon, 3.1 Pro Preview y los modelos de imagen y de vídeo necesitan un nivel de pago, y Google dice que el contenido del nivel gratuito se usa para mejorar sus productos.

Comprobado con la documentación de la API de Gemini de Google el 17 de octubre de 2026. Google cambia a menudo los nombres de los modelos, la cobertura del nivel gratuito y las reglas de las claves; las fechas de abajo son las que publica Google.

Antes de empezar: quién puede conseguir una clave

• Una cuenta de Google. Sirve una cuenta personal de Gmail. Las cuentas de trabajo o de centro educativo pueden estar limitadas por las políticas de Google Cloud de la organización (consulta el arreglo de permisos en la solución de problemas).
• Tener 18 años o más. La página de regiones de Google indica que no cumplir el mínimo de 18 años, o no haber verificado tu edad en tu cuenta de Google, son motivos por los que AI Studio no se abre.
• Un país o territorio admitido. Google publica la lista en su página de regiones disponibles. Los niveles gratuito y de pago se ofrecen en el EEE (incluida la UE), el Reino Unido y Suiza. Si estás fuera de la lista, Google remite a la API de Gemini en Gemini Enterprise Agent Platform. Para usuarios de Colab, la comprobación se aplica a dónde se ejecuta la instancia de Colab, no a dónde estás tú.
• Sin tarjeta para el nivel gratuito. Solo añades un método de pago cuando pasas un proyecto a un nivel de pago.

Paso 1: crea la clave en Google AI Studio

1. Ve a aistudio.google.com e inicia sesión con tu cuenta de Google.
2. Acepta las condiciones del servicio. Si eres nuevo, AI Studio crea automáticamente un proyecto de Google Cloud predeterminado y una clave de API para ti.
3. Abre la página API Keys desde el panel.
4. Haz clic en Create API key si necesitas otra clave. Cada clave pertenece a un proyecto de Google Cloud.
5. Copia la clave y guárdala en un sitio seguro, como un gestor de contraseñas o un almacén de secretos.

¿Ya usas Google Cloud? AI Studio no te crea un proyecto predeterminado ni muestra todos tus proyectos de Cloud. Importa uno primero: abre el Dashboard, selecciona Projects, haz clic en Import projects, elige el proyecto y haz clic en Import. Después crea la clave desde la página API Keys. AI Studio te deja crear hasta 10 proyectos a la vez, y sus páginas muestran como máximo 100 claves y 50 proyectos.

Claves auth y claves estándar

Google está pasando la API de Gemini de las claves de API estándar a las claves de autorización (auth keys). Una auth key está vinculada a una cuenta de servicio de Google Cloud, está restringida a la API de Gemini por defecto y se bloquea más rápido si Google detecta que se ha filtrado. Las fechas clave que publica Google:

Si tienes una clave antigua marcada como Unrestricted en la página API Keys, pasa el ratón por la etiqueta, haz clic en Add restrictions, elige Restrict to Gemini API only y confirma con Restrict key, o crea una nueva auth key y cambia tu app a ella. La columna Key Type muestra cuáles de tus claves siguen siendo Standard.

Paso 2: configura GEMINI_API_KEY

Los SDK de Google Gen AI leen GEMINI_API_KEY o GOOGLE_API_KEY de tu entorno. Si están las dos, GOOGLE_API_KEY tiene prioridad. Google recomienda usar variables de entorno en lugar de poner la clave en el código.

macOS (Zsh)

Añade esta línea al final de ~/.zshrc:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Después recarga el archivo:

source ~/.zshrc

Linux o macOS (Bash)

Añade la misma línea export a ~/.bashrc y recárgalo:

source ~/.bashrc

Windows

1. Busca "Variables de entorno" en la barra de búsqueda de Windows.
2. Haz clic en Variables de entorno en el cuadro de diálogo Propiedades del sistema.
3. En Variables de usuario o Variables del sistema, haz clic en Nueva....
4. Pon GEMINI_API_KEY como nombre de la variable y tu clave como valor.
5. Haz clic en Aceptar y abre una terminal nueva para que tome la variable.

Paso 3: haz una solicitud de prueba

Instala el SDK oficial. Python:

pip install -U google-genai

JavaScript:

npm install @google/genai

Con GEMINI_API_KEY configurada, el cliente encuentra la clave solo. Una prueba mínima en Python con la Interactions API de Google:

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

Lo mismo en JavaScript:

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

O llama a la API REST directamente con curl. Este es el ejemplo de Google de la página de claves de API; sustituye YOUR_API_KEY por tu clave:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Una llamada correcta devuelve una interacción con "status": "completed", el uso de tokens y el texto del modelo. Si recibes un error, consulta la sección de solución de problemas de abajo. Los nombres de los modelos cambian a menudo, así que revisa la página de modelos de Google para ver los ID actuales antes de fijar uno en el código.

¿La API de Gemini es gratis?

Sí, para muchos modelos, dentro de unos límites de uso. La página de precios de Google indica estos modelos como Free of charge (gratis) en el nivel gratuito (entrada y salida estándar):

• Gemini 3.8 Flash, 3.6 Flash y 3 Flash Preview
• Gemini 3.5 Flash-Lite y 3.1 Flash-Lite
• Gemini 2.5 Pro, 2.5 Flash y 2.5 Flash-Lite
• Modelos Live, TTS y Transcribe como Gemini 3.8 Live, 3.8 Flash TTS y 3.5 Transcribe
• Gemini Embedding 2, Gemini Robotics ER 2 Preview y Gemma 4

Estos no tienen nivel gratuito: Gemini 4 Argon, Gemini 3.1 Pro Preview, Gemini Omni Flash, los modelos de imagen (Nano Banana 2.1, Nano Banana 2, Nano Banana Pro y 2.5 Flash Image), Veo y Lyria. El grounding con Google Search y Google Maps en Gemini 3 y modelos más nuevos también es solo del nivel de pago. Para las tarifas por token, consulta precios de la API de Gemini, y para un resumen del nivel gratuito, nuestra página del nivel gratuito de la API de Gemini.

En el nivel gratuito, la página de precios de Google marca el contenido como "Used to improve our products" (usado para mejorar nuestros productos). El uso estándar del nivel de pago no se usa así. No envíes datos confidenciales, de clientes o personales desde un proyecto del nivel gratuito.

Límites de uso de la API de Gemini

Google mide los límites en solicitudes por minuto (RPM), tokens de entrada por minuto (TPM) y solicitudes por día (RPD). Superar cualquiera de ellos provoca un error, aunque estés por debajo de los demás. Algunos modelos tienen límites adicionales, como imágenes por minuto en los modelos de imagen o tokens por día. Los límites se aplican por proyecto, no por clave de API, así que más claves en el mismo proyecto no añaden cuota. El RPD se reinicia a medianoche, hora del Pacífico. Los modelos experimentales y preliminares tienen límites más estrictos.

Google no publica una tabla fija con las cifras del nivel gratuito. Los límites varían según el modelo y el nivel, y puedes ver tus límites activos en AI Studio en aistudio.google.com/rate-limit. Google también dice que los límites indicados no están garantizados.

Tier 2 y Tier 3 se basan en el gasto acumulado en Google Cloud (no solo Gemini) de la cuenta de facturación vinculada, y la subida es automática. El paso de Free a Tier 1 suele ser instantáneo; las subidas posteriores, en unos 10 minutos. Que se apliquen límites basados en el gasto depende de tu historial de facturación; alcanzar uno devuelve 429 RESOURCE_EXHAUSTED. Si en un nivel de pago sigues llegando a los límites con un uso normal, Google tiene un formulario para pedir un aumento de límites, sin garantías.

Sacar más partido a los límites gratuitos

• Elige el modelo adecuado para cada tarea. Los límites cambian según el modelo y los preliminares son más estrictos, así que compara tus cifras en la página de límites y reserva los modelos de clase Pro para los prompts que los necesiten.
• Baja el nivel de razonamiento. Google señala que los modelos Gemini 3.x razonan por defecto, lo que añade latencia y tokens. Bajar el nivel de razonamiento reduce el uso de tokens en prompts sencillos.
• Reintenta con espera. Los SDK de Google reintentan automáticamente los errores 429 y 5xx (el SDK de Python hasta cuatro veces). En tu propio código REST, espera 1 s, 2 s, 4 s y así sucesivamente, con un poco de variación aleatoria.
• Proyectos separados para apps separadas. Los límites son por proyecto, así que un script de prueba no puede dejar sin cuota a tu app de demostración si están en proyectos distintos. No lo hagas para saltarte los límites de una misma app; va contra el espíritu de las condiciones y, de todos modos, los niveles se controlan a nivel de cuenta de facturación.

Pasar a un nivel de pago

1. En AI Studio, ve a la página API keys o Projects.
2. Busca el proyecto del nivel gratuito que quieres mejorar y haz clic en Set up billing en la columna Billing Tier.
3. Si nunca has tenido una cuenta de facturación de Google, elige tu país para aceptar las condiciones y confirma tus datos de contacto y tu método de pago. Si ya tienes una, elige una cuenta de facturación existente o haz clic en Add new billing account.
4. Prepaga al menos 5 $ (o el equivalente local) si te lo pide. A algunas cuentas se les ofrece Postpay (pospago) en su lugar.

Los usuarios nuevos van por defecto al plan Prepay (prepago), que empezó a aplicarse el 23 de marzo de 2026. Compras créditos en la página Billing de AI Studio (mínimo 5 $, máximo 5,000 $), el uso se descuenta casi en tiempo real y los créditos no usados caducan a los 12 meses y no son reembolsables. Cuando el saldo llega a 0 $, todas las claves de todos los proyectos de esa cuenta de facturación dejan de funcionar y las solicitudes fallan con HTTP 402 hasta que añadas créditos. La recarga automática y un límite mensual de cargo automático ayudan a evitar sorpresas, y puedes fijar topes de gasto por proyecto en la página Spend.

Para volver al nivel gratuito, desactiva la facturación en el proyecto (o desvincúlalo de su cuenta de facturación).

Ejemplo práctico de coste

Con el precio de pago estándar de Google para Gemini 3.8 Flash hasta el 31 de diciembre de 2026 (0.75 $ por 1M de tokens de entrada y 3.75 $ por 1M de tokens de salida, con los tokens de razonamiento facturados como salida): 1,000 solicitudes con 2,000 tokens de entrada y 500 de salida cada una usan 2M de tokens de entrada y 0.5M de salida. Eso son 2 × 0.75 $ = 1.50 $ más 0.5 × 3.75 $ = 1.875 $, unos 3.38 $ en total. Google indica que estas tarifas se duplican a partir del 1 de enero de 2027, lo que dejaría la misma carga en unos 6.75 $. Las mismas solicitudes en el nivel gratuito no cuestan nada, siempre que quepan en tus límites de uso.

La prueba gratuita de Google Cloud de 300 $ no puede pagar el uso de la API de Gemini. Google dice que desde marzo de 2026 los costes de la API de Gemini están excluidos del programa, y los créditos de bienvenida de cuentas de facturación abiertas después del 2 de marzo de 2026 no se pueden usar para la API de Gemini ni AI Studio. Las cuentas que recibieron el crédito antes pueden gastar lo que les quede en la API de Gemini hasta que caduque. Las startups pueden solicitar créditos a través del Google for Startups Cloud Program.

Mantén segura tu API key de Gemini

• Trata la clave como una contraseña y nunca la subas a Git.
• No incrustes claves en apps web o móviles; cualquiera puede extraerlas. Llama a Gemini desde un proxy en el backend.
• Lee la clave desde una variable de entorno y guarda las claves de producción en un almacén de secretos como Google Cloud Secret Manager.
• Restringe las claves: en la página de credenciales de la consola de Google Cloud, añade restricciones de aplicación como direcciones IP permitidas.
• Configura alertas de facturación en la consola de Google Cloud y un tope de gasto por proyecto en AI Studio para que una clave filtrada no pueda generar una factura grande.

Si se filtra tu clave

1. Crea una clave de sustitución en AI Studio o en la consola de Cloud.
2. Despliega tu app con la nueva clave.
3. Desactiva la clave filtrada cuando la nueva funcione y después elimínala.
4. Revisa la facturación y el uso de la API en la consola de Google Cloud por si hay actividad que no reconozcas. Para cargos inesperados, Google pide que abras un caso de soporte de facturación.

Solución de problemas

Las solicitudes fallidas con un error 400 o 500 no se cobran, pero Google dice que siguen contando para tu cuota.

Para qué usar el nivel gratuito, y alternativas

El nivel gratuito basta para aprender, prototipos, hackathons, scripts personales y herramientas internas con poco tráfico. Pasa a un nivel de pago cuando necesites límites de producción, un modelo Pro o de imagen, o cuando tus datos no deban usarse para mejorar los productos de Google. Si lo que quieres es una suscripción a Gemini para la app de chat en lugar de acceso a la API, es otro producto; consulta precios de los planes de Google AI, y los estudiantes deberían mirar la oferta gratuita de Google AI Pro para estudiantes.

Otros proveedores también ofrecen acceso gratuito a su API, cada uno con límites y políticas de datos distintos. Compáralos en nuestra guía de claves de API de IA gratis, o mira el nivel gratuito de la API de Groq, el nivel gratuito de la API de Mistral y los modelos gratis de OpenRouter. Si necesitas Claude, consulta cómo conseguir una clave de API de Anthropic. Para una visión general de todos los programas de créditos que seguimos, empieza por cómo conseguir créditos de IA gratis.