Оглавление документа

API задач перевода

Создать задачу перевода

/v1/translation/create

Создайте новую задачу перевода для перевода документа/файла.

Пример

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/create' \
2--header 'Authorization: [yourSecretKey]' \
3--form 'file=@bitcoin.pdf' \
4--form 'fromLang=English' \
5--form 'toLang=Simplified Chinese'

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

ПараметрыТипПо умолчаниюОписаниеПример
*filebinary-
  • Файл, который необходимо перевести - Поддерживаемые типы файлов: запрос
bitcoin.pdf
*fromLangString-
  • Исходный язык; исходный язык не может совпадать с целевым языком - Поддерживаемые языки: запрос
English
*toLangString-
  • Целевой язык, целевой язык не может совпадать с исходным языком - Поддерживаемые языки: запрос
Simplified Chinese
modelString-
  • ИИ-модель для перевода - Поддерживаемые модели: запрос
-
fileDescriptionString-

Описание документа: повышение качества перевода путём предоставления дополнительной информации, например, добавление справочных сведений о документе и прочих требований к переводу

-
glossaryString-

Название глоссария, используемого при переводе

-
previewBooleanfalse

Генерировать только предварительный просмотр. При генерации только предварительного просмотра заплатите 2 credits для создания предварительного просмотра перевода документа

-
shouldTranslateImageBooleanfalse
  • Переводить ли изображения в документе - Поддерживаются только PDF / DOCX / PPTX / EPUB / ODS / ODT / ODF
-
shouldTranslateFileNameBooleantrue

Переводить ли имена файлов

-
passwordString-

Пароль для открытия PDF-файла

-
ignoreCommentsBooleanfalse

Игнорировать ли примечания в DOCX, PPTX и XLSX

-
ignoreNotesBooleanfalse

Игнорировать ли заметки в PPTX

-
ignoreHeadersAndFootersBooleanfalse

Игнорировать ли верхние и нижние колонтитулы в DOCX

-
ignoreHiddenBooleanfalse

Игнорировать ли скрытые слайды в PPTX

-
ignoreMastersBooleanfalse

Игнорировать ли текст образца слайдов в PPTX

-
ignoreSheetNamesBooleanfalse

Не переводить ли названия листов XLSX

-
extractTextRegExpPatternString-
  • Переводить только содержимое, соответствующее регулярному выражению, и заменять его переводом - Поддерживается только txt
-
extractTextRegExpFlagsString-
  • Флаги регулярных выражений: g, s, m, u, y - Поддерживается только txt
-
webhookUrlString-

URL обратного вызова при обновлении статуса, содержимое обратного вызова включает: {taskId, progress, status}

-

Ответ

ПараметрыТипПо умолчаниюОписаниеПример
taskIdString-

ID задачи

-
API задач перевода
Запрос задач перевода