任務狀態
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 是判斷任務是否結束的依據。
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}任務尚未完成時,產物列表為空。