Sí: Gemini Developer API ofrece un nivel gratuito para modelos y funciones elegibles, y la clave oficial se crea o gestiona desde Google AI Studio. Pero la clave no es un cupón de uso ilimitado. Está vinculada a un proyecto, los límites se aplican al proyecto y la disponibilidad gratuita depende del modelo y de las condiciones que Google muestre en ese momento.
Por eso, la comprobación útil no termina al copiar una clave. Antes de escribir código conviene confirmar cuatro cosas en tu cuenta: que el modelo elegido admite el nivel gratuito, qué cuota tiene activa el proyecto, si hay facturación asociada y cómo se tratarán los datos enviados. Después puedes guardar la clave fuera del código y ejecutar una petición mínima.
Esta guía usa documentación pública de Google revisada el 15 de agosto de 2026. No accedimos a una cuenta autenticada ni hicimos una solicitud con una clave real, así que no podemos confirmar la elegibilidad, la cuota o el método de pago de un lector concreto.
Qué significa realmente «clave de API gratis»
La expresión mezcla tres elementos distintos:
- La clave de API es la credencial que autentica la solicitud y se asocia a un proyecto de Google Cloud.
- El nivel gratuito es una condición de uso que solo cubre determinados modelos y funciones.
- La cuota define cuánto puede consumir el proyecto en dimensiones como solicitudes por minuto (RPM), tokens por minuto (TPM) o solicitudes por día (RPD).
Tener una clave no demuestra que cualquier modelo sea gratuito ni garantiza una cantidad concreta de solicitudes. Google indica que los límites se aplican por proyecto, no por clave. Crear varias claves dentro del mismo proyecto, por tanto, no multiplica la cuota disponible.
España y México figuran actualmente en la lista oficial de regiones disponibles. Esa inclusión permite plantear el acceso desde ambos mercados, pero no garantiza que una cuenta concreta vea el mismo modelo, la misma cuota o la misma modalidad de pago.
La comprobación que evita la mayoría de errores
Antes de elegir un ejemplo de Internet, abre la tabla vigente de precios de Gemini Developer API y busca el modelo exacto que piensas usar. Comprueba que la fila o función necesaria aparece como elegible en el nivel gratuito. Después abre la vista de límites de tu proyecto en AI Studio: esa pantalla es más relevante para tu caso que una cifra copiada de una guía antigua.
Si una página promete «Gemini API gratis e ilimitada», probablemente está omitiendo la cuota o hablando de un intermediario con otro contrato. Para el acceso oficial, «gratis» significa uso elegible dentro de límites, no capacidad infinita.
Obtén la clave oficial y confirma el proyecto correcto
Entra en Google AI Studio con la cuenta que utilizarás para desarrollar. La página puede pedirte iniciar sesión y aceptar condiciones antes de mostrar las opciones disponibles.
Al crear o administrar la clave:
- Identifica el proyecto de Google Cloud al que quedará asociada. Si perteneces a una organización, quizá necesites permisos del administrador.
- Crea una clave nueva o selecciona una existente que corresponda al proyecto correcto.
- Copia el secreto una sola vez y guárdalo en un gestor seguro; evita pegarlo en notas compartidas, capturas o conversaciones.
- Revisa en el mismo proyecto el modelo que vas a invocar, los límites activos y el estado de facturación.
La documentación oficial de claves distingue entre cuentas y proyectos nuevos, proyectos ya importados y entornos administrados por una organización. Si AI Studio no muestra el proyecto esperado, no continúes creando claves al azar: verifica primero la cuenta, los permisos y la selección de proyecto.
Una clave creada no equivale a una cuenta verificada
La interfaz puede cambiar y las condiciones dependen de la cuenta. Esta guía no puede asegurar que no te pedirán una tarjeta, que recibirás una cuota concreta o que podrás usar inmediatamente un modelo determinado. Esas afirmaciones solo se pueden resolver viendo el estado autenticado de tu propio proyecto.
Usa esta decisión práctica:
| Lo que observas | Qué puedes concluir | Qué debes comprobar después |
|---|---|---|
| AI Studio permite crear o administrar una clave | Tienes una credencial asociada a un proyecto | Modelo elegible, cuota y restricciones del proyecto |
| El modelo figura en la columna gratuita de precios | Existe una oferta gratuita publicada para ese modelo o función | Disponibilidad y límite activo en tu cuenta |
| AI Studio muestra cuota disponible | El proyecto tiene ese límite configurado en ese momento | Consumo, errores y posibles cambios de nivel |
| Aparece un flujo para activar facturación | Puedes evaluar el paso a pago | Modalidad, importe, moneda y condiciones de tu cuenta y región |
Revisa cuota, facturación y uso de datos antes de llamar
La documentación de límites explica que una solicitud puede quedar condicionada por más de una dimensión. Aunque no hayas agotado las solicitudes diarias, podrías alcanzar un límite por minuto o por tokens. Además, un límite publicado no es una promesa de capacidad efectiva: la vista del proyecto y la respuesta de la API son las referencias operativas.
No copies una cifra fija de RPM, TPM o RPD en tu configuración como si fuera universal. Los modelos, niveles y cuotas cambian. Para un prototipo, empieza con poca concurrencia, registra los errores de límite y añade reintentos con espera progresiva solo cuando entiendas cómo se comporta tu carga.
El nivel gratuito y Google Cloud Billing no son lo mismo
Las cuentas elegibles pueden empezar en el nivel gratuito. Pasar a un nivel de pago requiere Google Cloud Billing, y el flujo actual puede usar prepago según la cuenta y la región. Revisa la documentación de facturación de Gemini API dentro de tu sesión antes de aceptar cualquier cambio.
También hay una distinción fácil de pasar por alto: según la documentación vigente revisada para esta guía, los créditos promocionales o de prueba de Google Cloud emitidos bajo la política posterior a marzo de 2026 no pagan el uso de Gemini API o AI Studio. Algunas cuentas antiguas pueden tener excepciones, así que prevalece el texto de las condiciones de tu cuenta, no una suposición general.
Gratis también implica una decisión sobre los datos
La tabla oficial de precios diferencia el tratamiento del contenido: indica que el contenido del nivel gratuito puede utilizarse para mejorar productos de Google, mientras describe el contenido del nivel de pago como no utilizado para esa mejora.
Esto no sustituye una evaluación de privacidad o cumplimiento. Si el prototipo maneja datos personales, secretos comerciales, documentos de clientes o información regulada, no los envíes solo porque la llamada no tenga coste. Revisa las condiciones actuales y las obligaciones de tu organización antes de elegir el nivel.
Protege la clave antes de escribir la primera petición
Google recomienda tratar la clave como una contraseña. No la publiques en Git, no la incrustes en una aplicación web o móvil distribuida y no la pongas directamente en código que terminará en el navegador.
Para una prueba local, guárdala en una variable de entorno:
bashexport GEMINI_API_KEY="pega_aqui_tu_clave"
No copies el valor real en un archivo que vaya a subirse al repositorio. Si usas un archivo .env, añádelo a .gitignore antes del primer commit. En producción, realiza las llamadas desde un servidor y utiliza el gestor de secretos de tu plataforma.
Si crees que la clave se ha expuesto:
- Revócala o elimínala en AI Studio.
- Crea una credencial nueva para el proyecto correcto.
- Revisa registros y consumo anómalo.
- Corrige el lugar donde se almacenó antes de volver a desplegar.
Restringir una clave cuando el tipo y el entorno lo permitan reduce riesgo, pero no reemplaza la custodia del secreto.
Haz una primera llamada que no dependa de un modelo obsoleto
Los identificadores de modelo, las versiones de SDK y los ejemplos cambian. En lugar de copiar un nombre de modelo de una entrada antigua, abre el inicio rápido actual de Gemini API y toma de allí el identificador recomendado que además hayas comprobado como elegible para tu proyecto.
Guárdalo temporalmente en otra variable:
bashexport GEMINI_MODEL="identificador-del-modelo-confirmado"
Con ambas variables definidas, una petición REST mínima sigue esta forma:
bashcurl "https://generativelanguage.googleapis.com/v1beta/models/${GEMINI_MODEL}:generateContent" \ -H "x-goog-api-key: ${GEMINI_API_KEY}" \ -H "Content-Type: application/json" \ -X POST \ -d '{ "contents": [ { "parts": [ { "text": "Responde solo: conexión correcta" } ] } ] }'
El ejemplo evita publicar una clave y obliga a seleccionar conscientemente un modelo actual. Aun así, confirma la sintaxis en el quickstart enlazado antes de usarla: la superficie recomendada de la API puede cambiar.
Una respuesta JSON con contenido generado confirma que la credencial, el proyecto y el modelo funcionaron para esa solicitud concreta. No demuestra que la cuota futura esté garantizada ni que todas las funciones del modelo estén incluidas en el nivel gratuito.
Si la llamada falla, clasifica el error antes de cambiar de clave
- Error de autenticación o permiso: comprueba que la variable contiene la clave correcta, que la clave no fue revocada y que el proyecto permite el acceso.
- Modelo no encontrado o no disponible: vuelve a la documentación actual y revisa el identificador, la región y la disponibilidad para la cuenta.
- Límite de frecuencia o cuota: consulta la vista de límites del proyecto; crear otra clave en el mismo proyecto no aumenta la cuota.
- Facturación requerida: confirma si el modelo o la función elegidos pertenecen al nivel gratuito y revisa el estado de facturación antes de aceptar un cargo.
- Petición no válida: compara el cuerpo y el endpoint con el quickstart vigente; no asumas que un ejemplo antiguo conserva el mismo formato.
Cambiar simultáneamente clave, proyecto, modelo y código oculta la causa. Modifica una variable cada vez y conserva el código de estado y el mensaje de error sin registrar el secreto.
La verificación final son cinco respuestas, no una sola clave
Puedes considerar completada la puesta en marcha cuando puedas responder con evidencia de tu propia cuenta:
- ¿Qué proyecto contiene la clave? Debe ser el mismo donde revisarás cuota y facturación.
- ¿Qué modelo exacto usarás? Debe estar disponible y figurar como elegible para el nivel que deseas.
- ¿Qué límites muestra hoy el proyecto? Registra RPM, TPM y RPD pertinentes sin tratarlos como permanentes.
- ¿Dónde vive el secreto? Solo en una variable local o un gestor de secretos del servidor, nunca en el cliente o el repositorio.
- ¿Qué devolvió la primera llamada? Guarda el estado y el mensaje de error o una respuesta mínima, pero no la clave.
La respuesta corta a «¿puedo conseguir una clave de API de Gemini gratis?» es sí, para probar modelos y funciones elegibles dentro del nivel gratuito disponible en tu proyecto. La respuesta responsable añade lo importante: la clave por sí sola no concede uso ilimitado, no fija una cuota universal y no confirma las condiciones de pago. Verifica esos datos en AI Studio y en la documentación vigente antes de construir sobre ellos.
