Se usó la API de Cloud Translation para traducir esta página.

Comenzar a usar Gemini

En esta página, se ayuda a los desarrolladores a configurar un proyecto aislado de Google Distributed Cloud (GDC) para usar los modelos de Gemini. Este proceso incluye la creación de un proyecto, la habilitación de la API de Gemini, la instalación de bibliotecas cliente, la definición de variables de entorno y la autenticación de tus credenciales. Si no conoces Gemini, obtén más información sobre sus capacidades.

Para comenzar a usar Gemini, sigue estos pasos con la consola de GDC y la CLI de gdcloud:

Consola de GDC: Habilita la API de Gemini y consulta el estado del modelo y el extremo.
CLI de gcloud: Configura cuentas de servicio, instala bibliotecas cliente y autentica solicitudes a la API.

Crea un proyecto

Crear un proyecto dentro de tu jerarquía de recursos de Distributed Cloud organiza tus recursos, que incluyen colaboradores, APIs habilitadas, credenciales de autenticación y controles de acceso.

Gemini es uno de los modelos de IA generativa que ofrece Vertex AI en GDC. Por lo tanto, para crear un proyecto, consulta Configura un proyecto para Vertex AI. Necesitas el ID del proyecto cuando realices llamadas a la API.

Cómo solicitar permisos de desarrollador

Debes tener los roles adecuados en tu proyecto para acceder a las capacidades de Gemini y generar tokens de API para la autenticación y autorización de solicitudes.

Pídele al administrador de IAM del proyecto que otorgue uno de los roles asociados a Gemini a tu cuenta de usuario o servicio dentro del espacio de nombres del proyecto. Para obtener información sobre los roles de Gemini, consulta Cómo preparar permisos de IAM.

Se habilitará la API de Gemini.

Debes habilitar la API de Gemini para tu proyecto. Si está habilitada, puedes ver el estado del servicio y el endpoint de la API de Gemini.

Instala bibliotecas cliente

Las bibliotecas cliente están disponibles para el lenguaje de programación Python. Te recomendamos que uses estas bibliotecas cliente para realizar llamadas a la API de Gemini, ya que facilitan el acceso a las APIs.

Para usar el SDK de Python compatible con OpenAI, instala el SDK de OpenAI y otras bibliotecas de Python obligatorias:

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Configura las variables de entorno

Después de instalar las bibliotecas cliente, puedes interactuar con la API desde una secuencia de comandos de Python.

Si configuras una cuenta de servicio en tu proyecto para realizar llamadas a la API autorizadas de forma programática, puedes definir variables de entorno en una secuencia de comandos de Python para acceder a valores como las claves de la cuenta de servicio.

Sigue estos pasos para configurar las variables de entorno requeridas en una secuencia de comandos de Python:

Crea una secuencia de comandos de Python.
Agrega el siguiente código a la secuencia de comandos de Python:
Producción
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
Reemplaza APPLICATION_DEFAULT_CREDENTIALS_FILENAME por el nombre del archivo JSON que contiene las claves de la cuenta de servicio que creaste en el proyecto, como my-service-key.json.
Desarrollo
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
Reemplaza lo siguiente:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: Es el nombre del archivo JSON que contiene las claves de la cuenta de servicio que creaste en el proyecto, como my-service-key.json.
- CERT_NAME: el nombre del archivo del certificado de la autoridad certificadora (CA), como org-1-trust-bundle-ca.cert. Para obtener más información, consulta Cómo generar el archivo de certificado de CA del paquete de confianza en un entorno de desarrollo.
Guarda la secuencia de comandos de Python con un nombre.
Ejecuta la secuencia de comandos de Python para establecer las variables de entorno:
```
python SCRIPT_NAME
```
Reemplaza SCRIPT_NAME por el nombre que le diste a tu secuencia de comandos de Python.

Configura la autenticación

Antes de comenzar a usar la API de Gemini, debes autenticar tus credenciales de cliente y solicitar acceso a la cuenta para los recursos de tu proyecto. Para obtener más información, consulta Autentica solicitudes a la API.