Q3 创建任务
POST
/ent/v2/reference2videoQ3 查询生成物
GET
/ent/v2/tasks/{id}/creationsVidu Q-视频模型
创建主体方法：https://platform.vidu.cn/docs/subjects
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}modelstring*模型名称，可选值：viduq3，支持智能切镜，多机位的一致性更出色，支持音画同出
viduq3auto_subjectsAuthorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*任务id，由创建任务接口创建成功返回
创建主体方法：https://platform.vidu.cn/docs/subjects
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}modelstring*模型名称，可选值：viduq3-turbo：支持智能切镜，支持音画同出，生成速度更快，性价比高
viduq3-turboauto_subjectsbooleanAuthorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*任务id，由创建任务接口创建成功返回
创建主体方法：https://platform.vidu.cn/docs/subjects
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}modelstring*模型名称，可选值：viduq3-drama：漫剧行业微调模型，为剧而生！
viduq3-dramaauto_subjectsbooleanAuthorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*任务id，由创建任务接口创建成功返回
falsetruefalsesubjectsarray<object>*namestring*用户指定的主体名称（name），生成时可以通过[@name]的方式使用，例如：[@图1]
promptstring*[@subjects_name] 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"audiobooleantruetruefalsedurationinteger视频时长参数
53 - 16seedinteger随机种子，当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
0aspect_ratiostring16:91:116:99:163:44:3autoresolutionstring视频分辨率参数
720p540p720p1080ppayloadstringwatermarkbooleanwm_positioninteger31234wm_urlstring水印内容，此处为图片URL不传时，使用默认水印：内容由AI生成
meta_datastringcallback_urlstringfalsetruefalsesubjectsarray<object>*namestring*用户指定的主体名称（name），生成时可以通过[@name]的方式使用，例如：[@图1]
promptstring*[@subjects_name] 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"audiobooleantruetruefalsedurationinteger视频时长参数
53 - 16seedinteger随机种子，当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
0aspect_ratiostring16:91:116:99:163:44:3autoresolutionstring视频分辨率参数
720p540p720p1080ppayloadstringwatermarkbooleanwm_positioninteger31234wm_urlstring水印内容，此处为图片URL不传时，使用默认水印：内容由AI生成
meta_datastringcallback_urlstringfalsetruefalsesubjectsarray<object>*namestring*用户指定的主体名称（name），生成时可以通过[@name]的方式使用，例如：[@图1]
promptstring*[@subjects_name] 来表示主体内容，例如："@1 和 @2 在一起吃火锅，并且旁白音说火锅大家都爱吃。"durationinteger视频时长参数
82 - 16seedinteger随机种子，当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
0aspect_ratiostring16:916:99:16autoresolutionstring视频分辨率参数
1080p720p1080paudiobooleantruetruefalsepayloadstringwatermarkbooleanwm_positioninteger31234wm_urlstring水印内容，此处为图片URL不传时，使用默认水印：内容由AI生成
meta_datastringcallback_urlstringimagesdata:image/png;base64,{base64_encode}server_idstringfalseimagesdata:image/png;base64,{base64_encode}server_idstringfalseimagesdata:image/png;base64,{base64_encode}server_idstringfalseapplication/json返回参数
idstring任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中application/json返回参数
idstring任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中application/json返回参数
idstring任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中success 任务成功failed 任务失败err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadstring本次任务调用时传入的透传参数
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstringsuccess 任务成功failed 任务失败err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadstring本次任务调用时传入的透传参数
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstringsuccess 任务成功failed 任务失败err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadstring本次任务调用时传入的透传参数
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstringapplication/json返回参数
task_idstringVidu 生成的任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中application/json返回参数
task_idstringVidu 生成的任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中application/json返回参数
task_idstringVidu 生成的任务ID
statestringcreated 创建成功queueing 任务排队中processing 任务处理中带水印的生成物url，24小时有效期
带水印的生成物url，24小时有效期
带水印的生成物url，24小时有效期
success 任务成功failed 任务失败modelstring本次调用的模型名称
promptstring本次调用的提示词参数
imagesarray本次调用的图像参数
durationinteger本次调用的视频时长参数
seedinteger本次调用的随机种子参数
aspect_ratiostring本次调用的 比例 参数
resolutionstring本次调用的分辨率参数
bgmboolean本次调用的背景音乐参数
payloadstring本次调用时传入的透传参数
off_peakboolean本次调用时是否使用错峰模式
creditsinteger本次调用使用的积分数
watermarkboolean本次提交任务是否使用水印
created_atstring任务创建时间
success 任务成功failed 任务失败modelstring本次调用的模型名称
imagesarray本次调用的图像参数
promptstring本次调用的提示词参数
durationinteger本次调用的视频时长参数
seedinteger本次调用的随机种子参数
aspect_ratiostring本次调用的 比例 参数
resolutionstring本次调用的分辨率参数
bgmboolean本次调用的背景音乐参数
payloadstring本次调用时传入的透传参数
off_peakboolean本次调用时是否使用错峰模式
creditsinteger本次调用使用的积分数
watermarkboolean本次提交任务是否使用水印
created_atstring任务创建时间
success 任务成功failed 任务失败modelstring本次调用的模型名称
imagesarray本次调用的图像参数
promptstring本次调用的提示词参数
durationinteger本次调用的视频时长参数
seedinteger本次调用的随机种子参数
aspect_ratiostring本次调用的 比例 参数
resolutionstring本次调用的分辨率参数
payloadstring本次调用时传入的透传参数
off_peakboolean本次调用时是否使用错峰模式
creditsinteger本次调用使用的积分数
watermarkboolean本次提交任务是否使用水印
created_atstring任务创建时间
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/reference2video' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq3",
"auto_subjects": false,
"subjects": [
{
"name": "1",
"images": [
"your_image1",
"your_image2"
],
"voice_id": "string",
"server_id": "string"
}
],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"audio": true,
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"payload": "string",
"off_peak": false,
"watermark": true,
"wm_position": 3,
"wm_url": "string",
"meta_data": "string",
"callback_url": "string"
}' {
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3",
"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"],
"prompt": "Santa Claus and the bear hug by the lakeside.",
"duration": 5,
"seed": random_number,
"aspect_ratio": "3:4",
"resolution": "540p",
"payload":"",
"off_peak": false,
"credits":credits_number,
"created_at": "2025-01-01T15:41:31.968916Z"
}
{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3",
"images": [""],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"duration": 5,
"seed": random_number,
"aspect_ratio": "3:4",
"resolution": "720p",
"audio": true,
"payload":"",
"off_peak": false,
"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"
}
]
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/reference2video' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq3-turbo",
"auto_subjects": false,
"subjects": [
{
"name": "1",
"images": [
"your_image1",
"your_image2"
],
"voice_id": "string",
"server_id": "string"
}
],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"audio": true,
"duration": 5,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"payload": "string",
"off_peak": false,
"watermark": true,
"wm_position": 3,
"wm_url": "string",
"meta_data": "string",
"callback_url": "string"
}'
{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3",
"images": [""],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"duration": 5,
"seed": random_number,
"aspect_ratio": "3:4",
"resolution": "720p",
"audio": true,
"payload":"",
"off_peak": false,
"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"
}
]
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/reference2video' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "viduq3-drama",
"auto_subjects": false,
"subjects": [
{
"name": "1",
"images": [
"your_image1",
"your_image2"
],
"voice_id": "string",
"server_id": "string"
}
],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"duration": 8,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "1080p",
"audio": true,
"payload": "string",
"off_peak": false,
"watermark": true,
"wm_position": 3,
"wm_url": "string",
"meta_data": "string",
"callback_url": "string"
}' {
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq3-drama",
"images": [""],
"prompt": "[@1]和[@2]在[@3]一起吃火锅",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p",
"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"
}
]
}