Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Traducción en tiempo real mediante la API
Amazon Translate ofrece las siguientes operaciones de traducción en tiempo real para las aplicaciones interactivas:
+ [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)— traduce un bloque de texto.
+ [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)— traduce el contenido de un archivo (texto plano, HTML o .docx).
Estas operaciones síncronas devuelven el resultado de la traducción directamente a la aplicación. Si utiliza la detección automática de idioma con estas operaciones, es posible que se le cobre. Para obtener más información, consulte [Detección automática del idioma](how-it-works.md#how-to-auto).
## Traducir texto
Utilice la [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operación para traducir un único bloque de texto.
### Traducción de texto con la línea de comandos
El siguiente ejemplo muestra cómo utilizar la [TranslateText](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateText.html)operación desde la línea de comandos. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).
En la línea de comandos, escriba el comando siguiente:
```
aws translate translate-text \
--region region \
--source-language-code "en" \
--target-language-code "es" \
--text "hello, world"
```
El comando responde con el siguiente JSON:
```
{
"TargetLanguageCode": "es",
"TranslatedText": "Hola, mundo",
"SourceLanguageCode": "en"
}
```
### Traducción de texto con un archivo JSON
Este ejemplo muestra cómo utilizar un archivo JSON para traducir un bloque de texto más largo. Puede especificar el idioma de origen y de destino en la línea de comandos o especificarlos en el archivo JSON.
**nota**
El archivo JSON está preparado para facilitar su lectura. Vuelva a preparar el campo `"Text"` para eliminar los saltos de línea.
El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).
**Para traducir texto con un archivo JSON**
1. Copie el siguiente texto en un archivo JSON denominado `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. En AWS CLI, ejecute el siguiente comando:
```
aws translate translate-text \
--region region \
--cli-input-json file://translate.json > translated.json
```
El comando devuelve un archivo JSON que contiene el siguiente texto 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"
}
```
## Traducir un documento
Utilice la [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operación para traducir un documento de texto, HTML o Word (.docx) y devuelva el resultado de la traducción directamente a la aplicación.
La traducción de documentos en tiempo real admite traducciones del inglés a cualquier idioma admmitido y de cualquier idioma admitido al inglés. Puede especificar el código del idioma de origen o usar la detección automática.
### Traducción de documentos con la línea de comandos
En el siguiente ejemplo, se muestra cómo utilizar la [TranslateDocument](https://docs.aws.amazon.com/translate/latest/APIReference/API_TranslateDocument.html)operación desde la línea de comandos. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\$1) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).
En la línea de comandos, escriba el comando siguiente:
```
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
```
El comando responde con el siguiente JSON:
```
{
"SourceLanguageCode": "en",
"TargetLanguageCode": "es",
"TranslatedDocument":{
"Content": blob
}
}
```