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

Важная информация

Поддержка версии v1 прекращается с февраля 2019, методы ниже будут недоступны. Используйте версию v2.

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

Запрос

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

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

Для всех параметров обязательно используйте URL-кодирование. Максимальный размер тела POST-запроса 30 КБ.

Параметр Описание
text Обязательный параметр.
Текст, который необходимо перевести, в кодировке UTF-8.
В запросе можно использовать несколько параметров text.
source Язык, на котором написан исходный текст.
Задается в виде двухбуквенного кода языка в соответствии с ISO-639-1 (например ru). Если параметр не задан, сервис пытается определить исходный язык автоматически.
target Обязательный параметр.
Направление перевода.
Задается в виде двухбуквенного кода языка в соответствии с ISO-639-1 (например ru).
format Формат текста.
Возможные значения:
  • plain — текст без разметки (значение по умолчанию)
  • html — текст в формате HTML.
folderId Обязательный параметр.
Идентификатор вашего каталога.

Ответ

Ответ возвращается в формате JSON.

{
    "translations": [
        {"text": <перевод текста>},
        ...
    ]
}

Примеры

Пример запроса

export FOLDER_ID=<folder id>
export TOKEN=<IAM-token>
curl -X POST \
     -H "Authorization: Bearer ${TOKEN}" \
     -d "folderId=${FOLDER_ID}&target=en" \
     --data-urlencode "text=привет мир" \
     --data-urlencode "text=доброе утро" \
     "https://translate.api.cloud.yandex.net/translate/v1/translate"

Пример ответа

Ответ возвращается в формате JSON.

{
    "translations": [
        {
            "text": "Hello world"
        },
        {
            "text": "good morning"
        }
    ]
}