该接口可以通过使用特效模板生成视频。

请求信息

请求 URL

POST /hub/vidu/v2/template

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
template	string	是	模板标识。不同模板对输入图数量、比例和附加参数要求不同
images	string[]	是	输入图片。支持 URL 或 Base64，常见支持格式：png、jpeg、jpg、webp
prompt	string	否	文本提示词，最长 2000 字符。部分模板可不传
seed	int	否	随机种子。传 0 或不传时自动生成
aspect_ratio	string	否	画面比例，默认通常为 16:9。常见值：16:9、9:16
area	string	否	特定模板的区域参数，例如 exotic_princess 可传不同国家或地区值
beast	string	否	特定模板的角色参数，例如 beast_companion 可传 bear、tiger、lion 等
bgm	bool	否	是否添加背景音乐，默认 false
payload	string	否	透传字段，最长 1048576 字符
watermark	bool	否	是否添加水印
wm_position	int	否	水印位置。可选值：1、2、3、4；默认 3
wm_url	string	否	自定义水印图片地址
meta_data	string	否	元数据标识，JSON 字符串，透传使用
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

json{
  "template": "hugging",
  "images": [
    "https://example.com/hug.jpeg"
  ],
  "prompt": "画面中的两个主体转向彼此并开始拥抱。",
  "seed": 0,
  "aspect_ratio": "16:9"
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
template	string	模板标识
prompt	string	提示词
images	string[]	输入图片
seed	int	随机种子
aspect_ratio	string	画面比例
bgm	bool	是否背景音乐
payload	string	透传字段
watermark	bool	是否水印
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567906",
  "state": "created",
  "template": "hugging",
  "prompt": "画面中的两个主体转向彼此并开始拥抱。",
  "images": [
    "https://example.com/hug.jpeg"
  ],
  "seed": 12312312,
  "aspect_ratio": "16:9",
  "bgm": false,
  "payload": "",
  "watermark": false,
  "credits": "10.000000",
  "created_at": "2026-04-16T09:46:00Z"
}

错误码

完整列表请参考客户端 API 错误码。