Метод translate

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

HTTP-запрос

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

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

{
  "sourceLanguageCode": "string",
  "targetLanguageCode": "string",
  "format": "string",
  "texts": [
    "string"
  ],
  "folderId": "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.

Ответ

HTTP Code: 200 - OK

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

Массив переводов.

translations[].
text
string

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

translations[].
detectedLanguageCode
string

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