Vertex AI Translation dans l'appareil avec isolation physique Google Distributed Cloud (GDC) vous permet de traduire du texte et des documents entre les langues compatibles dans vos applications. Après avoir créé un projet et demandé des rôles de développeur, activez l'API Vertex AI Translation dans la console GDC pour afficher son état et son point de terminaison. Vous pouvez ensuite installer la bibliothèque cliente Python, définir des variables d'environnement et utiliser la CLI gdcloud pour configurer des comptes de service et authentifier les requêtes. Si vous ne connaissez pas Vertex AI, consultez En savoir plus sur les fonctionnalités de traduction.
Créer un projet
La création d'un projet de traduction permet d'organiser vos ressources Vertex AI Translation, qui incluent les collaborateurs, les API activées, les identifiants d'authentification et les contrôles d'accès.
Pour créer votre projet, consultez Configurer un projet pour Vertex AI. Vous aurez besoin de l'ID de votre projet pour effectuer des appels d'API.
Demander des autorisations de développeur
Vous devez disposer du rôle "Développeur AI Translation" dans votre projet pour accéder aux services de traduction et générer un jeton d'API pour l'authentification et l'autorisation des requêtes.
Demandez à l'administrateur IAM de votre projet d'accorder le rôle Développeur AI Translation (ai-translation-developer) à votre compte utilisateur ou de service dans l'espace de noms de votre projet. Pour en savoir plus sur ce rôle, consultez Préparer les autorisations IAM.
Activer l'API Vertex AI Translation
Vous devez activer l'API pré-entraînée Vertex AI Translation pour votre projet. Si elle est activée, vous pouvez afficher l'état du service et le point de terminaison de l'API pré-entraînée Vertex AI Translation.
Installer les bibliothèques clientes
Des bibliothèques clientes sont disponibles pour le langage de programmation Python. Nous vous recommandons d'utiliser ces bibliothèques clientes pour appeler l'API Vertex AI Translation, car elles facilitent l'accès aux API.
Installez la bibliothèque cliente Vertex AI Translation et suivez ces étapes pour vous assurer que vous disposez de la bonne version :
Vérifiez si la bibliothèque cliente Vertex AI Translation est installée et obtenez le numéro de version :
pip freeze | grep translationSi la bibliothèque cliente est déjà installée, vous obtenez un résultat semblable à l'exemple suivant :
google-cloud-translation==3.8.0Le numéro de version que vous obtenez doit correspondre à la bibliothèque cliente au point de terminaison suivant :
https://GDC_URL/.well-known/static/client-librariesRemplacez
GDC_URLpar l'URL de votre organisation dans GDC.Si les numéros de version ne correspondent pas, désinstallez la bibliothèque cliente :
pip uninstall google-cloud-translationSi vous avez désinstallé la bibliothèque cliente Vertex AI Translation, vous devez la réinstaller en spécifiant le nom de fichier correspondant à votre système d'exploitation.
Définir les variables d'environnement
Après avoir installé la bibliothèque cliente Vertex AI Translation, vous pouvez interagir avec l'API à partir d'un script Python.
Si vous configurez un compte de service dans votre projet pour effectuer des appels d'API autorisés de manière programmatique, vous pouvez définir des variables d'environnement dans le script Python pour accéder à des valeurs telles que les clés de compte de service lors de l'exécution.
Pour définir les variables d'environnement requises dans un script Python, procédez comme suit :
Créez un script Python.
Ajoutez le code suivant au script Python :
import os os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"Remplacez
APPLICATION_DEFAULT_CREDENTIALS_FILENAMEpar le nom du fichier JSON contenant les clés de compte de service que vous avez créées dans le projet, par exemplemy-service-key.json.Enregistrez le script Python sous un nom, par exemple
translation.py.Exécutez le script Python pour définir les variables d'environnement :
python SCRIPT_NAMERemplacez
SCRIPT_NAMEpar le nom que vous avez donné à votre script Python, par exempletranslation.py.
Configurer l'authentification
Avant de pouvoir utiliser l'API Vertex AI Translation, vous devez authentifier vos identifiants client et demander l'accès au compte pour les ressources de votre projet. Pour en savoir plus, consultez Authentifier les requêtes API.