Translate Text
translate_translate_text | R Documentation |
Translates input text from the source language to the target language¶
Description¶
Translates input text from the source language to the target language. For a list of available languages and language codes, see Supported languages.
Usage¶
Arguments¶
Text
[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.
TerminologyNames
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.
SourceLanguageCode
[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 theSourceLanguageCode
field. If you specifyauto
, Amazon Translate will call Amazon Comprehend to determine the source language.If you specify
auto
, you must send thetranslate_text
request in a region that supports Amazon Comprehend. Otherwise, the request returns an error indicating that autodetect is not supported.TargetLanguageCode
[required] The language code requested for the language of the target text. For a list of language codes, see Supported languages.
Settings
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.
Value¶
A list with the following syntax:
list(
TranslatedText = "string",
SourceLanguageCode = "string",
TargetLanguageCode = "string",
AppliedTerminologies = list(
list(
Name = "string",
Terms = list(
list(
SourceText = "string",
TargetText = "string"
)
)
)
),
AppliedSettings = list(
Formality = "FORMAL"|"INFORMAL",
Profanity = "MASK",
Brevity = "ON"
)
)