Translates input text from the source language to the target language. For a list of available languages and language codes, see Supported languages.
See https://www.paws-r-sdk.com/docs/translate_translate_text/ for full documentation.
translate_translate_text(
Text,
TerminologyNames = NULL,
SourceLanguageCode,
TargetLanguageCode,
Settings = NULL
)
[required] The text to translate. The text string can be a maximum of 10,000 bytes long. Depending on your character set, this may be fewer than 10,000 characters.
The name of a terminology list file to add to the translation job. This file provides source terms and the desired translation for each term. A terminology list can contain a maximum of 256 terms. You can use one custom terminology resource in your translation request.
Use the list_terminologies
operation
to get the available terminology lists.
For more information about custom terminology lists, see Custom terminology.
[required] The language code for the language of the source text. For a list of language codes, see Supported 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.
If you specify auto
, you must send the
translate_text
request in a region that
supports Amazon Comprehend. Otherwise, the request returns an error
indicating that autodetect is not supported.
[required] The language code requested for the language of the target text. For a list of language codes, see Supported languages.
Settings to configure your translation output. You can configure the following options:
Brevity: reduces the length of the translated output for most translations.
Formality: sets the formality level of the output text.
Profanity: masks profane words and phrases in your translation output.