Vidu Q Video Models
Authorizationstring*Token <YOUR_API_KEY>modelstring*viduq4-previewviduq4-preview: Supports generating videos with reference sound; supports intelligent camera switching, achieves superior consistency across multiple camera positions; supports simultaneous audio and video output.viduq4-previewAuthorizationstring*Bearer <YOUR_API_KEY>idstring*Task ID. Returned by the Create Task API upon successful creation.
promptstring*[@subjects_name] to represent subject content. imagesarray*viduq4-preview model supports uploading 1 to 15 images;data:image/png;base64,{base64_encode}soundsarraydata:video/mp3;base64,{base64_encode}audiobooleantrue: Use the audio-video output capability.false: Do not use the audio-video output capability.truetruefalsedurationintegerVideo duration parameter
53 - 16aspect_ratiostringAspect ratio parameter.
16:91:19:1616:93:44:3resolutionstringResolution parameter
720p540p720p1080p2K4Kseedinteger0payloadstringcallback_urlstringapplication/jsonResponse fields
idstringTask ID
statestring*Processing state, accepted values:
created created successfullyqueueing task in queueprocessing processingapplication/jsonResponse fields
task_idstringTask ID generated by Vidu
statestringProcessing state, accepted values:
created created successfullyqueueing task in queueprocessing processingsuccess generation successfulsuccessfailed task failederr_codestringError code, see the error code table for details
creditsintegerThe number of credits consumed by this task
payloadstringThe payload (pass-through) parameter passed in for this task call
creationsarrayGeneration results
idstringGeneration ID, used to identify different creations
urlstringCreation URL, valid for 24 hours
cover_urlstringCreation cover, valid for 24 hours
watermarked_urlstringWatermarked creation URL, valid for 24 hours
failed task failedmodelstringThe model name used for this call
promptstringThe prompt parameter used for this call
imagesstringThe image parameter used for this call
durationintegerThe video duration parameter used for this call
seedintegerThe random seed parameter used for this call
aspect_ratiostringThe aspect ratio parameter used for this call
resolutionstringThe resolution parameter used for this call
payloadstringThe transparent transmission parameter passed in this call
creditsintegerThe credits consumed by this call
created_atstringTask creation time
curl --request POST \
--url 'https://api.vidu.com/ent/v2/reference2video' \
--header 'Authorization: Token <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq4-preview",
"prompt": "string",
"images": [],
"sounds": [],
"audio": true,
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"seed": 0,
"payload": "string",
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq4-preview",
"images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-1.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-2.png","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/reference2video-3.png"],
"sounds":["https://scene-aliyun.vidu.zone/media-asset/022634-H3gq7ivRZgfAYKs3.mp3"],
"prompt": "Santa Claus and the bear hug by the lakeside.",
"duration": 5,
"seed": random_number,
"aspect_ratio": "3:4",
"resolution": "720p",
"credits":credits_number,
"created_at": "2025-01-01T15:41:31.968916Z"
}curl --request GET \
--url 'https://api.vidu.com/ent/v2/tasks/string/creations' \
--header 'Authorization: Bearer <YOUR_API_KEY>'{
"id":"your_task_id",
"state": "success",
"err_code": "",
"credits": 4,
"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"
}
]
}