Traduction en temps réel à l'aide de l'API

Amazon Translate fournit les opérations de traduction en temps réel suivantes pour prendre en charge les applications interactives :

• TranslateText— traduit un bloc de texte.

• TranslateDocument— traduit le contenu d'un fichier (texte brut, HTML ou .docx).

Ces opérations synchrones renvoient le résultat de la traduction directement à votre application. Si vous utilisez la détection automatique de la langue lors de ces opérations, des frais peuvent vous être facturés. Pour en savoir plus, consultez Détection automatique de la langue.

Translate text

Utilisez cette TranslateTextopération pour traduire un seul bloc de texte.

Translate du texte à l'aide de la ligne de commande

L'exemple suivant montre comment utiliser l'TranslateTextopération depuis la ligne de commande. L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\), à la fin de chaque ligne par un accent circonflexe (^).

En ligne de commande, entrez la commande suivante.

aws translate translate-text \
            --region region \
            --source-language-code "en" \
            --target-language-code "es" \
            --text "hello, world"

La commande répond avec le code JSON suivant :

{
    "TargetLanguageCode": "es",
    "TranslatedText": "Hola, mundo",
    "SourceLanguageCode": "en"
}

Translate du texte à l'aide d'un fichier JSON

Cet exemple montre comment utiliser un fichier JSON pour traduire un bloc de texte plus long. Vous pouvez spécifier les langues source et cible sur la ligne de commande ou dans le fichier JSON.

Note

Le fichier JSON d'exemple est formaté dans un souci de lisibilité. Reformatez le champ "Text" pour supprimer les sauts de ligne.

L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\), à la fin de chaque ligne par un accent circonflexe (^).

Pour traduire un texte à l'aide d'un fichier JSON

1. Copiez le texte suivant dans un fichier JSON appelé translate.json :

   {
       "Text": "Amazon Translate translates documents between languages in 
       real time. It uses advanced machine learning technologies 
       to provide high-quality real-time translation. Use it to 
       translate documents or to build applications that work in 
       multiple languages.", 
       "SourceLanguageCode": "en", 
       "TargetLanguageCode": "fr"
   }

2. Dans AWS CLI, exécutez la commande suivante :

   aws translate translate-text \
               --region region \
               --cli-input-json file://translate.json > translated.json

   La commande produit un fichier JSON qui contient le texte JSON suivant :

   {
       "TargetLanguageCode": "fr", 
       "TranslatedText": "Amazon Translate traduit les documents entre 
       les langue en temps réel. Il utilise des technologies 
       avancées d'apprentissage de la machine pour fournir 
       une traduction en temps réel de haute qualité. Utilisez-le 
       pour traduire des documents ou pour créer des applications 
       qui fonctionnent en plusieurs langues.", 
       "SourceLanguageCode": "en"
   }
   

Translate document

Utilisez cette TranslateDocumentopération pour traduire un document texte, HTML ou Word (.docx) et renvoyer le résultat de la traduction directement à votre application.

La traduction de documents en temps réel prend en charge les traductions de l'anglais vers n'importe quelle langue prise en charge, et de n'importe quelle langue prise en charge vers l'anglais. Vous pouvez spécifier le code de langue source ou utiliser la détection automatique.

Translate le document à l'aide de la ligne de commande

L'exemple suivant montre comment utiliser l'TranslateDocumentopération depuis la ligne de commande. L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\), à la fin de chaque ligne par un accent circonflexe (^).

En ligne de commande, entrez la commande suivante.

aws translate translate-document \
            --region region \
            --source-language-code "en" \
            --target-language-code "es" \
            --document-content fileb://source-lang.txt 
            --document ContentType=text/plain 
            --query "TranslatedDocument.Content" 
            --output text | base64 
            --decode > target-lang.txt

La commande répond avec le code JSON suivant :

{
    "SourceLanguageCode": "en",
    "TargetLanguageCode": "es",
    "TranslatedDocument":{
      "Content": blob
    }
}