Перейти до вмісту

Статус завдання

GET /api/v1/jobs/{job_id}

Запит лише читає стан і не споживає кредити.

Terminal window
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \
-H "X-API-Key: $OMNIDOC_API_KEY"
statusЗначення
pendingСтворено, очікує в черзі
processingОбробляється
completedЗавершено; результати можна прочитати
failedНе вдалося або скасовано; див. error_msg

status вказує, чи завершилася робота.

stageЗначення
queuedУ черзі
accepted / preflightПрийнято та готується
translatingПерекладання
writing_artifacts / finalizingГенерація та реєстрація результатів
completed / failedЗавершено

stage_progress — це відображення прогресу від 0 до 100; воно не використовується для обліку. Поки завдання перебуває в черзі, queue_position може показувати кількість завдань, що чекають попереду, або може дорівнювати null.

GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00Z
POST /api/v1/jobs/{job_id}/cancel

Скасування здійснюється за принципом best effort; завдання, яке вже завершилося, повертає 409. За скасовані завдання не стягується оплата, що можна перевірити в історії кредитів.

Після завершення завдання:

GET /api/v1/artifacts?job_id={job_id}

Список результатів пустий, хоча завдання все ще виконується.