Model
Modes
| Mode | How to activate | Description |
|---|---|---|
| Text-to-video (T2V) | Omit start_frame_image_url | Generate video from a text prompt. Optionally pass up to 7 reference images via image_urls |
| Image-to-video (I2V) | Provide start_frame_image_url | Animate a starting frame into video. Optionally pass additional reference images via image_urls (max 7 total across both fields) |
Parameters
| Parameter | Type | Required | Default | Allowed Values | Description |
|---|---|---|---|---|---|
prompt | string | Yes | — | 2–3000 chars | Video generation prompt |
start_frame_image_url | string | No | null | — | Start frame image URL for I2V mode |
image_urls | string[] | No | null | 1–7 URLs | Reference image URLs for style, subject, or scene guidance |
aspect_ratio | string | No | "auto" | "auto", "9:16", "3:4", "1:1", "4:3", "16:9", "21:9" | Output aspect ratio |
duration | int | No | — | 1–30 | Video length in seconds |
resolution | string | No | — | "480p", "720p" | Output resolution |
video_preset | string | No | "custom" | "custom", "spicy", "fun", "normal" | Generation style preset |
| Preset | Style |
|---|---|
custom | Default generation |
spicy | Extremely spicy/nsfw |
fun | Extremely crazy/fun |
normal | Normal style |
