Ozor icon

Ozor

Generate, edit, and export AI videos via the Ozor API

Video → Get Job Status

AI-generated

Summary

Retrieve the status of an ongoing or completed video agent job by its Video ID and Job ID, optionally polling until the job is completed or fails.

Inputs

  • Video ID (required) — The ID of the video (project) the job belongs to.
  • Job ID (required) — The agent job ID returned by previous generate or message operations.
  • Wait for Completion — Indicates whether to continuously poll the job status until the job finishes successfully or fails.
  • Max Poll Time (Seconds) — Maximum duration in seconds to poll when waiting for job completion; applicable only if "Wait for Completion" is true.

Output shape

a JSON object representing the current status of the specified agent job.

If "Wait for Completion" is true, the operation polls the job status until it is completed or failed within the maximum polling time, then returns the final status. If false, it returns the immediate current status without waiting or polling. Errors are raised if the job fails or if polling times out before completion.

Examples

Example 1: Check job status without waiting

Set Video ID and Job ID, with Wait for Completion disabled (false). Returns current job status immediately.

Example 2: Wait until job completes or fails

Set Video ID and Job ID, enable Wait for Completion (true), and optionally specify Max Poll Time to control waiting duration. The node polls the job status until completion or failure and returns the final status.

Links

Discussion