La API de Interactions ya está disponible de forma general. Te recomendamos que uses esta API para acceder a todos los modelos y funciones más recientes.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Cómo usar claves de API de Gemini

Para usar la API de Gemini, debes autenticar tus solicitudes. Puedes autenticarte con una clave de API estándar o de autorización.

Crea o visualiza una clave de API de Gemini

Tipos de claves de API: estándar versus autorización

Las claves de API proporcionan acceso a la API de Gemini, pero sus características de seguridad difieren. La API de Gemini está haciendo la transición de claves de API estándar a claves de autorización para mejorar la seguridad:

Claves de API estándar: Asocian solicitudes con un proyecto de Google Cloud para fines de facturación y cuota. Las claves estándar no identifican a un llamador, lo que limita la granularidad de los permisos y el control de acceso que pueden admitir.
Claves de autorización (auth): Se vinculan directamente a una cuenta de servicio de Google Cloud. Cuando usas una clave de autorización, tus solicitudes se procesan con la identidad de esa cuenta de servicio vinculada, lo que permite un control de acceso detallado. De forma predeterminada, las claves de autorización están restringidas a la API de Generative Language (API de Gemini) y proporcionan una aplicación rápida de claves filtradas que detiene rápidamente el uso de claves filtradas detectadas por nuestros sistemas.

Para garantizar un uso seguro, la API de Gemini pasará de claves estándar a claves de autorización:

Claves de autorización predeterminadas: Todas las claves de API nuevas creadas en Google AI Studio se crean automáticamente como claves de autorización.
Claves no restringidas rechazadas: La API de Gemini rechaza las solicitudes de claves estándar no restringidas. Las claves de API estándar que tienen restricciones explícitas aplicadas siguen funcionando. Esta restricción evita el uso no autorizado de claves que podrían compartirse públicamente o vincularse a otros servicios.
En septiembre de 2026: La API de Gemini rechazará las solicitudes de claves estándar. Debes migrar a las claves de autorización antes de esta fecha para evitar interrupciones en el servicio. Asegúrate de migrar a las claves de autorización antes de septiembre de 2026.

Administra claves de API en Google AI Studio

Puedes administrar tus proyectos y claves directamente en Google AI Studio.

Proyectos de Google Cloud

Cada clave de API de Gemini está asociada con un proyecto de Google Cloud. Los proyectos de Google Cloud administran la facturación, los colaboradores y los permisos. Google AI Studio proporciona una interfaz ligera para acceder a estos proyectos.

Proyecto predeterminado: Si eres un usuario nuevo, Google AI Studio crea automáticamente un proyecto de Google Cloud y una clave de API predeterminados después de que aceptas las Condiciones del Servicio. Para cambiar el nombre de este proyecto, navega a la vista Proyectos en tu panel.
Proyectos existentes: Si ya tienes una cuenta de Google Cloud, AI Studio no crea un proyecto predeterminado. En su lugar, debes importar tus proyectos existentes.

Importa proyectos

De forma predeterminada, Google AI Studio no muestra todos tus proyectos de Google Cloud. Debes importar los proyectos que deseas usar:

Ve a Google AI Studio.
Abre el Panel desde el panel izquierdo y selecciona Proyectos.
Haz clic en el botón Importar proyectos.
Busca y selecciona el proyecto de Google Cloud que deseas importar y, luego, haz clic en Importar.
Una vez importado, navega a la página Claves de API en el panel para crear una clave en ese proyecto.

Soluciona problemas de permisos de creación de claves

Si el botón Crear clave de API no está disponible y muestra el mensaje: "No tienes permiso para crear una clave en este proyecto", significa que no tienes los permisos de IAM necesarios.

Pídele al administrador de tu proyecto o de tu organización de Google Cloud que te otorgue un rol que contenga los siguientes permisos (como Editor de proyectos):

resourcemanager.projects.get: Permite que AI Studio verifique el proyecto.
apikeys.keys.create: Permite la generación de claves.
serviceusage.services.enable: Garantiza que la API de Generative Language esté habilitada.
iam.serviceAccounts.create: Es necesario para crear la cuenta de servicio vinculada.
iam.serviceAccountApiKeyBindings.create: Vincula la cuenta de servicio a la clave de API.

Si no puedes obtener acceso administrativo, puedes crear un proyecto nuevo de Google Cloud que no esté asociado con una organización para generar tus claves.

Configura tu entorno

Una vez que tengas una clave, configura tu entorno para usarla de forma segura en tus aplicaciones.

Opción 1: Usa variables de entorno (recomendada)

Configura la variable de entorno GEMINI_API_KEY o GOOGLE_API_KEY. Las bibliotecas cliente de la API de Gemini detectan y usan automáticamente estas variables. Si se configuran ambas, GOOGLE_API_KEY tiene prioridad.

Selecciona tu sistema operativo para configurar la variable:

Linux/macOS - Bash

Verifica si tienes un archivo de configuración de bash:

~/.bashrc

De no ser así, crea uno y ábrelo:

touch ~/.bashrc && open ~/.bashrc

Agrega el comando de exportación al final del archivo:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Guarda el archivo y, luego, aplica los cambios:

source ~/.bashrc

macOS - Zsh

Verifica si tienes un archivo de configuración de zsh:

~/.zshrc

De no ser así, crea uno y ábrelo:

touch ~/.zshrc && open ~/.zshrc

Agrega el comando de exportación:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Guarda el archivo y, luego, aplica los cambios:

source ~/.zshrc

Windows

Busca "Variables de entorno" en la barra de búsqueda de Windows.
Haz clic en Variables de entorno en el diálogo Propiedades del sistema.
En Variables de usuario o Variables del sistema, haz clic en Nueva....
Establece el nombre de la variable en GEMINI_API_KEY y el valor en tu clave de API.
Haz clic en Aceptar para guardar los cambios. Abre una nueva sesión de la terminal para cargar la variable.

Opción 2: Proporciona la clave de API de forma explícita en el código

Puedes pasar la clave de API de forma explícita cuando inicializas el cliente. Solo haz esto si no puedes usar variables de entorno.

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

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