Каталог документів

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-
  • AI-модель для перекладу
  • Підтримувані моделі: запит
-
fileDescriptionString-

Опис документа: надання додаткової інформації для підвищення якості перекладу, наприклад, додавання фонової інформації про документ та інших вимог до перекладу тощо

-
glossaryString-

Назва глосарію, що використовується для перекладу

-
previewBooleanfalse

Чи генерувати лише попередній перегляд. При генерації лише попереднього перегляду сплатіть 2 кредити для створення попереднього перегляду перекладу документа

-
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-
  • Перекладати лише вміст, що відповідає регулярному виразу, та замінювати його перекладом
  • Підтримується лише txmsg
-
extractTextRegExpFlagsString-
  • Прапорці регулярних виразів: g, s, m, u, y
  • Підтримується лише txmsg
-
webhookUrlString-

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

-

Відповідь

ПараметриТипЗа замовчуваннямОписПриклад
taskIdString-

ID завдання

-
API завдання перекладу
Запит завдань перекладу