ジョブの状態を取得
生成ジョブの進行状況と、結果を取得できるかどうかを確認します。
認証
AuthorizationstringrequiredBearer YOUR_API_KEY を指定します。x-api-key による認証も使用できますが、両方を同時には送信しません。キーはサーバー側で保管してください。
パスパラメーター
idstringrequired生成時に受け取ったジョブ ID。同じワークスペースのジョブを指定します。例:job_7513b52d-3669-4ffe-b317-8b02000715eb。
レスポンス
進行状況と次の操作。terminal が true なら状態確認を終了し、result_ready が true のとき result_url を取得します。
data.request_idstringこの生成または HTTP 要求を追跡する ID。HTTP の相関 ID とジョブ ID は別に記録します。
data.job_idstring状態・結果・イベントを取得する生成ジョブの ID。
data.statusstring進行状況の大文字表記。orchestor_status に対応し、COMPLETED、FAILED、CANCELED は終端状態です。 値:IN_QUEUE、IN_PROGRESS、COMPLETED、FAILED、CANCELED。
data.orchestor_statusstring共通ジョブの小文字の状態。status の大文字表記と同じ進行状況を表します。 値:queued、processing、completed、failed、canceled。
data.status_urlstringこのジョブの状態を GET で確認する URL。
data.result_urlstring完了後の成果物を GET で取得する URL。
data.events_urlstringジョブの状態遷移と配信履歴を取得する URL。
data.cancel_urlstring | null生成開始前に取り消すための POST 先。取り消せない場合は null。
data.cancelableboolean現在このジョブを取り消せるかどうか。
data.next_actionstring次に必要な操作。値に従って入力修正、待機、状態確認、結果取得などを行います。 値:poll_status、fetch_result、inspect_events。
data.next_poll_after_secondsinteger | null次の状態取得まで待つ秒数。終端状態では null。
data.recommended_poll_interval_secondsinteger | null継続して状態を取得する場合の推奨間隔。単位は秒。
data.retry_after_secondsinteger | null同じ要求を再試行するまで待つ秒数。再試行不要なら null。
data.result_readyboolean成果物を result_url から取得できるかどうか。
data.terminalboolean成功・失敗・取消のいずれかで処理が終了したかどうか。
data.queueobjectジョブの待機順、再開予定、実行環境の状態。
data.queue_positioninteger | null待機列の位置。位置が確定しない場合は null。
data.logs_availablebooleanジョブのイベント履歴を参照できるかどうか。
data.jobobject生成ジョブの入力、状態、時刻、結果をまとめた情報。
その他の応答は 400、403、429、500、502、503 です。429 は retry-after に従って再試行してください。
terminal が true でも、成功とは限りません。result_ready が true のとき、result_url から成果物を取得します。
curl --request GET 'https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status' \
--header "Authorization: Bearer $ORCHESTOR_API_KEY"Python の例には requests が必要です(python3 -m pip install requests)。
{
"data": {
"request_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
"job_id": "job_7513b52d-3669-4ffe-b317-8b02000715eb",
"status": "IN_QUEUE",
"orchestor_status": "queued",
"status_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/status",
"result_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/result",
"events_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/events",
"cancel_url": "https://api.orchestor.io/v1/creative/jobs/job_7513b52d-3669-4ffe-b317-8b02000715eb/cancel",
"cancelable": true,
"next_action": "poll_status",
"next_poll_after_seconds": 2,
"recommended_poll_interval_seconds": 2,
"retry_after_seconds": null,
"result_ready": false,
"terminal": false,
"queue": {
"state": "waiting",
"reason": "キューで待機中です。",
"position": null,
"available_at": "2026-11-06T00:00:00Z",
"retry_after_seconds": null,
"runtime": {
"job_ledger_configured": true,
"worker_configured": true,
"worker_heartbeat": {
"status": "fresh",
"last_seen_at": "2026-11-06T00:00:00Z",
"stale_after_seconds": 60
}
}
},
"queue_position": null,
"logs_available": true
}
}