Other Generating

POST https://api.vidu.com/ent/v2/multiframe

Field
Value
Description
Content-Type
application/json
Data Exchange Format
Authorization
Token {your api key}
Replace {} with your API key

Field
Sub-Field
Type
Required
Description
model
String
Required
Model name
Accepted values:viduq2-pro viduq2-turbo
start_image
String
Required
The first frame image.
Notes:
1. Supports Base64-encoded image or image URL (must be accessible).
2. Only accepts 1 image
3. Supported formats: png, jpeg, jpg, webp
4. The aspect ratio of the images must be less than 1:4 or 4:1
5. All images are limited to 50MB
6. The post body of the HTTP request should not exceed 20MB, and it must include an appropriate content type string. For instance, 
data:image/png;base64,{base64_encode}
image_settings
Array
Required
Configuration for intelligent multi-frame generation.
Each task supports up to 9 frames, Each task supports at least 2 frames.
prompt
String
Optional
Prompt for extending the previous frame, used to control transition content.
key_image
String
Required
Reference image for each key frame.
The model uses this image as the end frame to generate transitions.
Notes:
1. Supports Base64-encoded image or image URL (must be accessible).
2. Only accepts 1 image
3. Input order defines the timeline (from first frame to last).
4. Supported formats: png, jpeg, jpg, webp
5. The aspect ratio of the images must be less than 1:4 or 4:1
6. All images are limited to 50MB
7. The length of the base64 decode must be under 10MB, and it must include an appropriate content type string. For instance, 
data:image/png;base64,{base64_encode}
duration
Int
Optional
Duration between key frames in seconds.
Default is 5s, valid range is 2–7s.
resolution
String
Optional
Video resolution.
Default is 720p. Available values: 540p, 720p, 1080p.
payload
String
Optional
transparent transmission parameters
No processing, only data transmission，with a maximum length of 1048576 characters
callback_url
String
Optional
Callback
When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API.
The "status" in the callback response includes the following states:
- processing: Task is being processed.
- success: Task is completed (if sending fails, it will retry the callback three times).
- failed: Task failed (if sending fails, it will retry the callback three times).
Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field
Sub-Field
Type
Description
task_id
String
Task ID
state
String
It will be returned to a specific processing state:
- created created task successfully
- queueing task in queue
- processing processing
- success generation successful
- failedtask failed
model
String
The parameter of the model used for this call
image_settings
Array
Multi-frame configuration used in this task
prompt
String
Prompt text used for each frame transition
key_image
String
Key-frame image used for this call.
duration
String
Duration for each frame transition.
resolution
String
The resolution parameter used for this call
payload
String
The payload parameter used for this call
credits
String
The credits used for this call
created_at
String
Task creation time
{
  "task_id": "your_task_id",
  "state": "success",
  "model": "viduq2-turbo",
  "start_image": "your_start_image",
  "image_settings": [
    { 
        "key_image": "your_key_image1", 
        "prompt": "", "duration": 5 
    },
    { 
        "key_image": "your_key_image2", 
        "prompt": "", "duration": 5 
    },
    { 
        "key_image": "your_key_image3", 
        "prompt": "", "duration": 5 
    },
    { 
        "key_image": "your_key_image4", 
        "prompt": "", "duration": 5 
    },
    { 
        "key_image": "your_key_image5", 
        "prompt": "", "duration": 5 
    }
  ],
  "resolution": "1080p",
  "payload": "",
  "credits": 40,
  "created_at": "2025-11-01T03:07:57.538965937Z"
}