Clave API de Google AI Studio gratis: crear, proteger y probar

Una clave de Google AI Studio autentica tus llamadas a Gemini API. Crearla es gratis y se hace en la página de claves de Google AI Studio; lo que puede costar dinero es el uso, y solo cuando el proyecto tiene una cuenta de facturación vinculada. A 8 de octubre de 2026, el nivel gratuito cubre modelos como Gemini 3.8 Flash, 3.7 Flash o 2.5 Pro, pero no los modelos de imagen (Nano Banana) ni Gemini 3.1 Pro Preview.

La clave no es una suscripción de consumo de Gemini, no compra un modelo y no crea una cuota independiente. Pertenece a un proyecto de Google Cloud, y ese proyecto concentra permisos, miembros, uso, límites y facturación. Desde el 28 de mayo de 2026 las claves nuevas son claves de autorización, y Gemini API rechaza las claves estándar sin restricciones: si sigues un tutorial anterior, ese es el primer punto que cambia.

La configuración termina cuando la credencial pertenece a un proyecto que controlas, se guarda fuera del código cliente y una petición mínima a un modelo gratuito produce una respuesta identificable.

Confirma que la ruta directa se aplica a tu cuenta

Consulta la lista de regiones disponibles de Google AI Studio y Gemini API. España figura en ella a 8 de octubre de 2026. Google también exige tener 18 años y puede pedir verificación de edad.

Que el país aparezca no garantiza por sí solo que una cuenta, una política de organización o un método de pago concretos sean válidos. Si AI Studio muestra una restricción de cuenta, edad o región, resuélvela por la vía oficial; no uses identidades, direcciones ni proyectos ajenos para esquivarla.

Elige el propietario antes de crear la clave

Abre Google AI Studio API Keys con la cuenta que deba administrar la integración. Para una prueba personal puede ser tu propio proyecto. Para un servicio de empresa conviene que la organización mantenga el control de los permisos IAM, la facturación, la rotación y la revocación aunque cambien las personas del equipo.

La documentación de claves de Gemini API describe dos situaciones:

• una cuenta nueva recibe un proyecto Cloud y una clave por defecto al aceptar las condiciones;
• una cuenta que ya usa Google Cloud importa el proyecto elegido desde Dashboard → Projects y crea la clave desde API Keys.

Anota el identificador del proyecto, no solo el nombre visible. Después podrás compararlo con el uso, la facturación, los límites y la configuración desplegada sin confundir proyectos parecidos.

Si Create API key no está disponible, conserva el mensaje exacto. Google enumera los permisos que necesita quien crea la clave: resourcemanager.projects.get, apikeys.keys.create, serviceusage.services.enable, iam.serviceAccounts.create e iam.serviceAccountApiKeyBindings.create. Pedir una clave a otra persona no corrige IAM y deja el consumo fuera de tu control.

Comprueba que sea el tipo de clave actual

Desde el 28 de mayo de 2026, toda clave nueva creada en AI Studio es una clave de autorización (authorization key o auth key): queda vinculada a una cuenta de servicio y restringida a Gemini API de forma predeterminada. Gemini API rechaza las peticiones hechas con claves estándar sin restricciones; las claves estándar con restricciones explícitas siguen funcionando. Además, desde el 7 de mayo de 2026 se bloquean las claves sin restricciones que llevan mucho tiempo sin usarse.

Revisa la columna Key Type en AI Studio. Si tu proyecto conserva una clave estándar sin restricciones copiada de un tutorial antiguo, no la tomes como base: crea una auth key en el mismo proyecto, cambia el secreto en tu servidor y elimina la antigua cuando la nueva responda.

El gráfico es anterior a la actualización del 8 de octubre de 2026 (habla de retirar las claves estándar en septiembre y de Free/Paid/Prepay); el texto recoge la situación actual.

Guarda el secreto fuera del cliente

Quien obtiene la clave puede consumir cuota del proyecto y, si la facturación está activa, generar cargos. No la incluyas en Git, incidencias, capturas, volcados del entorno, JavaScript de producción, una app móvil o una URL que termine en registros.

Los SDK actuales detectan GEMINI_API_KEY o GOOGLE_API_KEY. Si ambas existen, GOOGLE_API_KEY tiene prioridad. Una variable antigua puede explicar por qué cambiar GEMINI_API_KEY no modifica el resultado.

export GEMINI_API_KEY="YOUR_API_KEY"

El valor del ejemplo es un marcador. En producción usa un gestor de secretos del servidor y haz que el navegador o la aplicación móvil llame a tu backend. Comprueba la presencia sin imprimir la clave:

if [ -n "${GEMINI_API_KEY:-}" ]; then
  echo "GEMINI_API_KEY configurada"
else
  echo "Falta GEMINI_API_KEY"
fi

