API を使用したリアルタイム翻訳

Amazon Translate では、インタラクティブなアプリケーションをサポートするために、以下のリアルタイム翻訳オペレーションを提供しています。

• TranslateText— テキストブロックを翻訳します。

• TranslateDocument— ファイルの内容 (プレーンテキスト、HTML、または.docx) を翻訳します。

これらの同期オペレーションは、翻訳結果をアプリケーションに直接返します。これらのオペレーションで言語の自動検出を使用すると、料金が発生する場合があります。詳細については、「言語の自動検出」を参照してください。

テキストの翻訳

TranslateTextオペレーションを使用して 1 つのテキストブロックを翻訳します。

コマンドラインを使用したテキストの翻訳

次の例は、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
    }
}