Obtén una clave de API de Google Cloud

Para usar Gemini en Vertex AI, debes autenticarte 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 credenciales predeterminadas de la aplicación para la producción. En esta página, se muestra cómo obtener una clave de la API de Google Cloud según si ya tienes una cuenta de Google Cloud .

Selecciona si tienes una cuenta de Google Cloud :

Crea una Google Cloud clave de API

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

Antes de comenzar

Selecciona un proyecto, habilita la facturación y la API de 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.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Habilita la creación de claves de API de cuentas de servicio

  1. Abre IAM y administración > Políticas de la organización.
  2. En la lista de políticas, filtra las políticas llamadas iam.managed.disableServiceAccountApiKeyCreation.
  3. Haz clic en Acciones > Editar política.
  4. En Fuente de la política, selecciona Anular la política del elemento superior y, luego, haz clic en Agregar una regla.
  5. En Aplicación forzosa, selecciona Desactivada.
  6. Haz clic en Listo.
  7. Haz clic en Establecer política. En el diálogo que aparece, vuelve a hacer clic en Establecer política.

Crear una nueva cuenta de servicio

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

Crea 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 las llamadas a la API a través de una cuenta de servicio: Seleccionada.
  4. Haz clic en Seleccionar cuenta de servicio.
  5. Selecciona la cuenta de servicio que creaste en el paso anterior y haz clic en Seleccionar.
  6. Haz clic en Crear.

Realiza tu primera solicitud a la API

Después de obtener una clave de API, consulta la guía de inicio rápido de la API para aprender a usarla y realizar tu primera solicitud.

Opcional: Configura tu clave de API de forma local

Para las pruebas iniciales, puedes codificar de forma rígida una clave de API, pero esto solo debe ser 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 una variable de entorno con diferentes sistemas operativos.

Haz clic para expandir 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 es similar a este:

    /bin/bash

  2. Agrega una variable de exportación de shell para tu clave de API. Para ello, realiza una de las siguientes acciones:

    • Si el resultado del paso anterior es /bin/bash, haz lo siguiente:

      1. Abre .bashrc:

        touch ~/.bashrc
        open ~/.bashrc

      2. Agrega la línea siguiente a .bashrc:

        export GEMINI_API_KEY=YOUR_API_KEY

      3. Guarda el archivo y, luego, ejecuta el siguiente comando para aplicar los cambios:

        source ~/.bashrc

    • Si el resultado del paso anterior es /bin/zsh, haz lo siguiente:

      1. Abre .zshrc:

        touch ~/.zshrc
        open ~/.zshrc

      2. Agrega la línea siguiente a .zshrc:

        export GEMINI_API_KEY= YOUR_API_KEY

      3. Guarda el archivo y, luego, ejecuta el siguiente comando para aplicar los cambios:

        source ~/.zshrc

Windows

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