Перевод текста
Статья создана
Обновлена 26 декабря 2023 г.
Важно
Поддержка версии 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 |
Формат текста. Возможные значения:
|
folderId |
Обязательный параметр. Идентификатор вашего каталога. |
Ответ
Ответ возвращается в формате JSON.
{
"translations": [
{"text": <перевод_текста>},
...
]
}
Примеры
Пример запроса
export FOLDER_ID=<идентификатор_каталога>
export TOKEN=<IAM-токен>
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"
}
]
}