Cloud Translation – Advanced permet de traduire du texte à l'aide de modèles personnalisés, et de créer des glossaires pour garantir la traduction correcte par l'API Cloud Translation de la terminologie propre à un domaine d'un client.
Pour obtenir des instructions sur l'installation de 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. Si vous envisagez d'utiliser un glossaire ou les fonctionnalités par lot, vous devez également créer un bucket Cloud Storage et y accorder l'accès à votre compte de service.
Pour traduire des documents formatés, tels que des PDF, consultez la section Traduire des documents.
Avant de commencer
Pour pouvoir utiliser l'API Cloud Translation, vous devez disposer d'un projet pour lequel cette API est activée, ainsi que des identifiants appropriés. Vous pouvez également installer des bibliothèques clientes pour les langages de programmation courants afin de faciliter les appels à l'API. Pour en savoir plus, consultez la page Configuration.
Comparer des modèles
Lorsque vous demandez une traduction à partir de Cloud Translation – Advanced, vous pouvez spécifier le modèle de traduction à utiliser. Si aucun modèle n'est spécifié, le modèle nmt
est utilisé.
Modèle | ID du modèle | Cas d'utilisation | Exemples |
---|---|---|---|
Modèle de traduction automatique neuronale (NMT) | general/nmt |
Textes généraux tels que le contenu de site Web courant non spécifique à un domaine (articles de presse, par exemple). |
Articles de presse, médias sociaux, applications de chat, avis |
Grand modèle de langage (LLM) de traduction (preview) | general/translation-llm |
Autre modèle proposé sur Cloud Translation - Advanced dans deux modes. Traduction de texte pour des cas d'utilisation de texte généraux, tels que des messages conversationnels qui ne nécessitent pas de personnalisation. Et la traduction adaptative, qui permet la personnalisation en temps réel à l'aide d'un ensemble de données avec des exemples. |
Articles de presse, médias sociaux, applications de chat, avis |
Modèle AutoML Translation | L'ID du modèle est généré une fois l'entraînement du modèle terminé. | Texte spécifique au domaine. Les clients fournissent des données d'entraînement spécifiques à leurs cas d'utilisation, pour des combinaisons linguistiques données, afin de personnaliser le modèle NMT Google pour les besoins du domaine. | Informations financières, documents techniques, tout texte utilisant des termes et un jargon uniques à ce domaine. |
Considération
Chaque modèle accepte ses propres langues définies. Vérifiez que les langues source et cible sont compatibles. Pour en savoir plus, consultez la section Langues acceptées.
Traduire du texte
Pour les traductions, 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. Il 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.
Traduire des chaînes d'entrée
REST
Pour traduire du texte, effectuez une requête POST
dont le corps contienne un format JSON qui identifie 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. Cet exemple fait intervenir le jeton d'accès associé à un compte de service configuré pour le projet à l'aide de Google Cloud CLI.
Pour obtenir des instructions sur l'installation de 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 ci-dessous, 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.
Langues 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 de 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 traduit du 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 ou de la réponse de l'API lors de l'entraînement du modèle. Pour utiliser le LLM de traduction, spécifiez general/translation-llm
comme ID de modèle.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud.
- LOCATION : région où 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.
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.
Langues 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 de Ruby sur la page des bibliothèques clientes, puis consultez la documentation de référence sur Cloud Translation pour Ruby.
Translittération
La translittération est un paramètre de configuration dans la méthode translateText
. Lorsque vous activez cette fonctionnalité, vous traduisez du texte romanisé (script latin) directement dans une langue cible. Par exemple, vous pouvez traduire du texte japonais romanisé directement en anglais, en espagnol ou en chinois. Les traductions obtenues sont dans le système d'écriture de la langue cible.
Dans vos requêtes de translittération, n'incluez que du texte romanisé. Si vous combinez du texte romanisé avec du texte non romanisé, Cloud Translation ne peut pas garantir des traductions cohérentes et appropriées.
Remarques
La translittération diffère de la traduction de texte standard sur les points suivants :
- La translittération est compatible avec un nombre limité de langues. Pour en savoir plus, consultez la colonne Translittération de la page Langues disponibles.
- Le type MIME doit être
text/plain
. Le format HTML n'est pas accepté. - La translittération n'est compatible qu'avec le modèle standard par défaut. Les modèles personnalisés ne sont pas acceptés.
- La translittération présente un quota de contenu par défaut inférieur. Pour en savoir plus, consultez la page Quotas et limites.
REST
Définissez le champ transliteration_config
sur la méthode translateText
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_NUMBER_OR_ID : ID numérique ou alphanumérique de votre projet Google Cloud.
- LOCATION : région dans laquelle vous souhaitez exécuter cette opération. Par exemple,
us-central1
. - SOURCE_LANGUAGE (facultatif) : code de langue du texte d'entrée. Si vous le connaissez, définissez l'un des codes de langue répertoriés dans la page Langues acceptées.
- TARGET_LANGUAGE : langue cible vers laquelle traduire le texte d'entrée. Définissez l'un des codes de langue répertoriés dans la page Langues acceptées.
- SOURCE_TEXT : texte romanisé dans la langue source à traduire.
Méthode HTTP et URL :
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Corps JSON de la requête :
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Autres ressources
- Pour obtenir de l'aide sur la résolution des erreurs ou des problèmes courants, consultez la page Dépannage.