Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Translate
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Перевод текста
    • Повышение точности перевода
    • Определение языка текста
    • Получение списка поддерживаемых языков
  • Концепции
    • Обзор
    • Дообучение моделей
    • Поддерживаемые языки
    • Глоссарии
    • Поддержка глоссариев
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • TranslationService
    • REST
      • v2
        • Обработка ошибок
        • Диагностика ошибок
        • Обзор
        • Translation
          • Обзор
          • detectLanguage
          • listLanguages
          • translate
      • v1 (DEPRECATED)
        • Обзор
        • Перевод текста
        • Определение языка текста
        • Список поддерживаемых языков
        • Формат ответа
  • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
    • Действующие правила
    • Архив
      • Правила до 1 января 2019 года
  • Вопросы и ответы
  1. Справочник API
  2. REST
  3. v1 (DEPRECATED)
  4. Перевод текста

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

Статья создана
Yandex.Cloud
  • Запрос
    • Параметры в теле запроса
  • Ответ
  • Примеры
    • Пример запроса
    • Пример ответа

Важно

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

Была ли статья полезна?

Language / Region
© 2022 ООО «Яндекс.Облако»
В этой статье:
  • Запрос
  • Параметры в теле запроса
  • Ответ
  • Примеры
  • Пример запроса
  • Пример ответа