Other Generating

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

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

Field
Type
Required
Description
model
String
Required
Model name
Accepted values:viduq2-pro viduq2-turbo
video_creation_id
String
Optional
Vidu video_creation_id，required with video_url
video_url
String
Optional
Any video URL, required with video_creation_id
- The video's duration cannot be less than 4 seconds and cannot exceed 1 minute
images
Array[String]
Optional
Extended reference image to the end frame
The model will use the image passed in this parameter as the final frame to extend the video.
- Only accepts 1 image
- Accepts public URL or Base64 format.
- Supported formats: png, jpeg, jpg, webp
- The aspect ratio of the images must be less than 1:4 or 4:1
- All images are limited to 50MB
- 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}
prompt
String
Optional
Text prompt
A textual description for video generation, with a maximum length of 2000 characters
duration
Int
Optional
Extended duration, default 5 seconds, selectable from 1 to 7 s
resolution
String
Optional
Resolution :
viduq2-pro&viduq2-turbo: default 720p, options: 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
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
video_creation_id
String
The original vidu video used for this call
video_url
String
The video URL used for this call
images
Array[String]
The images used for this call
prompt
String
The text prompt used for this call
duration
Int
The video duration parameter used for this call
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": "created",
    "model": "viduq2-turbo",
    "video_url": "your_video_url",
    "prompt": "your_prompt",
    "duration": 7,
    "resolution": "720p",
    "credits": 6,
    "created_at": "2025-08-29T06:48:29.368745805Z",
    "payload": "",
    "watermark": false
}