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

JSON- и JSONP-интерфейсы

Ответ возвращается в формате JSON. Если задан параметр callback, JSON-объект оборачивается в функцию, с названием, указанным в этом параметре (JSONP).

Синтаксис запроса

https://translate.yandex.net/api/v1.5/tr.json/translate
 ? [key=<API-ключ>]
 & [text=<переводимый текст>]
 & [lang=<направление перевода>]
 & [format=<формат текста>]
 & [options=<опции перевода>]
 & [callback=<имя callback-функции>]
key

API-ключ. Выдается бесплатно.

text

Текст, который необходимо перевести.

В запросе можно использовать несколько параметров text.

Внимание.

Для исходного текста обязательно используйте URL-кодирование.

Ограничения:

  • Для POST-запросов максимальный размер передаваемого текста составляет 10 000 символов.
  • В GET-запросах ограничивается не размер передаваемого текста, а размер всей строки запроса, которая кроме текста может содержать и другие параметры.

    Максимальный размер строки — от 2 до 10 КБ (зависит от версии используемого браузера).

lang

Направление перевода.

Может задаваться одним из следующих способов:

  • В виде пары кодов языков («с какого»-«на какой»), разделенных дефисом. Например, en-ru обозначает перевод с английского на русский.
  • В виде кода конечного языка (например ru). В этом случае сервис пытается определить исходный язык автоматически.
format

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

Возможные значения:

  • plain — текст без разметки (значение по умолчанию);
  • html — текст в формате HTML.
options

В настоящее время доступна единственная опция — признак включения в ответ автоматически определенного языка переводимого текста. Этому соответствует значение 1 этого параметра.

Если язык переводимого текста задан в явном виде, т. е. параметр lang представлен в виде пары кодов, то первый код однозначно определяет исходный язык. Это означает, что параметр options не позволяет переключиться в режим автоматического определения языка. Однако он позволяет понять, правильно ли был указан исходный язык в параметре lang.

callbackИмя функции обратного вызова. Используется для получения JSONP-ответа.
Примечание. Все специальные символы должны быть экранированы.

XML-интерфейс

Ответ возвращается в формате XML.

Синтаксис запроса

https://translate.yandex.net/api/v1.5/tr/translate
 ? [key=<API-ключ>]
 & [text=<переводимый текст>]
 & [lang=<направление перевода>]
 & [format=<формат текста>]
 & [options=<опции перевода>]
key

API-ключ. Выдается бесплатно.

text

Текст, который необходимо перевести.

В запросе можно использовать несколько параметров text.

Внимание.

Для исходного текста обязательно используйте URL-кодирование.

Ограничения:

  • Для POST-запросов максимальный размер передаваемого текста составляет 10 000 символов.
  • В GET-запросах ограничивается не размер передаваемого текста, а размер всей строки запроса, которая кроме текста может содержать и другие параметры.

    Максимальный размер строки — от 2 до 10 КБ (зависит от версии используемого браузера).

lang

Направление перевода.

Может задаваться одним из следующих способов:

  • В виде пары кодов языков («с какого»-«на какой»), разделенных дефисом. Например, en-ru обозначает перевод с английского на русский.
  • В виде кода конечного языка (например ru). В этом случае сервис пытается определить исходный язык автоматически.
format

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

Возможные значения:

  • plain — текст без разметки (значение по умолчанию);
  • html — текст в формате HTML.
options

В настоящее время доступна единственная опция — признак включения в ответ автоматически определенного языка переводимого текста. Этому соответствует значение 1 этого параметра.

Если язык переводимого текста задан в явном виде, т. е. параметр lang представлен в виде пары кодов, то первый код однозначно определяет исходный язык. Это означает, что параметр options не позволяет переключиться в режим автоматического определения языка. Однако он позволяет понять, правильно ли был указан исходный язык в параметре lang.

Примечание. Все специальные символы должны быть экранированы.

Коды ответов

Описание возможных кодов ответов.

Значение Описание
200

Операция выполнена успешно

401

Неправильный API-ключ

402

API-ключ заблокирован

404

Превышено суточное ограничение на объем переведенного текста

413

Превышен максимально допустимый размер текста

422

Текст не может быть переведен

501

Заданное направление перевода не поддерживается