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

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

Запрос

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"
        }
    ]
}