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— traduce un bloque de texto.

• TranslateDocument— 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 más información, consulte Detección automática del idioma.

Traducir texto

Utilice la TranslateTextoperació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 TranslateTextoperación desde la línea de comandos. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\) 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 (\) 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"
   }

2. En la 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 TranslateDocumentoperació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

El siguiente ejemplo muestra cómo utilizar la TranslateDocumentoperación desde la línea de comandos. El ejemplo está formateado para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\) 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
    }
}