Initiate an image-to-video generation task
Create a task to generate video from images using models V, KL, or S.
Detailed Model Parameter Rules
Depending on the value ofmodel, the required status and valid ranges for parameters are as follows:
- Model V
- Model KL
- Model S
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Limited to 1000 characters. |
| image_url | No | Required for Start-Frame Mode. |
| end_image_url | No | Supports end frame upload. |
| reference_images | No | Required for Multi-Image Mode. (Max 3 images) |
| aspect_resolution | Yes | Supports 720p, 1080p, 4k. |
| duration | Yes | Single-image: 4, 6, 8s; Multi-image: fixed at 8s. |
| generate_audio | No | Supports audio configuration. |
end_image_url bad case Notes
End frame aspect ratio should match start frame. Mismatch reduces quality.Callback Notification
After the video generation task is processed, the service will send a POST request to thecallback_url provided in the initiation request.
Structure
0 indicates a successful callback transmission.image_to_video.Callback Example
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Create an image-to-video generation task. Supports models V, KL, and S.
Model identifier code.
V: Supports single/multi-image, audio, and 4k.KL: Focused on multi-reference image mode.S: Focused on single start-frame mode.
V, KL, S "V"
Prompt for video generation. Limit: 1000 characters.
"A golden retriever running in the grass, sunny day, cinematic lighting"
Video aspect ratio.
16:9, 9:16 "16:9"
Video resolution.
- Model V: 720p, 1080p, 4k
- Model KL: 720p, 1080p
- Model S: 720p (fixed)
720p, 1080p, 4k "1080p"
Video duration in seconds.
- Model V: 4, 6, 8 (single); 8 (multi)
- Model KL: 5, 10
- Model S: 4, 8, 12
4, 5, 6, 8, 10, 12 6
URL of the start frame image.
- This field is required for Model S and Model V when using the Start-Frame mode.
- Not used in Model KL.
- Limit: Maximum file size is 20MB.
"https://example.com/start_frame.jpg"
List of reference image URLs.
- Required for Model KL and Model V (Multi-image mode).
- Not used in Model S.
- Limit: Maximum file size is 20MB.
[
"https://example.com/ref1.jpg",
"https://example.com/ref2.jpg"
]Whether to generate audio. Only supported by Model V.
true
Number of videos to generate (1-4).
1 <= x <= 41
Callback URL for task completion notification.
"https://your-server.com/callback"

