Tradução em tempo real usando a API

O Amazon Translate fornece as seguintes operações de tradução em tempo real para apoiar aplicativos interativos:

• TranslateText— traduz um bloco de texto.

• TranslateDocument— traduz o conteúdo de um arquivo (texto simples, HTML ou .docx).

Essas operações síncronas retornam o resultado da tradução diretamente para seu aplicativo. Se você usar a detecção automática de idioma com essas operações, poderá incorrer em uma cobrança. Para obter mais informações, consulte Detecção automática de idioma.

Traduzir texto

Use a TranslateTextoperação para traduzir um único bloco de texto.

Traduzir textos usando a linha de comando

O exemplo a seguir mostra como usar a TranslateTextoperação na linha de comando. O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\) no final de cada linha por um circunflexo (^).

Na linha de comando, insira o seguinte comando:

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

O comando responde com o seguinte JSON:

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

Traduzir textos usando um arquivo JSON

Este exemplo mostra como usar o arquivo JSON para traduzir um bloco de texto maior. Você pode especificar os idiomas de origem e de destino na linha de comando ou especifique-os no arquivo JSON.

nota

O arquivo JSON é formatado visando a capacidade de leitura. Reformate o campo "Text" para remover as quebras de linha.

O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\) no final de cada linha por um circunflexo (^).

Para traduzir o texto usando um arquivo JSON

1. Copie o seguinte texto em um arquivo JSON chamado 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. Na AWS CLI, execute o seguinte comando:

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

   O comando resulta em um arquivo JSON que contém o seguinte texto de 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"
   }
   

Traduzir documento

Use a TranslateDocumentoperação para traduzir um documento de texto, HTML ou Word (.docx) e retornar o resultado da tradução diretamente para seu aplicativo.

A tradução de documentos em tempo real suporta traduções do inglês para qualquer idioma suportado e de qualquer idioma suportado para o Inglês. Você pode especificar o código do idioma fonte ou usar a detecção automática.

Traduzir documento usando a linha de comando

O exemplo a seguir mostra como usar a TranslateDocumentoperação na linha de comando. O exemplo é formatado para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\) no final de cada linha por um circunflexo (^).

Na linha de comando, insira o seguinte comando:

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

O comando responde com o seguinte JSON:

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