Obtener una clave de API de Google Cloud

Para usar Gemini en Vertex AI, autentícate con una Google Cloud clave de API o con credenciales predeterminadas de la aplicación. Te recomendamos que uses una clave de API para las pruebas y las credenciales de aplicación predeterminadas para la producción. En esta página se explica cómo obtener una clave de API de Google Cloud en función de si eres un usuario Google Cloud nuevo o ya tienes una cuenta.

Selecciona si tienes una cuenta de Google con un Google Cloud proyecto:

Crea una Google Cloud clave de API

Si ya tienes un Google Cloud proyecto, sigue estas instrucciones para obtener una clave de API Google Cloud estándar. También puedes usar credenciales predeterminadas de la aplicación en lugar de una clave de API.

Antes de empezar

Selecciona un proyecto, habilita la facturación y la API Vertex AI

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Habilitar la creación de claves de API de cuenta de servicio

  1. Abre IAM y administración > Políticas de organización.
  2. En la lista de políticas, filtra las políticas llamadas iam.managed.disableServiceAccountApiKeyCreation.
  3. Haga clic en Acciones > Editar política.
  4. En Fuente de la política, seleccione Anular la política de la empresa matriz y, a continuación, haga clic en Añadir regla.
  5. En Implementación obligatoria, selecciona Desactivada.
  6. Haz clic en Listo.
  7. Haz clic en Definir política. En el cuadro de diálogo que aparece, vuelve a hacer clic en Definir política.

Crear una cuenta de servicio

  1. Abre IAM & Admin > Service Accounts (IAM y administración > Cuentas de servicio).
  2. Haz clic en Crear cuenta de servicio.
  3. Configura la cuenta de servicio de la siguiente manera:
    • Nombre de la cuenta de servicio: vertex-ai-runner
    • ID de cuenta de servicio: vertexairunner
  4. Haz clic en Crear y continuar.
  5. En Permisos, haga clic en Seleccionar un rol y, en el menú, seleccione Usuario de Vertex AI Platform Express.
  6. Haz clic en Continuar.
  7. Haz clic en Listo.

Crear una clave de API

  1. Abre APIs y servicios > Credenciales.
  2. Haz clic en Crear credenciales > Clave de API.
  3. Configura la clave de API de la siguiente manera:
    • Nombre: vertexaiapikey
    • Autenticar llamadas a la API mediante una cuenta de servicio: seleccionada.
  4. Haz clic en Seleccionar cuenta de servicio.
  5. Selecciona la cuenta de servicio que has creado en el paso anterior y haz clic en Seleccionar.
  6. Haz clic en Crear.

Hacer tu primera solicitud a la API

Después de obtener una clave de API, consulta cómo usarla para hacer tu primera solicitud en la guía de inicio rápido de la API.

Opcional: Configurar tu clave de API de forma local

Para las pruebas iniciales, puedes codificar una clave de API, pero solo de forma temporal, ya que no es seguro. En el resto de esta sección se explica cómo configurar tu clave de API de forma local como variable de entorno con diferentes sistemas operativos.

Haz clic para ver las instrucciones

Linux/macOS

  1. Ejecuta el siguiente comando para ver qué shell de línea de comandos estás usando:

    echo $SHELL

    El resultado debería ser similar al siguiente:

    /bin/bash

  2. Añade una variable de exportación de shell para tu clave de API. Para ello, sigue uno de estos pasos:

    • Si el resultado del paso anterior es /bin/bash:

      1. Abre .bashrc:

        touch ~/.bashrc
        open ~/.bashrc

      2. Añade la siguiente línea a .bashrc:

        export GEMINI_API_KEY=YOUR_API_KEY

      3. Guarda el archivo y ejecuta lo siguiente para aplicar los cambios:

        source ~/.bashrc

    • Si el resultado del paso anterior es /bin/zsh:

      1. Abre .zshrc:

        touch ~/.zshrc
        open ~/.zshrc

      2. Añade la siguiente línea a .zshrc:

        export GEMINI_API_KEY= YOUR_API_KEY

      3. Guarda el archivo y ejecuta lo siguiente para aplicar los cambios:

        source ~/.zshrc

Windows

  1. Busca "Variables de entorno" en la configuración del sistema.
  2. Edita "Variables de usuario" (para el usuario actual) o "Variables de sistema" (para todos los usuarios; úsalas con precaución).
  3. Crea la variable y añade export GEMINI_API_KEY=YOUR_API_KEY
  4. Aplica los cambios