/ - Amazon Translate

Translates input text from the source language to the target language. For a list of available languages and language codes, see what-is-languages.

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

Text

string

required

The text to translate. The text string can be a maximum of 5,000 bytes long. Depending on your character set, this may be fewer than 5,000 characters.

>= 1 characters<= 5000 characters

Match pattern:

[\P{M}\p{M}]{1,5000}

TerminologyNames

array[string]

optional

The name of the terminology list file to be used in the TranslateText request. You can use 1 terminology list at most in a TranslateText request. Terminology lists can contain a maximum of 256 terms.

SourceLanguageCode

string

required

The language code for the language of the source text. The language must be a language supported by Amazon Translate. For a list of language codes, see what-is-languages.

To have Amazon Translate determine the source language of your text, you can specify auto in the SourceLanguageCode field. If you specify auto, Amazon Translate will call Amazon Comprehend to determine the source language.

>= 2 characters<= 5 characters

TargetLanguageCode

string

required

The language code requested for the language of the target text. The language must be a language supported by Amazon Translate.

>= 2 characters<= 5 characters

Examples

Responses

🟢200Success

application/json

Body

TranslatedText

string

required

The translated text.

<= 10000 characters

Match pattern:

[\P{M}\p{M}]{0,10000}

SourceLanguageCode

string

required

The language code for the language of the source text.

>= 2 characters<= 5 characters

TargetLanguageCode

string

required

The language code for the language of the target text.

>= 2 characters<= 5 characters

AppliedTerminologies

array[object (AppliedTerminology) {2}]

optional

The names of the custom terminologies applied to the input text by Amazon Translate for the translated text response.

Name

string

optional

The name of the custom terminology applied to the input text by Amazon Translate for the translated text response.

>= 1 characters<= 256 characters

Match pattern:

^([A-Za-z0-9-]_?)+$

Terms

array[object (Term) {2}]

optional

The specific terms of the custom terminology applied to the input text by Amazon Translate for the translated text response. A maximum of 250 terms will be returned, and the specific terms applied will be the first 250 terms in the source text.

🟠480InvalidRequestException

🟠481TextSizeLimitExceededException

🟠482TooManyRequestsException

🟠483UnsupportedLanguagePairException

🟠484DetectedLanguageLowConfidenceException

🟠485ResourceNotFoundException

🟠486InternalServerException

🟠487ServiceUnavailableException