Traduire du texte
Cette page vous explique comment traduire un exemple de texte avec les éditions Basic et Advanced de Cloud Translation. Ils vous donnent accès au modèle standard de traduction automatique neuronale (NMT, Neural Machine Translation) et au LLM de traduction, qui est notre dernier modèle de traduction de type LLM.
L'API Cloud Translation – Basic offre un accès simple et immédiat à ces modèles. Cloud Translation – Advanced, en revanche, est optimisé pour la personnalisation et les cas d'utilisation de contenus longs. Pour obtenir un exemple de code, consultez l'exemple de traduction de texte avancée. Dans des situations particulières, vous pouvez également utiliser Cloud Translation – Advanced pour créer des modèles personnalisés.
Cloud Translation – Advanced offre également des fonctionnalités avancées de traduction de texte, comme la traduction de documents et la création de glossaires, afin de garantir la traduction correcte de la terminologie spécifique à votre domaine.
Avant de commencer
Avant de pouvoir utiliser l'API Cloud Translation, vous devez consulter la page Configurer Cloud Translation. Vous y apprendrez, entre autres, à créer un projet, à activer l'API Cloud Translation et à configurer l'authentification. La page de configuration fournit également des instructions pour installer des bibliothèques clientes pour les langages de programmation courants (facultatif).
LLM de traduction avec l'API Cloud Translation – Basic
Pour utiliser le modèle Translation LLM standard dans l'API Cloud Translation – Basic, transmettez son nom de ressource complet dans le paramètre model.
curl -X POST \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"q": ["The old lighthouse stood on the edge of the cliff."],
"target": "es",
"model": "projects/PROJECT_ID/locations/REGION_NAME/models/general/translation-llm"
}' \
"https://translation.googleapis.com/language/translate/v2?key=YOUR_API_KEY"
L'API Cloud Translation – Basic n'est compatible qu'avec les modèles NMT et LLM standards, et non avec les modèles personnalisés. Pour utiliser un modèle personnalisé ou d'autres fonctionnalités avancées comme la traduction de documents ou les glossaires, utilisez Cloud Translation – Advanced. Pour en savoir plus sur l'appel de l'API Basic, consultez l'exemple de traduction de texte Basic.
Traduction de texte avancée
Pour les traductions avec Cloud Translation – Advanced, le texte d'entrée peut être du texte brut ou du texte au format HTML. L'API Cloud Translation ne traduit pas les balises HTML contenues dans le texte d'entrée. Elle traduit seulement le texte qui se trouve entre les balises. La sortie conserve les balises HTML (non traduites) autour du texte traduit dans la mesure du possible étant donné que les langues source et cible sont différentes.
Exemple de traduction de texte avancée
REST
Pour traduire du texte, effectuez une requête POST et fournissez du code JSON dans le corps de la requête permettant d'identifier la langue source (source_language_code), la langue cible (target_language_code) et le texte à traduire (contents). Vous pouvez fournir plusieurs chaînes de texte à traduire en les incluant dans votre fichier JSON (voir l'exemple). Identifiez les langues source et cible à l'aide de leur code ISO-639.
Vous trouverez ci-dessous un exemple de requête POST effectuée avec curl ou PowerShell. L'exemple fait intervenir le jeton d'accès associé à un compte de service configuré pour le projet à l'aide de la Google CloudGoogle Cloud CLI.
Pour obtenir des instructions sur l'installation de la Google Cloud CLI, la configuration d'un projet avec un compte de service et l'obtention d'un jeton d'accès, consultez la page Configuration.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_NUMBER_OR_ID : ID numérique ou alphanumérique de votre projet Google Cloud .
Méthode HTTP et URL :
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Corps JSON de la requête :
{
"sourceLanguageCode": "en",
"targetLanguageCode": "ru",
"contents": ["Dr. Watson, come here!", "Bring me some coffee!"]
}
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"translations": [
{
"translatedText": "Доктор Ватсон, иди сюда!",
},
{
"translatedText": "Принеси мне кофе!",
}
]
}
Le tableau translations contient deux champs translatedText avec des traductions fournies dans la langue targetLanguageCode demandée (ru : russe). Les traductions sont répertoriées suivant le même ordre que le tableau source correspondant de la requête.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Go.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration pour Java du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Java.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Avant d'essayer cet exemple, suivez les instructions de configuration pour Node.js du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Node.js.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration pour Python du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Python.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langages supplémentaires
C# : Veuillez suivre les Instructions de configuration pour C# sur la page des bibliothèques clientes, puis consultez la Documentation de référence sur Cloud Translation pour .NET.
PHP : Veuillez suivre les Instructions de configuration pour PHP sur la page des bibliothèques clientes, puis consultez la Documentation de référence sur Cloud Translation pour PHP.
Ruby : Veuillez suivre les instructions de configuration pour Ruby sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Cloud Translation pour Ruby.
Traduire du texte à l'aide d'un modèle spécifique
REST
Vous pouvez spécifier le modèle à utiliser pour la traduction à l'aide du paramètre de requête model.
L'exemple suivant illustre la traduction de texte à l'aide d'un modèle personnalisé dont l'ID de modèle est 1395675701985363739. Vous pouvez obtenir l'ID d'un modèle personnalisé à partir de la liste des modèles de la console Google Cloud , de la réponse de l'API ou de la page Pantheon correspondante lorsque vous entraînez le modèle. Pour utiliser le LLM de traduction, spécifiez general/translation-llm comme ID de modèle. Pour utiliser le LLM de traduction personnalisé (version Preview publique), spécifiez models/translation-llm-custom/{model-id} comme ID de modèle.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION : région dans laquelle se trouve le modèle personnalisé, par exemple
us-central1.
Méthode HTTP et URL :
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Corps JSON de la requête :
{
"model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739",
"sourceLanguageCode": "en",
"targetLanguageCode": "ru",
"contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me.
Let's talk about spam and importance ranking in a confidential mode."]
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
"translation": {
"translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора.
Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о
спаме и важности рейтинга в конфиденциальном режиме.",
"model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739"
}
}
Go
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go du guide de démarrage rapide de Cloud Translation : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Cloud Translation en langage Go.
Pour vous authentifier auprès de Cloud Translation, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.