API Перевода

Ctrl предыдущаяследующая Ctrl

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

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

Интерфейсы:

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

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

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

https://translate.yandex.net/api/v1.5/tr.json/translate ? 
key
[no-highlight[

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

]no-highlight]
=<API-ключ>text
[no-highlight[

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

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

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

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

    Максимальный размер строки запроса не должен превышать 10Кб.

]no-highlight]
=<переводимый текст>lang
[no-highlight[

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

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

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

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

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

  • plain — текст без разметки (значение по умолчанию);
  • html — текст в формате HTML.
]no-highlight]
=<формат текста>] & [options
[no-highlight[

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

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

]no-highlight]
=<опции перевода>] & [callback
[no-highlight[Имя функции обратного вызова. Используется в том случае, когда необходимо получить JSONP-ответ.]no-highlight]
=<имя callback-функции>]
key

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

text

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

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

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

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

    Максимальный размер строки запроса не должен превышать 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
[no-highlight[

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

]no-highlight]
=<API-ключ>text
[no-highlight[

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

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

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

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

    Максимальный размер строки запроса не должен превышать 10Кб.

]no-highlight]
=<переводимый текст>lang
[no-highlight[

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

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

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

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

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

  • plain — текст без разметки (значение по умолчанию);
  • html — текст в формате HTML.
]no-highlight]
=<формат текста>] & [options
[no-highlight[

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

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

]no-highlight]
=<опции перевода>]
key

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

text

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

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

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

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

    Максимальный размер строки запроса не должен превышать 10Кб.

lang

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

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

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

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

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

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

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

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

Коды ответа

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

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

401

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

402

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

403

Превышено суточное ограничение на количество запросов

404

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

413

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

422

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

501

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