Подключиться
Yandex Translate

Метод translate

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

HTTP-запрос

POST https://translate.api.cloud.yandex.net/translate/v2/translate

Параметры в теле запроса

{
  "sourceLanguageCode": "string",
  "targetLanguageCode": "string",
  "format": "string",
  "texts": [
    "string"
  ],
  "folderId": "string",
  "model": "string",
  "glossaryConfig": {
    "glossaryData": {
      "glossaryPairs": [
        {
          "sourceText": "string",
          "translatedText": "string"
        }
      ]
    }
  }
}
Поле Описание
sourceLanguageCode string

Язык, на котором написан исходный текст. Указывается в формате ISO 639-1 (например, ru).

Обязательно при переводе с глоссарием.

Максимальная длина строки в символах — 3.
targetLanguageCode string

Обязательное поле. Язык, на который переводится текст. Указывается в формате ISO 639-1 (например, en).

Максимальная длина строки в символах — 3.
format string

Формат текста.

  • PLAIN_TEXT: Текст без разметки. Значение по умолчанию.
  • HTML: Текст в формате HTML.
texts[] string

Обязательное поле. Массив строк для перевода. Максимальная общая длина всех строк составляет 10000 символов.

Должен содержать хотя бы один элемент.
folderId string

Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс UserAccount ). Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта.

Максимальная длина строки в символах — 50.
model string

Не используйте это поле, пользовательские модели пока не поддерживаются.

Максимальная длина строки в символах — 50.
glossaryConfig object

Глоссарий для применения при переводе. Дополнительные сведения см. в разделе Глоссарии.
glossaryConfig.
glossaryData		 object
Передать содержимое глоссария в запросе. В настоящее время поддерживается только этот способ передачи глоссария.
glossaryConfig.
glossaryData.
glossaryPairs[]		 object

Обязательное поле. Массив текстовых пар.

Максимальная общая длина всех исходных текстов 10000 символов. Максимальная общая длина всех переведенных текстов 10000 символов.

Количество элементов должно находиться в диапазоне от 1 до 50.
glossaryConfig.
glossaryData.
glossaryPairs[].
sourceText		 string

Обязательное поле. Текст на языке оригинала.
glossaryConfig.
glossaryData.
glossaryPairs[].
translatedText		 string

Обязательное поле. Текст на языке перевода.

Ответ

HTTP Code: 200 - OK

{
  "translations": [
    {
      "text": "string",
      "detectedLanguageCode": "string"
    }
  ]
}
Поле Описание
translations[] object

Массив переводов.
translations[].
text		 string

Переведенный текст.
translations[].
detectedLanguageCode		 string

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