Vidu API
Dashboard
Docs
Sign in

Start end to Video

POST https://api.vidu.com/ent/v2/start-end2video

Request Header

FieldValueDescription
Content-Typeapplication/jsonData Exchange Format
AuthorizationToken {your api key}Replace {} with your API key

Request Body

FieldTypeRequiredDescription
modelStringRequiredModel name
Accepted values: viduq1 viduq1-classic vidu2.0 vidu1.5
imagesArray[String]RequiredTwo images: first is start frame, second is end frame.
Notes:
1. Public URL or Base64
2. Aspect ratios must be close: ratio between start/end frame must be in 0.8~1.25
3. Format: png, jpeg, jpg, webp
4. Max size: 50MB
5. 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}
promptStringOptionalPrompt description, max 1500 characters.
durationIntOptionalVideo duration. Default values vary by model:
- viduq1 and viduq1-classic: default 5s, available: 5
- vidu2.0 and vidu1.5: default 4s, available: 4, 8
seedIntOptionalRandom seed
- Defaults to a random seed number
- Manually set values will override the default random seed
resolutionStringOptionalResolution (based on model & duration):
- viduq1 and viduq1-classic(5s): default 1080p, options: 1080p
- vidu2.0 and vidu1.5 (4s): default 360p, options: 360p, 720p, 1080p
- vidu2.0 and vidu1.5 (8s): default 720p, options: 720p
movement_amplitudeStringOptionalThe movement amplitude of objects in the frame
Defaults to auto, accepted value: auto small medium large
bgmboolOptionalWhether to add background music to the generated video.

Default: false. Acceptable values: true, false.

When true, the system will automatically add a suitable BGM.
payloadStringOptionaltransparent transmission parameters
No processing, only data transmission,with a maximum length of 1048576 characters
callback_urlStringOptionalCallback
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
curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
"model": "viduq1",
"images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
"prompt": "The camera zooms in on the bird, which then flies to the right. The bird flight is smooth and natural, with a red light effect following and surrounding it from behind.",
"duration": "5",
"seed": "0",
"resolution": "1080p",
"movement_amplitude": "auto"
}' https://api.vidu.com/ent/v2/start-end2video

Response Body

FieldTypeDescription
task_idStringTask ID
stateStringIt will be returned to a specific processing state:
- created created task successfully
- queueing task in queue
- processing processing
- success generation successful
- failedtask failed
modelStringThe parameter of the model used for this call
imagesArray[String]The image used for this call
promptStringThe text prompt used for this call
durationIntThe video duration parameter used for this call
seedIntThe random seed parameter used for this call
resolutionStringThe resolution parameter used for this call
bgmboolThe bgm parameter used for this call
movement_amplitudeStringThe camera movement amplitude parameter used for this call
payloadStringThe payload parameter used for this call
created_atStringTask creation time
{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq1",
"images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
"prompt": "The camera zooms in on the bird, which then flies to the right. The bird flight is smooth and natural, with a red light effect following and surrounding it from behind.",
"duration": 5,
"seed": random_number,
"resolution": "1080p",
"movement_amplitude": "auto",
"created_at": "2025-01-01T15:41:31.968916Z"
}