Media & Video
generateVideo
Generate Video
Generate a video clip with AI and add it to a Studio project as a PRIVATE asset in that project's media pool.
Arguments
appIdstringrequiredThe Studio app ID to add the generated video to. Create one with createStudioApp first if you don't have one.candidatesnumberoptionalOptional number of takes to run in this call (preset rail). Defaults to the preset's candidate count (usually 1, one deliberate take, reviewed, then iterate only on the named defect). A preset refuses more than its ceiling.durationSecondsnumberoptionalOptional clip length in seconds (1-10, preset rail). Defaults to the preset's duration, then 5.modelstringoptionalOptional model id. Without a preset: a Studio video model id from the generation registry (defaults to ltx-video). On a preset run: the image-to-video model for the animation stage (defaults to the preset's model, then the standard model).presetIdstringoptionalOptional preset slug naming a reusable, calibrated parameter set (from listGenerationPresets), e.g. "living-illustration". The preset supplies the motion, camera and style discipline; anything you pass explicitly overrides it.promptstringrequiredA description of what the generated video should show.sourceImageUrlstringoptionalOptional publicly reachable https:// image URL to animate as the start frame (the prompt becomes the motion cue). On a preset run the text-to-image stage is skipped and the video animates THIS exact image, use it to bring existing art to…
Returns
The registry does not declare a return shape.
Ask for it
The Cloud routes these requests to this verb.
- generate a video of X
- make an AI video clip
- animate this image
Pair it with
The verbs that finish the job.