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

Configura un proyecto de traducción

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

Configura un proyecto de traducción con la consola de GDC y la CLI de gdcloud de la siguiente manera:

Consola de GDC: Habilita la API de Vertex AI Translation y consulta el estado del servicio y el extremo.
La CLI de gcloud: Configura cuentas de servicio para interactuar con la API de Vertex AI Translation, instala bibliotecas cliente y autentica solicitudes a la API.

Crea un proyecto

Crear un proyecto de traducción dentro de tu jerarquía de recursos de Distributed Cloud organiza tus recursos de Vertex AI Translation, que incluyen colaboradores, APIs habilitadas, herramientas de supervisión, información de facturación, credenciales de autenticación y controles de acceso.

Para crear tu 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 el rol de desarrollador de AI Translation en tu proyecto para acceder a los servicios de traducción y generar un token de API para la autenticación y autorización de solicitudes.

Pídele al administrador de IAM del proyecto que otorgue el rol de desarrollador de AI Translation (ai-translation-developer) a tu usuario o cuenta de servicio dentro del espacio de nombres de tu proyecto. Para obtener información sobre este rol, consulta Cómo preparar permisos de IAM.

Habilita la API de Vertex AI Translation

Debes habilitar la API de Vertex AI Translation previamente entrenada para tu proyecto. Si está habilitada, puedes ver el estado del servicio y el extremo de la API de Vertex AI Translation previamente entrenada.

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 Vertex AI Translation, ya que facilitan el acceso a las APIs.

Instala la biblioteca cliente de Vertex AI Translation y sigue estos pasos para asegurarte de tener la versión correcta:

Verifica si la biblioteca cliente de Vertex AI Translation está instalada y obtén el número de versión:
```
pip freeze | grep translation
```
Si la biblioteca cliente ya está instalada, obtendrás un resultado similar al siguiente ejemplo:
```
google-cloud-translation==3.8.0
```
El número de versión que obtengas debe coincidir con la biblioteca cliente en el siguiente extremo:
```
https://GDC_URL/.well-known/static/client-libraries
```
Reemplaza GDC_URL por la URL de tu organización en GDC.
Si los números de versión no coinciden, desinstala la biblioteca cliente:
```
pip uninstall google-cloud-translation
```
Si desinstalaste la biblioteca cliente de Vertex AI Translation, debes volver a instalarla especificando el nombre de archivo correspondiente a tu sistema operativo.

Configura las variables de entorno

Después de instalar la biblioteca cliente de Vertex AI Translation, 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 la secuencia de comandos de Python para acceder a valores como las claves de la cuenta de servicio durante la ejecución.

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

Crea un notebook de JupyterLab para interactuar con la API previamente entrenada de Vertex AI Translation.
Crea una secuencia de comandos de Python en el notebook de JupyterLab.
Agrega el siguiente código a la secuencia de comandos de Python:
```
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.
Guarda la secuencia de comandos de Python con un nombre, como translation.py.
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, como translation.py.

Configura la autenticación

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