Статус задания
GET /api/v1/jobs/{job_id}Запрос только считывает статус и не потребляет кредиты.
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:00ZPOST /api/v1/jobs/{job_id}/cancelОтмена производится по мере возможности; задание, которое уже завершено, возвращает 409. За отменённые задания плата не взимается — это можно проверить в записи о зачислении средств.
Получить результаты
Заголовок раздела «Получить результаты»После завершения задания:
GET /api/v1/artifacts?job_id={job_id}Список результатов пуст, хотя задание всё ещё выполняется.