07-模板成片
模板成片
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配 Vidu 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
POST https://platform.shuyanai.com/vidu/ent/v2/template-story请求参数
请求头
| 头部 | 必填 | 说明 |
|---|---|---|
Content-Type | 是 | application/json |
Authorization | 是 | Bearer {API_KEY} |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
story | String | 是 | 模板成片参数。可选值：love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot |
images | Array[String] | 是 | 图像。模型以此图片来生成视频。 支持图片 Base64 编码或 URL，支持 png、jpeg、jpg、webp 格式。 图片大小不超过 50 MB，POST body 不超过 20MB。 注： one_shot 视频比例与输入首图的比例相同 |
payload | String | 可选 | 透传参数。最多 1048576 个字符。 |
callback_url | String | 可选 | 回调地址。 |
请求示例
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
task_id | String | 任务 ID |
state | String | 处理状态：created、queueing、processing、success、failed |
story | String | 本次调用的模板成片参数 |
images | Array[String] | 图像参数 |
payload | String | 透传参数 |
credits | Int | 消耗的积分数 |
created_at | String | 任务创建时间 |
响应示例
{
"task_id": "{task_id}",
"state": "created",
"story": "love_story",
"images": ["https://example.com/photo.png"],
"payload": "",
"credits": 20,
"created_at": "2025-01-01T15:41:31.968916Z"
}