перевод текста

Описание

Переводит текст из исходного языка на целевой язык. Список доступных языков и кодов языков см. в разделе Поддерживаемые языки.

См. также: Документация API AWS

Синтаксис

  translate-text
--text <value>
[--terminology-names <value>]
--source-language-code <value>
--target-language-code <value>
[--settings <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]

Параметры

--text (строка)

Текст для перевода. Длина строки текста может составлять максимум 10 000 байт. В зависимости от кодировки символов, это может быть меньше 10 000 символов.

--terminology-names (список)

Имя файла списка терминологии, который нужно добавить к задаче перевода. Этот файл предоставляет исходные термины и желаемый перевод для каждого термина. Список терминологии может содержать максимум 256 терминов. Вы можете использовать один пользовательский ресурс терминологии в запросе перевода.

Используйте операцию ListTerminologies для получения доступных списков терминологии.

Дополнительную информацию о пользовательских списках терминологии см. в разделе Пользовательская терминология.

(строка)

Синтаксис:

"string" "string" ...

--source-language-code (строка)

Код языка исходного текста. Список кодов языков см. в разделе Поддерживаемые языки.

Чтобы Amazon Translate определил исходный язык вашего текста, вы можете указать auto в поле SourceLanguageCode. Если вы укажете auto, Amazon Translate обратится к Amazon Comprehend для определения исходного языка.

Примечание

Если вы укажете auto, вы должны отправить запрос TranslateText в регионе, поддерживающем 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"
}

--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, 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.

Вывод

TranslatedText -> (строка)

Переведённый текст.

SourceLanguageCode -> (строка)

Код языка исходного текста.

TargetLanguageCode -> (строка)

Код языка целевого текста.

AppliedTerminologies -> (список)

Названия пользовательских терминологий, применённых Amazon Translate к входному тексту для ответа с переведённым текстом.

(структура)

Пользовательская терминология, применённая Amazon Translate к входному тексту для ответа с переведённым текстом. Это необязательный элемент ответа и будет присутствовать только в том случае, если вы указали терминологию в запросе. В настоящее время только одна терминология может быть применена в одном запросе TranslateText.

Name -> (строка)

Название пользовательской терминологии, применённой Amazon Translate к входному тексту для ответа с переведённым текстом.

Terms -> (список)

Конкретные термины пользовательской терминологии, применённой Amazon Translate к входному тексту для ответа с переведённым текстом. Максимально 250 терминов, и будут возвращены первые 250 терминов из исходного текста.

(структура)

Термин, переводимый с помощью пользовательской терминологии.

SourceText -> (строка)

Исходный текст термина, переводимого с помощью пользовательской терминологии.

TargetText -> (строка)

Целевой текст термина, переводимого с помощью пользовательской терминологии.

AppliedSettings -> (структура)

Необязательные параметры, которые изменяют вывод перевода.

Formality -> (строка)

Можно указать желаемый уровень официальности для переводов на поддерживаемые целевые языки. Параметр официальности контролирует уровень формального языка (также известный как регистр) в выводе перевода. Можно установить значение на неофициальное или официальное. Если вы не указываете значение для официальности или целевой язык его не поддерживает, перевод проигнорирует параметр официальности.

Если вы указываете несколько целевых языков для задания, перевод игнорирует параметр официальности для любого языка, который его не поддерживает.

Список языков, поддерживающих параметр официальности, см. в руководстве разработчика Amazon Translate.

Profanity -> (строка)

Можно включить параметр ненормативной лексики, если нужно замаскировать непристойные слова и фразы в выводе перевода.

Для маскировки непристойных слов и фраз Amazon Translate заменяет их строкой гравликса «?$#@$». Эта последовательность из 5 символов используется для каждого непристойного слова или фразы, независимо от длины или количества слов.

Amazon Translate не обнаруживает ненормативную лексику во всех поддерживаемых языках. Языки, не поддерживающие обнаружение ненормативной лексики, см. в руководстве разработчика Amazon Translate.

Если вы указываете несколько целевых языков для задания, все целевые языки должны поддерживать маскировку ненормативной лексики. Если какой-либо из целевых языков не поддерживает маскировку ненормативной лексики, перевод не будет маскировать ненормативную лексику для любого целевого языка.

Brevity -> (строка)

При включении brevity, Amazon Translate сокращает длину вывода перевода для большинства переводов (по сравнению с тем же переводом с выключенной brevity). По умолчанию brevity выключен.

Если вы включите brevity для запроса перевода с неподдерживаемой языковой парой, перевод выполняется с выключенным параметром brevity.

Список языковых пар, которые поддерживают brevity, см. в руководстве разработчика Amazon Translate.