使用 API 进行实时翻译

Amazon Translate 提供以下实时翻译操作来支持交互式应用程序：

• TranslateText— 翻译一段文本。

• TranslateDocument— 翻译文件的内容（纯文本、HTML 或.docx）。

这些同步操作会直接将翻译结果返回到您的应用程序。如果您在这些操作中使用自动语言检测，则可能会产生费用。有关更多信息，请参阅自动语言检测：

翻译文本

使用该TranslateText操作翻译单个文本块。

使用命令行翻译文本

以下示例说明如何通过命令行使用该TranslateText操作。此示例的格式适用于 Unix、Linux 和 macOS。对于 Windows，请将每行末尾的反斜杠 (\) Unix 行继续符替换为脱字号 (^)。

在命令行输入以下命令。

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

命令使用以下 JSON 进行响应：

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

使用 JSON 文件翻译文本

此示例演示如何使用 JSON 文件翻译更长的文本块。您可以在命令行上指定源语言和目标语言，或在 JSON 文件中指定。

注意

示例 JSON 文件已设置为便于阅读的格式。重新设置 "Text" 字段的格式以删除换行符。

此示例的格式适用于 Unix、Linux 和 macOS。对于 Windows，请将每行末尾的反斜杠 (\) Unix 行继续符替换为脱字号 (^)。

使用 JSON 文件翻译文本

1. 将以下文本复制到名为 translate.json 的 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. 在 AWS CLI 中运行以下命令：

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

   此命令将输出包含以下 JSON 文本的 JSON 文件：

   {
       "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"
   }
   

翻译文档

使用该TranslateDocument操作翻译文本、HTML 或 Word (.docx) 文档，并将翻译结果直接返回到您的应用程序。

实时文档翻译支持从英语翻译成任何支持的语言，以及从任何支持的语言翻译成英语。您可以指定源语言代码或使用自动检测。

使用命令行翻译文档

以下示例说明如何通过命令行使用该TranslateDocument操作。此示例的格式适用于 Unix、Linux 和 macOS。对于 Windows，请将每行末尾的反斜杠 (\) Unix 行继续符替换为脱字号 (^)。

在命令行输入以下命令。

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

命令使用以下 JSON 进行响应：

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