Статус завдання
GET /api/v1/jobs/{job_id}Запит лише читає стан і не споживає кредити.
curl https://omnidoc.top/api/v1/jobs/q3f8s6c2a9m1k4tx \ -H "X-API-Key: $OMNIDOC_API_KEY"Стани життєвого циклу
Section titled “Стани життєвого циклу”status | Значення |
|---|---|
pending | Створено, очікує в черзі |
processing | Обробляється |
completed | Завершено; результати можна прочитати |
failed | Не вдалося або скасовано; див. error_msg |
status вказує, чи завершилася робота.
Етапи прогресу
Section titled “Етапи прогресу”stage | Значення |
|---|---|
queued | У черзі |
accepted / preflight | Прийнято та готується |
translating | Перекладання |
writing_artifacts / finalizing | Генерація та реєстрація результатів |
completed / failed | Завершено |
stage_progress — це відображення прогресу від 0 до 100; воно не використовується для обліку. Поки завдання перебуває в черзі, queue_position може показувати кількість завдань, що чекають попереду, або може дорівнювати null.
Списати та скасувати
Section titled “Списати та скасувати”GET /api/v1/jobs?limit=20&before=2026-10-01T12:00:00ZPOST /api/v1/jobs/{job_id}/cancelСкасування здійснюється за принципом best effort; завдання, яке вже завершилося, повертає 409. За скасовані завдання не стягується оплата, що можна перевірити в історії кредитів.
Отримати результати
Section titled “Отримати результати”Після завершення завдання:
GET /api/v1/artifacts?job_id={job_id}Список результатів пустий, хоча завдання все ще виконується.