curl --request POST \
--url https://api.modellix.ai/api/v1/vidu/viduq4-i2v \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_frame_image": "https://example.com/start-frame.jpg"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-vidu-q4-i2v-001",
"model_id": "vidu/viduq4-i2v",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-vidu-q4-i2v-001"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'first_frame_image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Vidu Q4 I2V
[Core Function] Vidu Q4 I2V is the preview flagship image-to-video model that animates one starting frame into a 3-16 second clip with synchronized audio and automatic camera switching. [Strengths] It keeps the supplied image as the opening frame, supports 540p through 4K, and can generate dialogue and sound effects in the same pass. [Best For] Highly recommended for: animating a key still, product or character shots that must begin from a specific image, and short clips that need native sound. [Limitations] Do NOT send more than one image. Do NOT use this model for multi-image subject reference or a chosen output aspect ratio; the frame follows the first image. Do NOT use a duration under 3 seconds or over 16 seconds. Recommended-prompt mode is on by default, so a prompt is optional. [Routing] Use this model when the user provides a single start frame. Use Vidu Q4 R2V when the user provides reference images and wants a newly composed shot with a chosen aspect ratio.
curl --request POST \
--url https://api.modellix.ai/api/v1/vidu/viduq4-i2v \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"first_frame_image": "https://example.com/start-frame.jpg"
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-vidu-q4-i2v-001",
"model_id": "vidu/viduq4-i2v",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-vidu-q4-i2v-001"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'first_frame_image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Authorizations
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
Vidu Q4 Preview image-to-video request. One start frame. Prompt is optional because recommended-prompt mode defaults to true.
Start-frame image URL. Exactly one image. png, jpeg, jpg, and webp are accepted.
1"https://example.com/start-frame.jpg"
Optional motion description, up to 20000 characters.
1 - 20000"The astronaut waved and the camera moved up."
Use the recommended prompt. Default true. Set false to follow the user prompt only.
true
Video duration in seconds. Default 5. Allowed range: 3-16.
3 <= x <= 165
Video resolution. Default 720p. Allowed values: 540p, 720p, 1080p, 2K, 4K.
540p, 720p, 1080p, 2K, 4K "720p"
Whether to generate audio with the video. Default true. Set false for a silent video.
true
Random seed. Omit or use 0 for a random seed.
1