콘텐츠로 이동

작업 상태

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

취소는 최선의 노력에 의한 것이며, 이미 종료된 작업은 409을 반환합니다. 취소된 작업에는 비용이 부과되지 않으며, 이는 크레딧 기록에서 확인하실 수 있습니다.

작업이 완료된 후:

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

작업이 아직 실행 중인데 결과 목록이 비어 있습니다.