TranslationService

Набор методов для сервиса Yandex Translate.

Вызов	Описание
Translate	Переводит текст на указанный язык.
DetectLanguage	Определяет язык текста.
ListLanguages	Получает список поддерживаемых языков.

Вызовы TranslationService

Translate

Переводит текст на указанный язык.

rpc Translate (TranslateRequest) returns (TranslateResponse)

TranslateRequest

Поле	Описание
source_language_code	string Язык, на котором написан исходный текст. Указывается в формате ISO 639-1 (например, ru). Обязательно при переводе с глоссарием. Максимальная длина строки в символах — 3.
target_language_code	string Обязательное поле. Язык, на который переводится текст. Указывается в формате ISO 639-1 (например, en). Максимальная длина строки в символах — 3.
format	enum Format Формат текста. PLAIN_TEXT: Текст без разметки. Значение по умолчанию. HTML: Текст в формате HTML.
texts[]	string Массив строк для перевода. Максимальная общая длина всех строк составляет 10000 символов. Количество элементов должно быть больше 0.
folder_id	string Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс yandex.cloud.iam.v1.UserAccount) . Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта. Максимальная длина строки в символах — 50.
model	string Не используйте это поле, пользовательские модели пока не поддерживаются. Максимальная длина строки в символах — 50.
glossary_config	TranslateGlossaryConfig Глоссарий для применения при переводе. Дополнительные сведения см. в разделе Глоссарии.

TranslateGlossaryConfig

Поле	Описание
glossary_source	oneof: glossary_data
glossary_data	GlossaryData Передать содержимое глоссария в запросе. В настоящее время поддерживается только этот способ передачи глоссария.

GlossaryData

Поле	Описание
glossary_pairs[]	GlossaryPair Массив текстовых пар. Максимальная общая длина всех исходных текстов 10000 символов. Максимальная общая длина всех переведенных текстов 10000 символов. Количество элементов должно находиться в диапазоне от 1 до 50.

GlossaryPair

Поле	Описание
source_text	string Обязательное поле. Текст на языке оригинала.
translated_text	string Обязательное поле. Текст на языке перевода.

TranslateResponse

Поле	Описание
translations[]	TranslatedText Массив переводов.

TranslatedText

Поле	Описание
text	string Переведенный текст.
detected_language_code	string Код языка исходного текста. Указывается в формате ISO 639-1 (например, en).

DetectLanguage

Определяет язык текста.

rpc DetectLanguage (DetectLanguageRequest) returns (DetectLanguageResponse)

DetectLanguageRequest

Поле	Описание
text	string Обязательное поле. Текст, язык которого требуется определить. Максимальная длина строки в символах — 1000.
language_code_hints[]	string Список наиболее вероятных языков. Этим языкам будет отдаваться предпочтение при определении языка текста. Указывается в формате ISO 639-1 (например, ru). Чтобы получить список поддерживаемых языков, используйте запрос TranslationService.ListLanguages. Максимальное количество элементов — 10. Максимальная длина строки в символах для каждого значения — 3.
folder_id	string Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс yandex.cloud.iam.v1.UserAccount) . Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта. Максимальная длина строки в символах — 50.

DetectLanguageResponse

Поле	Описание
language_code	string Язык текста в формате ISO 639-1 (например, ru). Чтобы получить название языка, используйте запрос TranslationService.ListLanguages.

ListLanguages

Получает список поддерживаемых языков.

rpc ListLanguages (ListLanguagesRequest) returns (ListLanguagesResponse)

ListLanguagesRequest

Поле	Описание
folder_id	string Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс yandex.cloud.iam.v1.UserAccount) . Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта. Максимальная длина строки в символах — 50.

ListLanguagesResponse

Поле	Описание
languages[]	Language Список поддерживаемых языков.

Language

Поле	Описание
code	string Код языка. Указывается в формате ISO 639-1 (например, en).
name	string Название языка (например, English).