Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Übersetzung in Echtzeit
Amazon Translate bietet Dokument- und Textübersetzungen in Echtzeit, bei denen die Übersetzungen sofort zurückgegeben werden. Sie können die Konsole oder die API verwenden, um Übersetzungen in Echtzeit durchzuführen.
**Topics**
+ [Übersetzung in Echtzeit mithilfe der Konsole](sync-console.md)
+ [Übersetzung in Echtzeit mithilfe der API](sync-api.md)
# Übersetzung in Echtzeit mithilfe der Konsole
Um die Konsole für Übersetzungen in Echtzeit zu verwenden, fügen Sie den Eingabetext in das Textfeld **Ausgangssprache** ein oder stellen Sie den Eingabetext als Datei bereit. Optional können Sie Funktionen wie die gewünschte Formalitätsstufe, die Maskierung von Schimpfwörtern, die Kürze und benutzerdefinierte Terminologie festlegen.
Sie können die auto Spracherkennung für Übersetzungen in Echtzeit verwenden, es können jedoch Gebühren anfallen. Weitere Informationen finden Sie unter [Automatische Spracherkennung](how-it-works.md#how-to-auto).
**Topics**
+ [Text Translate](#sync-console-text)
+ [Ein Dokument Translate](#sync-console-document)
+ [Entsprechende API-Anfrage- und Antwortdaten anzeigen](#sync-console-output)
+ [Verwenden Sie Übersetzungsfunktionen](#sync-console-features)
## Text Translate
Verwenden Sie die Amazon Translate Translate-Konsole, um bis zu 10.000 Byte Text zu übersetzen.
1. Öffnen Sie die [Amazon Translate Translate-Konsole](https://console.aws.amazon.com/translate/home).
1. Wählen Sie im Navigationsmenü auf der linken Seite die Option **Echtzeit-Übersetzung** aus.
1. Wählen Sie für **Ausgangssprache** die Sprache des Quelltextes aus, oder behalten Sie den Wert für die **auto** Erkennung auf Automatisch.
1. Wählen Sie für **Zielsprache** eine Sprache aus.
1. Geben Sie Text in das Textfeld **Ausgangssprache** ein oder fügen Sie ihn ein. Die Konsole zeigt den übersetzten Text im Textfeld **Zielsprache** an.
![\[Die Übersetzungstextseite der Amazon Translate Translate-Konsole.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/gs-10.png)
## Ein Dokument Translate
Die Übersetzung von Dokumenten in Echtzeit unterstützt Übersetzungen vom Englischen in jede unterstützte Sprache und von jeder unterstützten Sprache ins Englische.
Um ein Dokument mit der Amazon Translate-Konsole zu übersetzen:
1. Öffnen Sie die [Amazon Translate Translate-Konsole](https://console.aws.amazon.com/translate/home).
1. Wählen Sie im Navigationsmenü auf der linken Seite die Option **Echtzeit-Übersetzung** aus.
1. Wählen Sie im Übersetzungsfenster die Registerkarte **Dokumente** aus.
![\[Der Bildschirm „Dokument übersetzen“ der Amazon Translate Translate-Konsole.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/gs-12.png)
1. Wählen Sie für **Ausgangssprache** die Sprache des Quelltextes aus, oder wählen Sie **auto** für die automatische Erkennung.
1. Wählen Sie für **Zielsprache** eine Sprache aus. Wenn die Ausgangssprache nicht Englisch ist, müssen Sie Englisch als Zielsprache auswählen.
1. Wählen **Sie unter Datei hochladen** die **Option Datei auswählen** und geben Sie den Pfad zur Quelldatei ein. Die maximale Dateigröße beträgt 100 KB.
1. Wählen Sie **unter Dokumenttyp** das Format der Übersetzungsquelldatei aus. Die Übersetzung von Dokumenten unterstützt Nur-Text-, HTML- oder Word-Eingabedateien (.docx).
1. Wählen Sie „**Translate**“.
Wählen Sie nach Abschluss der Übersetzungsaufgabe **Übersetzung herunterladen**, um das übersetzte Dokument auf Ihre lokale Festplatte herunterzuladen. Das Format des übersetzten Dokuments (Text, HTML oder Word) entspricht dem Format des Eingabedokuments.
## Entsprechende API-Anfrage- und Antwortdaten anzeigen
Nachdem Sie die Konsole verwendet haben, um den Eingabetext oder das Dokument zu übersetzen, können Sie die entsprechenden API-Anforderungsdaten und Antwortdaten im JSON-Format anzeigen.
1. Erweitern Sie unter dem **Übersetzungsbereich** den Bereich **Anwendungsintegration**.
In der Konsole werden die entsprechenden Übersetzungsanforderungsdaten im JSON-Format angezeigt.
![\[JSON-Codebeispiele für die Textübersetzung.\]](http://docs.aws.amazon.com/de_de/translate/latest/dg/images/gs-20.png)
1. Sie können die **JSON-Anforderung** kopieren, um sie in einer [TranslateText[TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)API-Operation zu verwenden.
1. Die JSON-Ausgabe im **JSON-Antwortbereich** entspricht der Ausgabe, die die API generiert.
## Verwenden Sie Übersetzungsfunktionen
So verwenden Sie Übersetzungsfunktionen mit der Amazon Translate Translate-Konsole:
1. Öffnen Sie die [Amazon Translate Translate-Konsole](https://console.aws.amazon.com/translate/home).
1. Wählen Sie im Navigationsmenü auf der linken Seite die Option **Echtzeit-Übersetzung** aus.
1. Geben Sie die Ausgangssprache, die Zielsprache und die Eingabedaten (Text oder Dokument) an, wie in den vorherigen Verfahren beschrieben.
1. Unter **Zusätzliche Einstellungen** können Sie wählen, ob Sie die Ausgabe Ihres Übersetzungsauftrags mit den folgenden Einstellungen anpassen möchten:
**Benutzerdefinierte Terminologie**
Wählen Sie eine benutzerdefinierte Terminologiedatei aus. Wenn die Datei einen Eintrag für einen Quellbegriff im Eingabetext enthält, verwendet Amazon Translate die Übersetzung aus der Terminologiedatei.
Weitere Informationen finden Sie unter [Anpassung Ihrer Übersetzungen mit benutzerdefinierter Terminologie](how-custom-terminology.md).
**Kürze**
Reduziert die Länge der Übersetzungsausgabe für die meisten Übersetzungen (im Vergleich zur Übersetzungsausgabe ohne Kürze). Amazon Translate unterstützt Kürze bei der Übersetzung von Text, nicht jedoch bei der Übersetzung eines Dokuments. Amazon Translate ignoriert die Einstellung für die Kürze, wenn die Ausgangs- und Zielsprache der Kürze halber ein nicht unterstütztes Sprachpaar bilden.
Informationen zu den unterstützten Sprachen finden Sie unter. [Verwendung von Brevity in Amazon Translate](customizing-translations-brevity.md)
**Obszönität**
Maskiert profane Wörter und Phrasen in Ihrer Übersetzungsausgabe. Amazon Translate unterstützt die Maskierung von Schimpfwörtern nicht in allen unterstützten Sprachen.
Weitere Informationen finden Sie unter [Maskieren profaner Wörter und Phrasen in Amazon Translate](customizing-translations-profanity.md).
**Formalität**
Für einige Zielsprachen können Sie **Formalität auf formell** oder informell setzen. Amazon Translate ignoriert die Formalitätseinstellung, wenn Formalität die Zielsprache nicht unterstützt.
Weitere Informationen finden Sie unter [Einstellung der Formalität in Amazon Translate](customizing-translations-formality.md).
1. Wählen Sie für die Übersetzung von Dokumenten die Option **Translate**, um das Dokument mit den ausgewählten Funktionen zu übersetzen.
Bei der Textübersetzung wendet die Konsole die Übersetzungsfunktion auf den übersetzten Text an, wenn Sie die einzelnen Funktionen auswählen.
# Übersetzung in Echtzeit mithilfe der API
Amazon Translate bietet die folgenden Echtzeit-Übersetzungsvorgänge zur Unterstützung interaktiver Anwendungen:
+ [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)— übersetzt einen Textblock.
+ [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)— ü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](how-it-works.md#how-to-auto).
## Text Translate
Verwenden Sie die [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)Operation, um einen einzelnen Textblock zu übersetzen.
### Translate Sie Text über die Befehlszeile
Das folgende Beispiel zeigt, wie der [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)Vorgang von der Befehlszeile aus verwendet wird. Das Beispiel ist für Unix, Linux und macOS formatiert. Ersetzen Sie unter Windows den umgekehrten Schrägstrich (\$1), 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:
```
{
"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 (\$1), 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"
}
```
1. Führen Sie in der den AWS CLI 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 [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)Vorgang, 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 [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)Vorgang von der Befehlszeile aus verwendet wird. Das Beispiel ist für Unix, Linux und macOS formatiert. Ersetzen Sie unter Windows den umgekehrten Schrägstrich (\$1), 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:
```
{
"SourceLanguageCode": "en",
"TargetLanguageCode": "es",
"TranslatedDocument":{
"Content": blob
}
}
```