작업 상태
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}작업이 아직 실행 중인데 결과 목록이 비어 있습니다.