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

Запрос
- Параметры в теле запроса
Ответ
Примеры
- Пример запроса
- Пример ответа

Важно

Поддержка версии 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"
        }
    ]
}