参考⽣视频
创建一个参考⽣视频任务
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
用于生成视频的模型，可选值：
· vidu2.0
· vidu1.5
· vidu1.0
⾸帧图像，模型将以此参数中传⼊的图⽚为⾸帧画⾯来⽣成视频，说明：
（1）⽀持通过 URL 传⼊图⽚。但需要确保URL公⽹可访问，暂不⽀持base 64
（2）图⽚⽀持 png、jpeg、.jpg、webp格式
（3）图⽚⽐例需要⼩于 1:4 或者 4:1
（4）图⽚⼤⼩不超过 10 MB
显示子属性
隐藏子属性
⽂本提⽰词，⽣成视频的⽂本描述，说明：字符⻓度不能超过 1500 个字符
视频时⻓，可选值如下：
· 4：默认 4
· 8
随机种⼦，说明：
（1）当默认不传或者传0时，会使⽤随机数替代
（2）⼿动设置则使⽤设置的种⼦
⽐例，说明：
（1）默认 16:9
（2）可选值如下：
· vidu1.0，可选值： 16:9
· vidu 1.5 和 vidu2.0， 可选值： 16:9 、 9:16 、 1:1
分辨率，说明：
（1）默认 360p
（2）可选值如下：
· vidu1.0可选值：360p
· vidu1.5 和 vidu2.0 4秒的视频可选值：360p、720p、1080p
· vidu1.5 和 vidu2.0 8秒的视频可选值：720p
运动幅度，说明：
（1）供 vidu1.5 和 vidu2.0 模型可⽤
（2）可选值如下：
· auto，默认 auto
· small
· medium
· large
（3）⾼动态性是 vidu 模型的特⾊之⼀，为了更好的服务不同的需
求，我们开放了控制视频动态幅度的参数
Callback 协议，说明：
（1）需要在创建任务时主动设置 callback_url，请求⽅法为POST，当视频⽣成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体⼀致。
（2）回调返回的status状态如下：
· processing：任务处理中
· success：任务完成，如发送失败，回调三次
· failed：任务失败，如发送失败，回调三次
POST /beta/video/generations/vidu/v2/reference2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "vidu2.0",
"images": [
"http://gips***"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"movement_amplitude": "auto"
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/vidu/v2/reference2video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model": "vidu2.0",
"images": [
"http://gips2.baidu.com/it/u=195724436,3554684702&fm=3028&app=3028&f=JPEG&fmt=auto?w=1280&h=960"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"aspect_ratio": "16:9",
"resolution": "720p",
"movement_amplitude": "auto"
}'返回响应
logid
Vidu ⽣成的任务 ID
处理状态，说明：
· created：创建成功
· queueing：任务排队中
· processing：任务处理中
· success：任务成功
· failed：任务失败
本次调⽤的模型名称
本次调⽤的图像参数
显示子属性
隐藏子属性
本次调⽤的提⽰词
本次调⽤的视频时⻓参数
本次调⽤的随机种⼦参数
本次调⽤的分辨率参数
本次调⽤的镜头动态幅度参数
任务创建时间
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"log_id": "as-qc4pngtrzh",
"task_id": "67d29e2986892a72e8aae768",
"status": "created",
"model": "vidu2.0",
"images": [
"http://gips2.baidu.com/it/u=195724436,3554684702&fm=3028&app=3028&f=JPEG&fmt=auto?w=1280&h=960"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"resolution": "720p",
"movement_amplitude": "auto",
"created_at": "2025-03-13T16:58:17.811178Z"
}错误码
如果请求错误，请查看错误码说明。
评价此篇文章