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

API завдання перекладу

Перезапустити завдання перекладу

POST/v1/translation/start

Використовується для перезапуску припинених завдань або оплати кредитів для повнотекстового перекладу

Повна адреса
https://otranslator.com/api/v1/translation/start
Аутентифікація
Потрібно передати API Key у заголовку запиту Authorization
Content-Type
application/json
Неправильний формат
{ "error": "Invalid API key." }

Застереження

Цей інтерфейс можна використовувати для перезапуску завдань зі статусом Terminated, а також після завершення попереднього перегляду завдання можна оплатити через payWithCredits і запустити повний переклад.

Оплачені завдання не стягуватимуть плату повторно. При передачі model використовується лише коли payWithCredits має значення true і завдання не оплачено — для перерахунку вартості.

Приклад

curl
1curl -X POST 'https://otranslator.com/api/v1/translation/start' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5  "taskId": "[string]"
6}'

Параметри запиту

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

ID завдання перекладу

-
payWithCreditsBoolean-

Чи здійснювати оплату завдання перекладу; діє лише для неоплачених документів, за вже оплачені документи повторне стягнення коштів не відбувається

-
modelString-
  • Коли параметр payWithCredits встановлено як true, визначає модель для повнотекстового перекладу
  • Підтримувані моделі: запит
-

Відповідь

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

Чи успішно запущено

-

Поширені помилки

401 Missing API key.

The Authorization request header is required.

401 Invalid API key.

The API key does not exist, has been deleted, or is no longer valid.

400 Missing required parameter: taskId.

Provide the taskId returned by the create translation task API.

402 Insufficient credits balance.

The account does not have enough credits to start the full translation.

404 Task not found.

The task does not exist or does not belong to the current API account.

API завдання перекладу
Редагувати переклад
API завдання перекладу
Перекласти текст