translate-document
Описание
Переводит входной документ с исходного языка на целевой язык. Это синхронная операция поддерживает текстовые, HTML или документы Word в качестве входного документа. TranslateDocument поддерживает переводы с английского на любой поддерживаемый язык и с любого поддерживаемого языка на английский. Поэтому укажите либо код исходного языка, либо код целевого языка как «en» (английский).
Если вы зададите параметр Formality, запрос завершится ошибкой, если целевой язык не поддерживает формальность. Список целевых языков, поддерживающих формальность, см. в разделе Установка формальности.
См. также: Документация API AWS
Синтаксис
translate-document
--document <value>
[--terminology-names <value>]
--source-language-code <value>
--target-language-code <value>
[--settings <value>]
--document-content <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--document (структура)
Содержание и тип содержимого документа, подлежащего переводу. Размер документа не должен превышать 100 КБ.
ContentType -> (строка)
Описывает формат документа. Вы можете указать один из следующих:
-
text/html- Входные данные содержат HTML-содержимое. Amazon Translate переводит только текст в HTML-элементе. -
text/plain- Входные данные содержат неформатированный текст. Amazon Translate переводит каждый символ в содержимом. -
application/vnd.openxmlformats-officedocument.wordprocessingml.document- Входные данные содержат документ Word (.docx).
Краткая синтаксическая запись:
ContentType=string
Синтаксис JSON:
{
"ContentType": "string"
}
--terminology-names (список)
Имя файла списка терминологий, который нужно добавить к задаче перевода. Этот файл предоставляет исходные термины и желаемый перевод для каждого термина. Список терминологий может содержать не более 256 терминов. В запросе перевода можно использовать один пользовательский ресурс терминологии.
Используйте операцию ListTerminologies, чтобы получить доступные списки терминологий.
Дополнительную информацию о пользовательских списках терминологий см. в разделе Пользовательская терминология.
(строка)
Синтаксис:
"string" "string" ...
--source-language-code (строка)
Код языка исходного текста. Список поддерживаемых кодов языков см. в разделе Поддерживаемые языки.
Чтобы Amazon Translate определял исходный язык вашего текста, вы можете указать auto в поле SourceLanguageCode. Если вы укажете auto, Amazon Translate вызовет Amazon Comprehend для определения исходного языка.
Примечание
Если вы укажетеauto, вы должны отправить запрос TranslateDocument в той области, которая поддерживает Amazon Comprehend. В противном случае запрос вернёт ошибку, указывающую, что автоматическое определение не поддерживается.--target-language-code (строка)
--settings (структура)
Настройки для конфигурации выходных данных перевода. Вы можете настроить следующие параметры:
- Краткий перевод: не поддерживается.
- Формальность: задаёт уровень формальности выходного текста.
- Маскирование ненормативной лексики: маскирует ненормативную лексику в выходном переводе.
Формальность -> (строка)
Вы можете указать желаемый уровень формальности для переводов на поддерживаемые целевые языки. Настройка формальности контролирует уровень использования формального языка (также известного как регистр) в выходном переводе. Вы можете установить значение «неформальный» или «формальный». Если вы не укажете значение для формальности или если целевой язык не поддерживает формальность, перевод проигнорирует настройку формальности.
Если вы указываете несколько целевых языков для задачи, перевод проигнорирует настройку формальности для любого неподдерживаемого целевого языка.
Список целевых языков, поддерживающих формальность, см. в разделе Поддерживаемые языки в руководстве разработчика Amazon Translate.
Маскирование ненормативной лексики -> (строка)
Вы можете включить настройку маскирования ненормативной лексики, если хотите маскировать ненормативную лексику в выходном переводе.
Для маскирования ненормативной лексики Amazon Translate заменяет её на последовательность символов «?$#@$». Эта 5-символьная последовательность используется для каждого ненормативного слова или выражения, независимо от длины или количества слов.
Amazon Translate не обнаруживает ненормативную лексику на всех поддерживаемых языках. Языки, не поддерживающие обнаружение ненормативной лексики, см. в разделе Неподдерживаемые языки в руководстве разработчика Amazon Translate.
Если вы указываете несколько целевых языков для задачи, все целевые языки должны поддерживать маскирование ненормативной лексики. Если какой-либо из целевых языков не поддерживает маскирование ненормативной лексики, задача перевода не будет маскировать ненормативную лексику для никакого целевого языка.
Краткий перевод -> (строка)
При включении краткого перевода Amazon Translate сокращает длину выходного перевода для большинства переводов (по сравнению с тем же переводом без включённого краткого перевода). По умолчанию краткий перевод выключен.
Если вы включите краткий перевод для запроса перевода с неподдерживаемой языковой парой, перевод выполнится с выключенным кратким переводом.
Поддерживаемые языковые пары для краткого перевода см. в руководстве разработчика Amazon Translate.
Краткая синтаксическая запись:
Formality=string,Profanity=string,Brevity=string
Синтаксис JSON:
{
"Formality": "FORMAL"|"INFORMAL",
"Profanity": "MASK",
"Brevity": "ON"
}
--document-content (блок данных)
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который может быть использован в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который может быть использован с --cli-input-yaml. Если указано со значением output, он валидирует входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладочную запись.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования выходных данных команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Область для использования. Переопределяет настройки конфигурации/окружения.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- вкл
- выкл
- авто
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/окружения.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, который будет использоваться для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров входных данных CLI.
Вывод
TranslatedDocument -> (структура)
Документ, содержащий переведенный контент. Формат документа соответствует формату исходного документа.
Content -> (blob)
SourceLanguageCode -> (строка)
TargetLanguageCode -> (строка)
AppliedTerminologies -> (список)
Названия настраиваемых терминологий, примененных Amazon Translate к входному тексту для получения переведенного документа.
(структура)
Настраиваемая терминология, примененная Amazon Translate к входному тексту для получения ответа с переведенным текстом. Это необязательно в ответе и будет присутствовать только в том случае, если вы указали терминологию в запросе. В настоящее время для каждого запроса TranslateText может быть применена только одна терминология.
Name -> (строка)
Terms -> (список)
Конкретные термины настраиваемой терминологии, примененной Amazon Translate к входному тексту для получения ответа с переведенным текстом. Максимальное количество возвращаемых терминов — 250, а конкретные применяемые термины — первые 250 терминов в исходном тексте.
(структура)
Термин, переводимый с помощью настраиваемой терминологии.
SourceText -> (строка)
TargetText -> (строка)
AppliedSettings -> (структура)
Настройки для конфигурации выходных данных перевода. Вы можете настроить следующие параметры:
- Краткий перевод: сокращает длину выходных данных перевода для большинства переводов. Доступно только для
TranslateText. - Формальность: устанавливает уровень формальности выходных данных перевода.
- Маскировка ненормативной лексики: маскирует ненормативную лексику и выражения в выходных данных перевода.
Formality -> (строка)
Вы можете указать желаемый уровень формальности переводов для поддерживаемых целевых языков. Настройка формальности контролирует уровень использования формального языка (также известного как регистр) в выходных данных перевода. Вы можете установить значение на неофициальное или официальное. Если вы не укажете значение для формальности или если целевой язык не поддерживает формальность, перевод проигнорирует настройку формальности.
Если вы указываете несколько целевых языков для задания, перевод игнорирует настройку формальности для любых неподерживаемых целевых языков.
Список целевых языков, поддерживающих формальность, см. в руководстве разработчика Amazon Translate.
Profanity -> (строка)
Вы можете включить настройку маскировки ненормативной лексики, если хотите маскировать ненормативную лексику и выражения в выходных данных перевода.
Для маскировки ненормативной лексики Amazon Translate заменяет её на строку grawlix «?$#@$». Эта 5-символьная последовательность используется для каждого оскорбительного слова или выражения, независимо от длины или количества слов.
Amazon Translate не определяет ненормативную лексику на всех поддерживаемых языках. Для языков, которые не поддерживают обнаружение ненормативной лексики, см. список недоступных языков в руководстве разработчика Amazon Translate.
Если вы указываете несколько целевых языков для задания, все целевые языки должны поддерживать маскировку ненормативной лексики. Если любой из целевых языков не поддерживает маскировку ненормативной лексики, работа перевода не будет маскировать ненормативную лексику для любого целевого языка.
Brevity -> (строка)
При включении краткого перевода Amazon Translate сокращает длину выходных данных перевода для большинства переводов (по сравнению с тем же переводом при выключенном кратком переводе). По умолчанию краткий перевод выключен.
Если вы включите краткий перевод для запроса перевода с неподерживаемой языковой парой, перевод выполняется с выключенной настройкой краткого перевода.
Список языковых пар, поддерживающих краткий перевод, см. в руководстве разработчика Amazon Translate.
© Copyright 2025, Amazon Web Services. Created using Sphinx.