Skip to main content

Overview

Video generation can take minutes. The async queue returns immediately with a generation ID so you can avoid long-lived HTTP connections, run generations in parallel, and build progress-tracking UIs. You can either poll the queue or use SSE to receive events when generations complete.

Enqueue a Job

Poll Until Done

Poll a generation by ID until its status reaches a terminal value (succeeded, failed, or cancelled). The response includes result_url on success and error_message on failure.
You can also list your active generations with GET /ai/queue. It gets sorted by recency and paginated, returning up to 1,000 per call:

Fetch a Single Job

Use the generation ID to get a specific job’s full status, including result_url on success:

What’s Next