Herramientasgemini
API key Gemini gratis: crea y protege tu clave
Crea una API key de Gemini desde Google AI Studio, comprueba el acceso gratuito, la cuota y la facturación de tu proyecto y protege la clave.
- Autor: humAIns
- 9 min de lectura
índice · 6 apartados
Una API key de Gemini es una credencial para autenticar solicitudes a la Gemini API. Puedes crearla o gestionarla desde Google AI Studio, pero tener una clave no garantiza que cualquier modelo, región o cantidad de uso sea gratis: revisa el nivel y los límites del proyecto antes de probar. En esta guía verás el flujo básico, una petición de prueba y cómo guardar la clave sin exponerla.
Qué es una API key y cómo encajan AI Studio, proyecto y Gemini API
La API key es una credencial que acompaña una solicitud para que Google identifique el proyecto asociado y aplique las reglas de acceso, cuota y, cuando corresponda, facturación. No es una contraseña de tu cuenta de Google ni un plan de uso ilimitado.
Google AI Studio es la interfaz desde la que puedes administrar proyectos y claves y consultar la documentación de Gemini API. El proyecto de Google Cloud al que se asocia la clave reúne permisos, cuotas y configuración de facturación. La API es el servicio que recibe tus peticiones. Si cambias de proyecto o usas una clave de otro proyecto, pueden cambiar las cuotas y el estado de acceso.
Google documenta dos tipos de claves: estándar y de autorización. Según la documentación consultada el 15 de noviembre de 2026, desde el 28 de mayo de 2026 las claves nuevas creadas en AI Studio son claves de autorización ligadas a una cuenta de servicio. La misma documentación indica que la API rechaza claves estándar sin restricciones explícitas; las claves estándar restringidas a la API de Gemini continúan funcionando. Por eso, no des por válido un tutorial antiguo que dé por hecho que todas las claves son iguales.
Cómo obtener una clave desde el flujo oficial
Los nombres y la disposición de la interfaz pueden cambiar. Estos son los pasos generales documentados por Google; usa lo que aparezca en tu cuenta:
- Abre Google AI Studio e inicia sesión con la cuenta adecuada.
- Abre el área de proyectos. Si ya tienes un proyecto de Google Cloud, puede que tengas que importarlo para que aparezca en AI Studio. Google avisa de que los proyectos importados podrían necesitar verificación antes de acceder al nivel gratuito.
- Selecciona el proyecto en el que harás la prueba y revisa permisos. Si no puedes crear la clave, puede faltarte autorización para gestionar el proyecto o crear credenciales; pide al administrador que te dé el acceso necesario, en vez de reutilizar una clave ajena.
- Ve a la página de claves de API y elige crear o consultar una clave para ese proyecto. Copia el valor una sola vez en un lugar privado.
- Guarda la clave como secreto en la configuración de tu entorno de pruebas. No la pegues en una conversación, un documento compartido o una captura.
Para un primer experimento profesional, utiliza una cuenta y un proyecto autorizados por tu organización. No pruebes con datos personales, de clientes o confidenciales: una petición a un servicio externo puede salir del entorno que controla tu empresa. La guía de privacidad de la IA en el trabajo ayuda a revisar qué información no se debe enviar.
Comprueba acceso gratuito, región y facturación
La página oficial de precios de Gemini API presenta un nivel gratuito con acceso limitado a ciertos modelos y tokens de entrada y salida sin coste, junto a niveles de pago con límites más altos y otras funciones. Esto no significa que todos los modelos o herramientas estén disponibles gratis ni que las condiciones permanezcan iguales. Google también indica que el uso de Google AI Studio es gratuito en las regiones disponibles, pero la API y los modelos tienen sus propias condiciones.
Antes de mandar una solicitud, comprueba en AI Studio:
- qué proyecto está seleccionado y si está verificado para la modalidad que quieres usar;
- qué modelos aparecen habilitados para ese proyecto y región;
- los límites activos para el modelo elegido;
- si el proyecto tiene facturación configurada y qué modalidad de uso se aplicará.
Los límites de Gemini API se aplican por proyecto y pueden variar según el modelo, el nivel de uso y el estado de la cuenta. Google describe dimensiones como solicitudes por minuto, tokens de entrada por minuto y solicitudes por día. Superar cualquiera puede producir un error. Consulta la pantalla actual de AI Studio y la documentación de límites de frecuencia; no copies cifras de una guía antigua como si fueran una cuota permanente.
Si la consola ofrece la posibilidad de activar facturación, entiende primero qué cambio implica para ese proyecto. La página oficial de precios explica que configurar facturación permite pasar del nivel gratuito al de pago; no asumas que una clave gratuita impide cargos posteriores si el proyecto tiene facturación activa. Comprueba precios y uso en las páginas oficiales antes de escalar una prueba.
Primera petición con datos ficticios
Una forma prudente de validar la configuración es usar el ejemplo oficial de inicio rápido y una frase inventada, sin nombres de clientes ni contenido de trabajo. Las bibliotecas de Gemini pueden leer la clave de la variable de entorno GEMINI_API_KEY o GOOGLE_API_KEY; si están definidas las dos, la documentación de claves indica que GOOGLE_API_KEY tiene prioridad. Usa la guía de inicio rápido oficial para elegir el modelo y el cliente vigentes, porque esos identificadores cambian.
En un terminal, el patrón de configuración es guardar el secreto en una variable de entorno de tu sesión y ejecutar el ejemplo oficial desde ese mismo entorno. No escribas el valor de la clave directamente en el código. La API key no debe aparecer ni en el comando guardado en el historial, ni en una captura, ni en un registro que compartas. Si no tienes experiencia programando, empieza con los ejemplos ejecutables que ofrece AI Studio y mantén la misma precaución: no compartas ni publiques la clave.
Interpreta el resultado con calma:
- Una respuesta normal indica que esa petición llegó al servicio, no que todas las funciones estén habilitadas ni que el uso futuro vaya a ser gratis.
- Un error de autenticación o permiso puede indicar una clave incorrecta, un proyecto no preparado, permisos insuficientes o una clave estándar sin la restricción requerida. Vuelve a AI Studio y revisa el proyecto y el tipo de clave.
- Un error de cuota o recursos agotados suele señalar un límite activo. Comprueba el modelo, el consumo y el periodo de restablecimiento en la vista de uso; no generes claves nuevas esperando que reinicien los límites, porque las cuotas se aplican al proyecto.
Si después necesitas automatizar una tarea concreta, nuestra guía de integración de Gemini con n8n explica ese flujo específico; esta página se centra en crear y proteger la credencial. Para comparar el coste y los límites generales, consulta también precios de Gemini.
Seguridad: guarda, limita y revoca la clave
Trata la API key como una contraseña: quien la consiga puede consumir cuota del proyecto y, si hay facturación asociada, generar uso facturable. Google recomienda no subir claves a sistemas de control de versiones ni incrustarlas en aplicaciones web o móviles distribuidas al usuario. En producción, una aplicación de navegador debería llamar a un servidor propio que mantenga el secreto, no revelar la credencial al cliente.
Para una prueba local, usa una variable de entorno y evita guardar el valor en el repositorio. En un equipo, sigue el gestor de secretos aprobado por la organización. Cuando sea posible, limita la credencial al servicio y al contexto que necesita. Las opciones disponibles dependen del tipo de clave y de la consola: la documentación actual recomienda restringir claves estándar y explica las restricciones de la API de Gemini. Verifica que la clave resultante sigue funcionando después de aplicar un cambio.
Si crees que la clave se ha filtrado, actúa como si ya estuviera en manos de otra persona: crea una nueva, actualiza la aplicación, verifica que funciona y luego inhabilita o elimina la anterior en la consola correspondiente. Revisa el uso y la facturación del proyecto para detectar actividad que no reconoces. Borrar la cadena de un archivo público no revoca la credencial ni elimina copias que otra persona ya haya hecho.
Preguntas frecuentes
¿Necesito tarjeta para crear una clave?
La documentación oficial describe un nivel gratuito y una modalidad de pago que requiere configurar facturación, pero no confirma una regla universal sobre tarjetas para todas las cuentas y regiones. Sigue el flujo de AI Studio de tu cuenta y no actives facturación si tu prueba no la necesita.
¿La clave de AI Studio es la misma que para Gemini API?
AI Studio permite crear y administrar claves asociadas a proyectos que autentican solicitudes de Gemini API, sujeto al tipo de clave, los permisos y las condiciones vigentes. Las nuevas claves de AI Studio son de autorización desde el 28 de mayo de 2026, según la documentación oficial consultada.
¿Qué ocurre si agoto la cuota?
Puedes recibir un error de límite o de recursos agotados. Revisa los límites activos y el uso del proyecto en AI Studio. La cuota depende del proyecto y del modelo; crear otra clave del mismo proyecto no la reinicia.
¿Cómo revoco una clave filtrada?
Crea una sustituta, cambia la aplicación y prueba que funciona; después deshabilita o elimina la clave comprometida y revisa el uso del proyecto. Si estaba publicada, asume que ya fue copiada y no confíes en borrarla del historial como única medida.
Si trabajas en marketing, aprender a elegir una tarea adecuada y revisar el resultado importa tanto como conectar una API. Conoce el curso de IA para marketing y comprueba primero qué te queda por aprender con el diagnóstico.
Sigue leyendo en humAIns