コンテンツにスキップ

ジョブのステータス

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}

ジョブがまだ実行中の間、結果リストは空です。