任务状态

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:00Z
POST /api/v1/jobs/{job_id}/cancel

取消为尽力操作；已经结束的任务返回 409。取消的任务不扣费，可通过积分凭证核对。

获取产物

任务完成后：

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

任务尚未完成时，产物列表为空。