Si sospechas que la clave se ha filtrado, Google indica este orden: genera una clave nueva, actualiza la aplicación y, cuando la nueva funcione, desactiva o elimina la comprometida en la consola de Cloud. Borrar la antigua antes de tiempo deja el servicio caído. Las auth keys añaden un bloqueo rápido de las claves filtradas que detectan los sistemas de Google, pero eso no sustituye a la rotación ni a revisar el uso del proyecto en AI Studio.

Envía una petición de prueba pequeña

La guía de inicio de Gemini API usa, a 8 de octubre de 2026, el endpoint Interactions y el modelo gemini-3.8-flash. Ese modelo figura como gratuito en el nivel Free de la tabla de precios de Gemini API, así que la prueba no necesita facturación. La clave viaja en una cabecera, no en la URL:

curl -sS -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Confirma en una frase breve que la conexión API funciona."
  }'

No evalúes una frase exacta. La señal válida es una respuesta estructurada del dominio esperado, autenticada con la credencial del proyecto previsto, con estado completado y salida del modelo.

No uses un modelo de imagen como primera prueba: en un proyecto sin facturación fallará por el nivel, no por la clave, y confundirá el diagnóstico. Los identificadores de modelo cambian; si la guía de inicio muestra otro ejemplo, copia ese en lugar de probar nombres antiguos al azar.

Conserva el error que ayuda a decidir

Antes de rotar nada, guarda el estado HTTP, el cuerpo sin datos sensibles, el identificador del proyecto, el endpoint, el modelo, la hora UTC y el identificador de solicitud. Nunca guardes la clave completa. Cambia una sola variable y repite la misma petición de prueba.

Una llamada correcta prueba la autenticación de ese camino, no su capacidad de producción. Una clave válida puede chocar con la cuota; un proyecto de pago puede usar una variable equivocada.

El gráfico es anterior a la actualización del 8 de octubre de 2026 (fecha de septiembre para las claves estándar y planes Free/Paid/Prepay); los niveles y reglas vigentes están en el texto.

Separa creación, cuota y facturación

Crear la clave no tiene coste. Lo que decide si pagas es el nivel del proyecto y el modelo que llamas. A 8 de octubre de 2026, la tabla de precios de Gemini API marca como gratuitos en el nivel Free, entre otros, Gemini 3.8 Flash, 3.7 Flash, 3.6 Flash, 3.5 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite, 2.5 Pro, 2.5 Flash, 2.5 Flash-Lite y Gemma 4. No están disponibles sin pagar Gemini 3.1 Pro Preview, Gemini Omni Flash ni ningún modelo de imagen (Nano Banana 2.1, Nano Banana 2, Nano Banana Pro, Gemini 2.5 Flash Image). Batch, Flex y la fundamentación con la Búsqueda de Google tampoco entran en el nivel gratuito, y en ese nivel Google puede usar tus datos para mejorar sus productos; en el de pago, no.

La documentación de límites de Gemini API no publica una tabla de RPM o solicitudes diarias por modelo: los límites activos de tu proyecto se ven en la página de límites de AI Studio. Varias claves del mismo proyecto comparten esos límites; no son varias bolsas de cuota. El detalle está en límites del nivel gratuito de Gemini API.

El paso de Free a Tier 1 suele aplicarse al instante y se gestiona desde la página Projects de AI Studio. Como referencia de pago, Gemini 3.8 Flash cuesta USD 0,75 por millón de tokens de entrada y USD 3,75 de salida hasta el 31 de diciembre de 2026, y USD 1,50 y USD 7,50 desde el 1 de enero de 2027.

Decide si te basta el nivel gratuito o necesitas Tier 1 después de medir la primera llamada y la carga real. Para el cálculo económico usa la guía de precios de Gemini API y la tabla oficial.

Antes de producción deja registrados el identificador del proyecto, propietario de la credencial, Key Type, ubicación del secreto, responsable de rotación, backend permitido, modelo, límites vigentes y nivel de facturación. Esa ficha permite revocar con precisión y evita que una integración dependa de una credencial cuya administración nadie tiene asignada.

Preguntas frecuentes sobre la clave API de Gemini

¿La API key de Gemini es gratis?

Sí. Crear la clave en Google AI Studio no cuesta nada y, sin facturación vinculada, el proyecto queda en el nivel Free, donde a 8 de octubre de 2026 funcionan gratis modelos como Gemini 3.8 Flash o 2.5 Pro. Los modelos de imagen y Gemini 3.1 Pro Preview exigen pasar a Tier 1.

¿Cómo consigo una clave API de Google AI Studio?

Entra en la página de claves de Google AI Studio con tu cuenta de Google. Si es tu primera vez, al aceptar las condiciones se crean un proyecto y una clave por defecto; si ya usas Google Cloud, importa el proyecto y pulsa Create API key.

¿Qué es exactamente la clave API de Google AI Studio?

Es la credencial que autentica tus peticiones a Gemini API en nombre de un proyecto de Google Cloud. Desde el 28 de mayo de 2026 es una clave de autorización vinculada a una cuenta de servicio; no es una suscripción a Gemini ni da cuota propia por clave.