Videos
List videos
List your workspace's video jobs, newest first
/v1/videosReturns your workspace's video jobs, newest first, in pages of up to 100. To get the next page, pass the response's last_id as after while has_more is true.
List entries carry each job's status and parameters but no download link. Retrieve a completed job to get one.
Authorizationstringrequired
Your authentication credentials. For Basic authentication, populate Basic $INWORLD_API_KEY.
limitintegerdefault: 20
How many jobs to return, from 1 to 100.
afterstring
A job id from a previous page, usually its last_id. Returns the jobs created before that one.
objectenum<string>
Available options:list
dataobject[]
Jobs, newest first, without output.
Show child attributes
idstringrequired
The job id.
objectenum<string>required
Available options:video
modelstringrequired
statusenum<string>required
queued: accepted; waiting for or being submitted for generation, so cancellation may already be unavailable. in_progress: generating. completed: generation succeeded; download available until expires_at. failed: see error. cancelled: cancelled before generation started. The last three are terminal.
Available options:queuedin_progresscompletedfailedcancelled
created_atintegerrequired
When the job was created, in Unix seconds.
completed_atinteger
When the video finished, in Unix seconds. Present once status is completed.
expires_atinteger
Until when the video can be downloaded, in Unix seconds: 7 days after it finished. Present only when status is completed.
secondsintegerrequired
The requested clip length, with the model's default filled in.
resolutionstringrequired
The requested resolution, with the model's default filled in.
aspect_ratiostringrequired
The requested aspect ratio, with the model's default filled in.
operationstring
The job's long-running operation. Poll it with GET https://api.inworld.ai/lro/v1alpha/{operation} as an alternative to retrieving the job. The operation reports progress and the outcome but never the download link. See Poll the operation instead.
errorobject
Why the job failed. Present only when status is failed.
Show child attributes
codeenum<string>
content_filtered: the prompt or the generated video was blocked by the model provider's content policy. invalid_request: the model provider rejected the request. generation_failed: generation failed for another reason. generation_timeout: generation did not finish in time.
Available options:content_filteredinvalid_requestgeneration_failedgeneration_timeout
messagestring
outputobject
The finished video. Returned only by Retrieve video, only while status is completed and before expires_at.
Show child attributes
videosobject[]
Show child attributes
indexinteger
content_typestring
bytesinteger
File size in bytes.
urlstring
A signed HTTPS link to the MP4. Anyone with the link can download the file until url_expires_at, so treat it like a secret.
url_expires_atinteger
When url stops working, in Unix seconds: up to an hour after the request, and never after the job's expires_at.
has_moreboolean
Whether older jobs remain. Pass last_id as after to get them.
first_idstring
The id of the first job on this page. Absent on an empty page.
last_idstring
The id of the last job on this page. Absent on an empty page.