创建图片生成任务
POST
/ent/v2/reference2image查询视频生成物
GET
/ent/v2/tasks/{id}/creations接口文档
Content-Typestring*数据交换格式
Application/jsonAuthorizationstring*将 {your api key} 替换为您的 token
Token{your api key}modelstring*模型名称
可选值:viduq2、viduq1viduq2:支持文生图、图片编辑、参考生图viduq1:支持参考生图
imagesstring图像参考
viduq2:支持输入 0~7 张图片
viduq1:支持输入 1~7 张图片
模型将以此参数中传入的图片中的主题为参考,生成与图片中主体一致的视频。
注1:支持传入图片 Base64 编码或图片URL(确保可访问)
注2:图片支持 png、jpeg、jpg、webp格式
注3:图片像素不能小于 128\*128,且比例需要小于1:4或者4:1
注4: 且大小不超过50M
注5:请注意,http请求的post body不超过20MB,且编码必须包含适当的内容类型字符串,base64,{base64_encode}normal
data:image/pngpromptstring*文本提示词
视频生成的文本描述,长度不能超过 2000 个字符
注1:viduq2模型支持文生图,在使用viduq2模型,且没有上传任何images时,模型会使用该参数的文本内容生成图片
seedinteger随机种子参数
当默认不传或者传0时,会使用随机数替代
手动设置则使用设置的种子
aspect_ratiostring比例参数,不同模型支持不同的比例:viduq1:默认值16:9,可选值:16:9、9:16、1:1、3:4、4:3viduq2:默认值16:9,可选值如下:16:9、9:16、1:1、3:4、4:3、21:9、2:3、
resolutionstring分辨率参数,不同模型支持的分辨率不同:viduq1:默认1080p,可选项:1080pviduq2:默认1080p,可选项:1080p、2K、4K
payloadstring透传参数
不做任何处理,仅数据传输
注:最多 1048576个字符
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*idstring*任务id,由创建任务接口创建成功返回
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/reference2image' \
--header 'Content-Type: Application/json' \
--header 'Authorization: Token{your api key}' \
--data '{
"model": "viduq2",
"images": "data:image/png",
"prompt": "your_prompt",
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "2K",
"payload": "",
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"model": "viduq2",
"images": ["your_image_url1","your_image_url2","your_image_url3"],
"prompt": "your_prompt",
"seed": 0,
"aspect_ratio":"16:9",
"resolution":"2K",
"payload": "",
"credits": 12,
"created_at": "2025-08-07T09:53:22.083033428Z"
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json'{
"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"
}
]
}3:2auto:表示与首张输入图保持相同比例application/json返回参数
task_idstringVidu 生成的任务ID
statestring处理状态
可选值:created 创建成功queueing 任务排队中processing 任务处理中success 任务成功failed 任务失败
modelstring本次调用的模型名称
application/json返回参数
idstring任务ID
statestring处理状态
可选值:
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码,具体见错误码表
creditsinteger该任务消耗的积分数量,单位:积分
payloadstring本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id,用来标识不同的生成物
urlstring生成物URL, 24小时有效期
cover_urlstring生成物封面,24小时有效期
watermarked_urlstring带水印的生成物url,24小时有效期
promptstring本次调用的提示词参数
imagesstring本次调用的图像参数
seedinteger本次调用的随机种子参数
aspect_ratiostring本次调用的比例参数
resolutionstring本次调用的分辨率参数
callback_urlstring本次调用时传入的回调参数
payloadstring本次调用时传入的透传参数
creditsinteger本次调用的积分数
created_atstring任务创建时间