Model
Supported Modes
| Mode | Description |
|---|---|
| (omit) | Text-to-video. You control the aspect ratio. |
first_last_frame | Start frame required, end frame optional. Aspect ratio auto-detected from input. |
multi_frame | Keyframe images with per-frame prompts and durations. 720p only. |
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | No | "" | Text description of the desired video |
mode | string | No | null | first_last_frame or multi_frame. Omit for text-to-video. |
aspect_ratio | string | No | "1:1" | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16. Only used for text-to-video. |
duration | integer | No | 5 | Duration in seconds: 5 or 10. Auto-calculated in multi_frame mode. |
resolution | string | No | "720p" | 720p or 1080p. Multi-frame mode requires 720p. |
seed | integer | No | random | Seed for reproducibility |
first_frame_url | string | Conditional | null | Start frame image. Required for first_last_frame. |
last_frame_url | string | No | null | End frame image. Optional for first_last_frame. |
frames | object[] | Conditional | null | Keyframes. Required for multi_frame. Min 1. |
Multi-Frame frames Object
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
image_url | string | No | null | Keyframe image URL. Omit for text-only frame. |
prompt | string | No | "" | Per-frame prompt |
duration | integer | No | 5 | Segment duration in seconds |
image_url. Total video duration = sum of all frame durations.
