Start a video
Starts a video job and returns at once with status 202. The dearest the clip could cost is held from the balance; poll GET /v1/videos/{job_id} until it is completed, which settles the real price once, then download it. Only the key that started a job can see it. The body may be up to 25 MiB (gzip allowed), and a key limited to some models may only call those models.
Requires the ai permission.
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer jb_live_…
Body
Together frame_images and input_references may hold at most 8 items.
A video model id from GET /v1/videos/models.
What happens in the clip.
1 - 8000Length in seconds. Must be one of the model's durations.
Must be one of the model's resolutions.
Must be one of the model's aspect_ratios.
Start or end frames, passed to the video provider as given. The model's frame_images lists what it supports.
Reference images or clips, passed to the video provider as given.
Whether the clip should have sound, for models that can.
Response
The job was accepted.
The job id. Use it with the other video routes.
Always video.
The model used.
pending and in_progress while it runs; completed, failed, cancelled or expired when it is over.
Credits held when the job started: the dearest the clip could cost.
When the provider created the job.
When the job finished.
Why it failed, if it did.
How many clips the job made, once known. Download them with index 0 to 8.
Credits actually charged. Present once the job has finished; the hold beyond it is released.