Files
Generate video
Generate a video from text, an optional start frame, or supported start and end frames.
Video generation uses a reviewed Vercel AI Gateway catalog. OVI remains available as an explicit legacy image-to-video model.
Parameters#
instructionstringrequiredDescription of the desired motion, scene evolution, and audio description.
filepathstringdefault: ""Optional start-frame image path. Retained as the legacy positional argument.
file_suffixstringdefault: _videoSuffix used when file_stem is empty and a start frame is present.
orientationstringdefault: landscapeCompatibility orientation used when aspect_ratio is empty.
modelstringdefault: ""Optional public model ID. Empty uses the workspace video default.
end_frame_pathstringdefault: ""Optional end-frame path. Requires a model with a start-and-end-frame variant and a start frame.
duration_secondsnumberdefault: 0Duration in seconds. Use 0 for the selected model's default.
aspect_ratiostringdefault: ""Normalized aspect ratio. Empty uses orientation.
resolutionstringdefault: ""Optional normalized resolution such as 480p, 720p, or 1080p.
generate_audiostringdefault: autoAudio mode: auto uses the model default; on or off requests an explicit setting.
output_dirstringdefault: ""Output directory. Gateway videos default to /home/workspace/Videos.
file_stemstringdefault: ""Output base name. Defaults from the start frame or to video.