创建任务
POST
/ent/v2/reference2video查询生成物
GET
/ent/v2/tasks/{id}/creationsVidu Q-视频模型
Authorizationstring*将 {your api key} 替换为您的 token
Token <YOUR_API_KEY>modelstring*viduq4-previewviduq4-preview:Vidu最新旗舰模型(预览版),支持参考 1 - 15 张图片,支持参考 0-3 个音频 !Authorizationstring*将 {your api key} 替换为您的 token
Token <YOUR_API_KEY>idstring*viduq4-previewviduq4-previewpromptstring*imagesarray*viduq4-preview 模型支持上传 1~15 张图片;data:image/png;base64,{base64_encode}["reference_image_url1","reference_image_url2","reference_image_url3"]soundsarraydata:video/mp3;base64,{base64_encode}["reference_sound_url1","reference_sound_url2","reference_sound_url3"]audiobooleantruetruefalsetruedurationinteger视频时长参数
53 - 165aspect_ratiostring视频比例参数
16:91:19:1616:93:44:316:9resolutionstring视频分辨率参数
720p540p720p1080p2K4K720pseedinteger随机种子当默认不传或者传0时,会使用随机数替代手动设置则使用设置的种子
00payloadstringwatermarkbooleanwm_positioninteger31234wm_urlstring水印内容,此处为图片URL不传时,使用默认水印:内容由AI生成
meta_datastringcallback_urlstringapplication/json返回参数
idstring任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中application/json返回参数
task_idstringVidu 生成的任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中success 任务成功failed 任务失败err_codestring错误码,具体见错误码表
creditsinteger该任务消耗的积分数量,单位:积分
payloadstring本次任务调用时传入的透传参数
creationsarray生成物结果
idstring生成物id,用来标识不同的生成物
urlstring生成物URL, 24小时有效期
cover_urlstring生成物封面,24小时有效期
watermarked_urlstringsuccess 任务成功failed 任务失败modelstring本次调用的模型名称
promptstring本次调用的提示词参数
imagesstring本次调用的图像参数
soundsstring本次调用的声音参数
durationinteger本次调用的视频时长参数
seedinteger本次调用的随机种子参数
resolutionstring本次调用的分辨率参数
payloadstring本次调用时传入的透传参数
creditsinteger本次调用使用的积分数
watermarkboolean本次提交任务是否使用水印
created_atstring任务创建时间
带水印的生成物url,24小时有效期
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/reference2video' \
--header 'Authorization: Token <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq4-preview",
"prompt": "在参考图1的场景中,参考图2使用参考音频1,对参考图3说:“你在干什么?”,参考图3激动地说:“q4大卖!!!”",
"images": [
"reference_image_url1",
"reference_image_url2",
"reference_image_url3"
],
"sounds": [
"reference_sound_url1",
"reference_sound_url2",
"reference_sound_url3"
],
"audio": true,
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"seed": 0,
"payload": "string",
"watermark": true,
"wm_position": 3,
"wm_url": "string",
"meta_data": "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/image2video.png"],
"prompt": "The astronaut waved and the camera moved up.",
"duration": 5,
"seed": random_number,
"resolution": "1080p",
"payload":"",
"credits":credits_number,
"created_at": "2025-01-01T15:41:31.968916Z"
}curl --request GET \
--url 'https://api.vidu.cn/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"
}
]
}