场景特效模板

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配 Vidu 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

基于预设场景模板生成特效视频。不同模板对应不同的调用参数。

POST https://platform.dataeyes.ai/vidu/ent/v2/template

请求参数

请求头

头部	必填	说明
`Content-Type`	是	`application/json`
`Authorization`	是	`Token {API_KEY}`

请求体

参数	类型	必填	说明
`template`	String	是	场景模板参数。不同模板对应不同的调用参数和效果，具体可通过 Vidu 官方场景示例中心查看。
`images`	Array[String]	是	图像。模型以此图片来生成视频。支持图片 Base64 编码或 URL，支持 png、jpeg、jpg、webp 格式。图片比例需小于 1:4 或 4:1，大小不超过 50 MB。 POST body 不超过 20MB。
`prompt`	String	可选	文本提示词。字符长度不超过 2000 个字符。注：当 template 为 `subject_3`、`pubg_winner_hit` 时，提示词非必传
`seed`	Int	可选	随机种子。不传或传 0 时使用随机数。
`aspect_ratio`	String	可选	宽高比。默认 `16:9`，可选值：`16:9`、`9:16`。不同 template 支持的可选值不同，详见模板说明。
`area`	String	可选	异域公主特效专属参数。仅当 template 为 `exotic_princess` 时可用。默认 `auto`，可选值：`denmark`、`uk`、`africa`、`china`、`mexico`、`switzerland`、`russia`、`italy`、`korea`、`thailand`、`india`、`japan`
`beast`	String	可选	与兽同行特效专属参数。仅当 template 为 `beast_companion` 时可用。默认 `auto`，可选值：`bear`、`tiger`、`elk`、`snake`、`lion`、`wolf`
`bgm`	Bool	可选	是否添加背景音乐。默认 `false`。
`watermark`	Bool	可选	是否添加水印。默认不加。
`wm_position`	Int	可选	水印位置。`1`：左上，`2`：右上，`3`：右下（默认），`4`：左下
`wm_url`	String	可选	自定义水印图片 URL。
`payload`	String	可选	透传参数。最多 1048576 个字符。
`meta_data`	String	可选	元数据标识，JSON 格式字符串，透传字段。
`callback_url`	String	可选	回调地址。

请求示例

响应参数

字段	类型	说明
`task_id`	String	任务 ID
`state`	String	处理状态：`created`、`queueing`、`processing`、`success`、`failed`
`template`	String	本次调用的场景模板参数
`prompt`	String	提示词
`images`	Array[String]	图像参数
`seed`	Int	随机种子
`aspect_ratio`	String	宽高比
`bgm`	Bool	是否添加背景音乐
`payload`	String	透传参数
`watermark`	Bool	是否使用水印
`credits`	Int	消耗的积分数
`created_at`	String	任务创建时间

响应示例

{
  "task_id": "{task_id}",
  "state": "created",
  "template": "hugging",
  "images": ["https://example.com/photo.jpeg"],
  "prompt": "画面中的两个主体转向彼此，并开始拥抱",
  "seed": 123456,
  "payload": "",
  "credits": 8,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

06-场景特效模板

场景特效模板#

请求参数#

请求头#

请求体#

请求示例#

响应参数#

响应示例#

场景特效模板

请求参数

请求头

请求体

请求示例

响应参数

响应示例