Create Task
POST
/ent/v2/trending-replicateQuery Creations
GET
/ent/v2/tasks/{id}/creationsOne-click Solutions
Authorizationstring*Replace {your api key} with your token
Token {your api key}video_urlstring*The original video to replicate
Note 1: Supports Base64 encoding or a video URL (must be accessible);
Note 2: Supports 1 video as input;
Note 3: Supports mp4 and mov formats;
Note 4: Video must be between 5 and 180 seconds;
Note 5: Please note that the POST body of an HTTP request must not exceed 20MB, and the encoding must include an appropriate content type string, e.g.:
data:image/png;base64,{base64_encode}
imagesstring*Product images or model images to replicate (optional)
Note 1: Supports Base64 encoding or an image URL (must be accessible);
Note 2: Supports 1~7 images as input;
Note 3: Images support png, jpeg, jpg, webp formats;
Note 4: The image aspect ratio must be less than 1:4 or 4:1;
Note 5: Image size must not exceed 50 MB;
Note 6: Please note that the POST body of an HTTP request must not exceed 20MB, and the encoding must include an appropriate content type string, e.g.:
data:image/png;base64,{base64_encode}
promptstringUser prompt
Text description for the generated video.
Note 1: Must not exceed 2000 characters
aspect_ratiostringOutput aspect ratio, default 16:9
Allowed values: 1:1, 16:9, 9:16, 4:3, 3:4
resolutionstringResolution, default 1080p
Allowed values: 540p, 720p, 1080p
remove_audiobooleanWhether to remove the audio from the original video
true: remove the original video's audio
false: keep the original video's audio
callback_urlstringCallback protocol
You need to actively set callback_url when creating the task; the request method is POST. When the video generation task status changes, Vidu will send a callback request containing the task's latest status to this address. The content structure of the callback request matches the response body of the task query API.
The "status" returned in the callback includes the following states:
Authorizationstring*Replace {your api key} with your token
Token {your api key}idstring*Task ID
curl --request POST \
--url 'https://api.vidu.com/ent/v2/trending-replicate' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"video_url": "your_url",
"images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
],
"prompt": "",
"aspect_ratio": "16:9",
"resolution": "1080p",
"remove_audio": true,
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
"prompt": "",
"aspect_ratio": "16:9",
"resolution": "1080p",
"remove_audio": false,
"credits":credits_number
}curl --request GET \
--url 'https://api.vidu.com/ent/v2/tasks/{your_id}/creations' \
--header 'Authorization: Token {your api key}'{
"id":"your_task_id",
"state": "success",
"err_code": "",
"credits": 400,
"payload":""
"creations": [
{
"id": "your_creations_id",
"url": "your_generated_results_url",
"cover_url": "your_generated_results_cover_url",
"watermarked_url": "your_generated_results_watermarked_url"
}
],
"progress":90
}application/jsonResponse fields
task_idstringThe task ID generated by Vidu for this task
statestringTask status
Allowed values:
created: created successfully
queueing: task is queued
processing: task is being processed
success: task succeeded
failed: task failed
imagesstringImages used in this generated video
promptstringThe prompt entered by the user for this generated video
application/jsonResponse fields
idstringTask ID
statestringProcessing status
Allowed values:
created: created successfully
queueing: task is queued
processing: task is being processed
success: task succeeded
failed: task failed
err_codestringError code, see the error code table for details
creditsintegerNumber of credits consumed by this task, unit: credits
payloadstringPass-through parameter provided when this task was invoked
bgmbooleanWhether BGM was used for this task invocation
off_peakbooleanWhether off-peak mode was used for this task invocation
progressintegerTask generation progress
creationsarrayGeneration results
idstringGeneration ID, used to identify different generated outputs
urlstringURL of the generated output, valid for one hour
cover_urlstringCover image of the generated output, valid for one hour
watermarked_urlstringWatermarked URL of the generated output, valid for one hour
resolutionstringResolution of this generated video
aspect_ratiostringAspect ratio of this generated video
remove_audiostringWhether the original audio was removed for this generated video
creditsintegerNumber of credits consumed by this generated video