场景Template ⽣视频
创建一个场景⽣视频任务。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
AI 模版参数,⽤来指定特定场景,可选值如下:
· dreamy_wedding
· romantic_lift
· sweet_proposal
· couple_arrival
· cupid_arrow
· lunar_newyear
· pet_lovers
· hug
· kiss
· dynasty_dress
· wish_sender
· love_pose
· hair_swap
· youth_rewind
· morphlab
· live_photo
· emotionlab
· live_memory
· interaction
· christmas
⾸帧图像,模型将以此参数中传⼊的图⽚为⾸帧画⾯来⽣成视频,说明:
(1)⽀持通过 URL 传⼊图⽚。但需要确保URL公⽹可访问,暂不⽀持base 64
(2)图⽚⽀持 png、jpeg、.jpg、webp格式
(3)图⽚⽐例需要⼩于 1:4 或者 4:1
(4)图⽚⼤⼩不超过 10 MB
显示子属性
隐藏子属性
随机种⼦,说明:
(1)当默认不传或者传0时,会使⽤随机数替代
(2)⼿动设置则使⽤设置的种⼦
Callback 协议,说明:
(1)需要在创建任务时主动设置 callback_url,请求⽅法为POST,当视频⽣成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体⼀致。
(2)回调返回的status状态如下:
· processing:任务处理中
· success:任务完成,如发送失败,回调三次
· failed:任务失败,如发送失败,回调三次
POST /beta/video/generations/vidu/v2/template2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"template": "hug",
"images": [
"http://gips2***"
],
"prompt": "hug",
"seed": 0
}
示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/vidu/v2/template2video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"template": "hug",
"images": [
"http://gips2***"
],
"prompt": "hug",
"seed": 0
}'
返回响应
logid
Vidu ⽣成的任务 ID
处理状态,说明:
· created:创建成功
· queueing:任务排队中
· processing:任务处理中
· success:任务成功
· failed:任务失败
本次调⽤的场景参数
本次调⽤的⻛格参数
本次调⽤的提⽰词
本次调⽤的图像参数
本次调⽤的随机种⼦参数
任务创建时间
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
"log_id": "as-6f9f69q81p",
"id": "67d2af5686892a72e8aae771",
"status": "success",
"err_code": "",
"creations": [
{
"id": "",
"url": "http://bj.bcebos.com/qianfan-modelbuilder/dev/4121fcd138434a1580eeb0b675450b91/4121fcd138434a1580eeb0b675450b91/67d2af5686892a72e8aae771/video-j2qp2sv88y5fv6a71q51xcgg.mp4?authorization=bce-auth-v1%2F50c8bb753dcb4e1d8646bb1ffefd3503%2F2025-03-14T03%3A13%3A59Z%2F86400%2F%2F4bf9409edf279062fc467130e40d7923dce6ad693fcb15675a565fe6fa927fd9",
"cover_url": "http://bj.bcebos.com/qianfan-modelbuilder/dev/4121fcd138434a1580eeb0b675450b91/4121fcd138434a1580eeb0b675450b91/67d2af5686892a72e8aae771/image-zgv1cblijfzw5vzjcf0g5rgi.jpeg?authorization=bce-auth-v1%2F50c8bb753dcb4e1d8646bb1ffefd3503%2F2025-03-14T03%3A13%3A59Z%2F86400%2F%2Faf126e1cb4f5d6ad16cc7f48f3fd2a3c019fb1350ce1b49be60f44b17c2df356"
}
]
}
错误码
如果请求错误,请查看错误码说明。
评价此篇文章
