Vidu API
工作台
文档
登录

模板成片

POST https://api.vidu.cn/ent/v2/template-story

请求头

字段描述
Content-Typeapplication/json数据交换格式
AuthorizationToken {your api key}{token} 替换为您的 token

请求体

参数名称类型必填参数描述
storyString模板成片参数
可选值:love_storyworkday_feels
imagesArray[String]图像
模型将以此参数中传入的图片来生成视频。
注1:支持传入图片 Base64 编码或图片URL(确保可访问);
注2:图片支持 png、jpeg、.jpg、webp格式;
注3:目前仅支持上传比例为 9:16 的图片;
注4:图片大小不超过 50 MB;
注5:请注意,base64 decode之后的字节长度需要小于50M,且编码必须包含适当的内容类型字符串,例如:
data:image/png;base64,{base64_encode}
callback_urlString可选Callback 协议
需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态:
- processing 任务处理中
- success 任务完成(如发送失败,回调三次)
- failed 任务失败(如发送失败,回调三次)
curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
"story": "choose_one_accept_value",
"images":["input_your_images"]
}' https://api.vidu.cn/ent/v2/template-story

响应体

字段类型描述
task_idStringVidu 生成的任务ID
stateString处理状态
可选值:
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
storyString本次调用的模板成片参数
imagesArray[String]本次调用的图像参数
created_atString任务创建时间
{
"task_id": "your_task_id_here",
"state": "created",
"story": "your_choose_value",
"images": ["input_your_images"],
"created_at": "2025-01-01T15:41:31.968916Z"
}