跳到內容

任務狀態

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}

任務尚未完成時,產物列表為空。