⾸尾帧⽣视频
创建一个⾸尾帧⽣视频任务。
权限说明
调用本文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)默认 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/startend2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "vidu2.0",
"images": [
"http://gips2***",
"https://img***"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"resolution": "720p",
"movement_amplitude": "auto"
}
示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/vidu/v2/startend2video' \
--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",
"https://img2.baidu.com/it/u=4204592546,1638739301&fm=253&fmt=auto&app=138&f=JPEG?w=664&h=500"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"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-***xzt7",
"task_id": "67d2a3d***e76b",
"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",
"https://img2.baidu.com/it/u=4204592546,1638739301&fm=253&fmt=auto&app=138&f=JPEG?w=664&h=500"
],
"prompt": "小狗起飞",
"duration": 4,
"seed": 0,
"resolution": "720p",
"movement_amplitude": "auto",
"created_at": "2025-03-13T17:22:39.84006Z"
}
错误码
如果请求错误,请查看错误码说明。
评价此篇文章
