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. v2
  4. Translation
  5. translate

Метод translate

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

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

HTTP-запрос

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

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

{
  "sourceLanguageCode": "string",
  "targetLanguageCode": "string",
  "format": "string",
  "texts": [
    "string"
  ],
  "folderId": "string",
  "model": "string",
  "glossaryConfig": {
    "glossaryData": {
      "glossaryPairs": [
        {
          "sourceText": "string",
          "translatedText": "string"
        }
      ]
    }
  }
}
Поле Описание
sourceLanguageCode string

Язык, на котором написан исходный текст. Указывается в формате ISO 639-1 (например, ru).

Обязательно при переводе с глоссарием.

Максимальная длина строки в символах — 3.

targetLanguageCode string

Обязательное поле. Язык, на который переводится текст. Указывается в формате ISO 639-1 (например, en).

Максимальная длина строки в символах — 3.

format string

Формат текста.

  • PLAIN_TEXT: Текст без разметки. Значение по умолчанию.
  • HTML: Текст в формате HTML.
texts[] string

Обязательное поле. Массив строк для перевода. Максимальная общая длина всех строк составляет 10000 символов.

Должен содержать хотя бы один элемент.

folderId string

Идентификатор каталога, к которому у вас есть доступ. Требуется для авторизации с пользовательским аккаунтом (см. ресурс UserAccount ). Не используйте это поле, если вы делаете запрос от имени сервисного аккаунта.

Максимальная длина строки в символах — 50.

model string

Не используйте это поле, пользовательские модели пока не поддерживаются.

Максимальная длина строки в символах — 50.

glossaryConfig object

Глоссарий для применения при переводе. Дополнительные сведения см. в разделе Глоссарии.

glossaryConfig.
glossaryData
object
Передать содержимое глоссария в запросе. В настоящее время поддерживается только этот способ передачи глоссария.
glossaryConfig.
glossaryData.
glossaryPairs[]
object

Обязательное поле. Массив текстовых пар.

Максимальная общая длина всех исходных текстов 10000 символов. Максимальная общая длина всех переведенных текстов 10000 символов.

Количество элементов должно находиться в диапазоне от 1 до 50.

glossaryConfig.
glossaryData.
glossaryPairs[].
sourceText
string

Обязательное поле. Текст на языке оригинала.

glossaryConfig.
glossaryData.
glossaryPairs[].
translatedText
string

Обязательное поле. Текст на языке перевода.

Ответ

HTTP Code: 200 - OK

{
  "translations": [
    {
      "text": "string",
      "detectedLanguageCode": "string"
    }
  ]
}
Поле Описание
translations[] object

Массив переводов.

translations[].
text
string

Переведенный текст.

translations[].
detectedLanguageCode
string

Код языка исходного текста. Указывается в формате ISO 639-1 (например, en).

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

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