API를 사용한 실시간 번역

Amazon Translate는 대화형 애플리케이션을 지원하기 위해 다음과 같은 실시간 번역 작업을 제공합니다.

• TranslateText— 텍스트 블록을 번역합니다.

• TranslateDocument— 파일 내용 (일반 텍스트, HTML 또는.docx) 을 번역합니다.

이러한 동기식 작업은 번역 결과를 애플리케이션에 직접 반환합니다. 이러한 작업에 언어 자동 감지 기능을 사용하는 경우 요금이 부과될 수 있습니다. 자세히 알아보려면 언어 자동 감지의 내용을 참조하세요.

텍스트 번역

TranslateText작업을 사용하여 단일 텍스트 블록을 번역할 수 있습니다.

명령줄을 사용하여 텍스트 번역

다음 예제는 명령줄에서 TranslateText작업을 사용하는 방법을 보여줍니다. 다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

명령줄에 다음 명령을 입력합니다.

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

명령은 다음 JSON으로 응답합니다.

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

JSON 파일을 사용하여 텍스트 번역

이 예제는 JSON 파일을 사용하여 긴 텍스트 블록을 번역하는 방법을 보여 줍니다. 명령줄에 소스 언어와 대상 언어를 지정할 수도 있고, JSON 파일에 지정할 수도 있습니다.

참고

JSON 파일은 쉽게 읽을 수 있도록 서식이 지정됩니다. 줄바꿈을 제거하려면 "Text" 필드의 포맷을 변경합니다.

다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

JSON 파일을 사용하여 텍스트를 번역하려면

1. 다음 텍스트를 translate.json이라는 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. AWS CLI에서 다음 명령을 실행합니다.

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

   이 명령은 다음 JSON 텍스트를 포함하는 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"
   }
   

문서 번역

이 TranslateDocument작업을 사용하여 텍스트, HTML 또는 Word (.docx) 문서를 번역하고 번역 결과를 애플리케이션에 직접 반환합니다.

실시간 문서 번역은 영어에서 지원되는 모든 언어로, 지원되는 모든 언어에서 영어로의 번역을 지원합니다. 소스 언어 코드를 지정하거나 자동 감지를 사용할 수 있습니다.

명령줄을 사용하여 문서 번역

다음 예제는 명령줄에서 TranslateDocument작업을 사용하는 방법을 보여줍니다. 다음은 Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

명령줄에 다음 명령을 입력합니다.

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

명령은 다음 JSON으로 응답합니다.

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