Vidu Q Video Models
Authorizationstring*Replace {your api key} with your API key
Token {your api key}modelstring*viduq4-previewviduq4-preview: Supports audio-video synchronization, supports automatic camera switchingviduq4-previewAuthorizationstring*Replace {your api key} with your API key
Token {your api key}idstring*Task ID, returned by the Create Task API upon successful creation
imagesstring*data:image/png;base64,{base64_encode}promptstringis_recbooleantrue: System will automatically recommend a prompt and use its content to generate the video. false: The video will be generated based on user input prompt.truetruefalsedurationintegerVideo duration.
53 - 16resolutionstringVideo Resolution.
720p540p720p1080p2K4Kaudiobooleanfalse: No direct audio-video generation, outputs silent videotrue: Direct audio-video generation required, outputs video with sound (including dialogue and sound effects)truetruefalseseedinteger0payloadstringcallback_urlstringcallback_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.application/jsonResponse fields
idstringTask ID
statestringProcessing state, accepted values:
created created successfullyqueueing task in queueprocessing processingsuccess generation successfulapplication/jsonResponse fields
task_idstringTask ID generated by Vidu
statestringProcessing state, accepted values:
created created successfullyqueueing task in queueprocessing processingfailed task failederr_codestringError code, see the error code table for details
creditsintegerThe number of credits consumed by this task (unit: credits)
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
successfailed 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
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/img2video' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq4-preview",
"images": [
"https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
],
"prompt": "The astronaut waved and the camera moved up.",
"is_rec": true,
"duration": 5,
"resolution": "720p",
"audio": true,
"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"],
"prompt": "Santa Claus and the bear hug by the lakeside.",
"duration": 5,
"seed": random_number,
"resolution": "720p",
"credits":credits_number,
"created_at": "2025-01-01T15:41:31.968916Z"
}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": 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"
}
]
}