Übersetzung in Echtzeit mithilfe der API

Amazon Translate bietet die folgenden Echtzeit-Übersetzungsvorgänge zur Unterstützung interaktiver Anwendungen:

• TranslateText— übersetzt einen Textblock.

• TranslateDocument— übersetzt den Inhalt einer Datei (Klartext, HTML oder .docx).

Diese synchronen Operationen geben das Übersetzungsergebnis direkt an Ihre Anwendung zurück. Wenn Sie bei diesen Vorgängen die auto Spracherkennung verwenden, kann eine Gebühr anfallen. Weitere Informationen finden Sie unter Automatische Spracherkennung.

Text Translate

Verwenden Sie die TranslateTextOperation, um einen einzelnen Textblock zu übersetzen.

Translate Sie Text über die Befehlszeile

Das folgende Beispiel zeigt, wie der TranslateTextVorgang von der Befehlszeile aus verwendet wird. Das Beispiel ist für Unix, Linux und macOS formatiert. Ersetzen Sie unter Windows den umgekehrten Schrägstrich (\), das Unix-Fortsetzungszeichen, am Ende jeder Zeile durch ein Caret-Zeichen oder Zirkumflex (^).

Geben Sie in der Befehlszeile den folgenden Befehl ein:

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

Der Befehl antwortet mit dem folgenden JSON-Code:

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

Text mithilfe einer JSON-Datei Translate

Dieses Beispiel zeigt, wie eine JSON-Datei verwendet wird, um einen längeren Textblock zu übersetzen. Sie können die Quell- und Zielsprache in der Befehlszeile oder in der JSON-Datei angeben.

Anmerkung

Die JSON-Beispieldatei ist aus Gründen der Lesbarkeit formatiert. Entfernen Sie die Zeilenumbrüche aus dem Feld "Text".

Das Beispiel ist für Unix, Linux und macOS formatiert. Ersetzen Sie unter Windows den umgekehrten Schrägstrich (\), das Unix-Fortsetzungszeichen, am Ende jeder Zeile durch ein Caret-Zeichen oder Zirkumflex (^).

So übersetzen Sie Text unter Verwendung einer JSON-Datei

1. Kopieren Sie den folgenden Text in eine JSON-Datei mit dem Namen 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. Führen Sie in der AWS CLI den folgenden Befehl aus:

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

   Der Befehl gibt eine JSON-Datei mit dem folgenden Text im JSON-Format aus:

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

Dokument Translate

Verwenden Sie diesen TranslateDocumentVorgang, um ein Text-, HTML- oder Word-Dokument (.docx) zu übersetzen und das Übersetzungsergebnis direkt an Ihre Anwendung zurückzugeben.

Die Übersetzung von Dokumenten in Echtzeit unterstützt Übersetzungen vom Englischen in jede unterstützte Sprache und von jeder unterstützten Sprache ins Englische. Sie können den Quellsprachencode angeben oder die auto Erkennung verwenden.

Dokument über die Befehlszeile Translate

Das folgende Beispiel zeigt, wie der TranslateDocumentVorgang von der Befehlszeile aus verwendet wird. Das Beispiel ist für Unix, Linux und macOS formatiert. Ersetzen Sie unter Windows den umgekehrten Schrägstrich (\), das Unix-Fortsetzungszeichen, am Ende jeder Zeile durch ein Caret-Zeichen oder Zirkumflex (^).

Geben Sie in der Befehlszeile den folgenden Befehl ein:

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

Der Befehl antwortet mit dem folgenden JSON-Code:

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