Метод 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

Глоссарий для применения при переводе. Дополнительные сведения см. в разделе Glossaries.

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).