Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Traduction en temps réel à l'aide de l'API
Amazon Translate fournit les opérations de traduction en temps réel suivantes pour prendre en charge les applications interactives :
+ [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)— traduit un bloc de texte.
+ [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)— traduit le contenu d'un fichier (texte brut, HTML ou .docx).
Ces opérations synchrones renvoient le résultat de la traduction directement à votre application. Si vous utilisez la détection automatique de la langue lors de ces opérations, des frais peuvent vous être facturés. Pour de plus amples informations, veuillez consulter [Détection automatique de la langue](how-it-works.md#how-to-auto).
## Translate text
Utilisez cette [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)opération pour traduire un seul bloc de texte.
### Translate du texte à l'aide de la ligne de commande
L'exemple suivant montre comment utiliser l'[TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)opération depuis la ligne de commande. L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\$1), à la fin de chaque ligne par un accent circonflexe (^).
En ligne de commande, entrez la commande suivante.
```
aws translate translate-text \
--region region \
--source-language-code "en" \
--target-language-code "es" \
--text "hello, world"
```
La commande répond avec le code JSON suivant :
```
{
"TargetLanguageCode": "es",
"TranslatedText": "Hola, mundo",
"SourceLanguageCode": "en"
}
```
### Translate du texte à l'aide d'un fichier JSON
Cet exemple montre comment utiliser un fichier JSON pour traduire un bloc de texte plus long. Vous pouvez spécifier les langues source et cible sur la ligne de commande ou dans le fichier JSON.
**Note**
Le fichier JSON d'exemple est formaté dans un souci de lisibilité. Reformatez le champ `"Text"` pour supprimer les sauts de ligne.
L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\$1), à la fin de chaque ligne par un accent circonflexe (^).
**Pour traduire un texte à l'aide d'un fichier JSON**
1. Copiez le texte suivant dans un fichier JSON appelé `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. Dans le AWS CLI, exécutez la commande suivante :
```
aws translate translate-text \
--region region \
--cli-input-json file://translate.json > translated.json
```
La commande produit un fichier JSON qui contient le texte JSON suivant :
```
{
"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 document
Utilisez cette [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)opération pour traduire un document texte, HTML ou Word (.docx) et renvoyer le résultat de la traduction directement à votre application.
La traduction de documents en temps réel prend en charge les traductions de l'anglais vers n'importe quelle langue prise en charge, et de n'importe quelle langue prise en charge vers l'anglais. Vous pouvez spécifier le code de langue source ou utiliser la détection automatique.
### Translate le document à l'aide de la ligne de commande
L'exemple suivant montre comment utiliser l'[TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)opération depuis la ligne de commande. L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\$1), à la fin de chaque ligne par un accent circonflexe (^).
En ligne de commande, entrez la commande suivante.
```
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
```
La commande répond avec le code JSON suivant :
```
{
"SourceLanguageCode": "en",
"TargetLanguageCode": "es",
"TranslatedDocument":{
"Content": blob
}
}
```