使用 API 進行即時翻譯

Amazon Translate 提供下列即時翻譯操作來支援互動式應用程式：

• TranslateText— 翻譯文字區塊。

• TranslateDocument— 翻譯檔案的內容 (純文字、HTML 或 .docx)。

這些同步作業會將翻譯結果直接傳回至您的應用程式。如果您在這些操作中使用 auto 語言偵測，可能會產生費用。如需詳細資訊，請參閱自動語言檢測。

Translate 文字

使用此TranslateText作業翻譯單一文字區塊。

使用指令行 Translate 文字

下面的例子演示了如何從命令行使用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 檔案 Translate 文字

此範例顯示如何使用 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"
   }
   

Translate 文件

使用此TranslateDocument作業翻譯文字、HTML 或 Word (.docx) 文件，並將翻譯結果直接傳回至您的應用程式。

即時文件翻譯支援從英文翻譯成任何支援的語言，以及從任何支援的語言翻譯成英文。您可以指定源語言代碼或使用 auto 檢測。

使用命令列 Translate 文件

下面的例子演示了如何從命令行使用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
    }
}