Vidu 参考生视频

根据参考图片和提示词创建视频任务。接口返回 task_id 后，需要再调用查询接口获取生成结果。

接口信息

方法	POST
路径	/ent/v2/reference2video
完整地址	https://api000.com/ent/v2/reference2video

---

请求头

参数	必填	示例
Content-Type	是	application/json
Authorization	是	Bearer sk-xxxxxxxxxxxxxxxx

---

主体参考调用

subjects 用于定义主体图片，prompt 中通过 @主体ID 引用该主体。

{
  "model": "viduq3",
  "subjects": [
    {
      "id": "cat",
      "images": [
        "https://example.com/cat.png"
      ]
    }
  ],
  "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "movement_amplitude": "auto",
  "seed": 785540051
}

请求示例

curl https://api000.com/ent/v2/reference2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "viduq3",
    "subjects": [
      {
        "id": "cat",
        "images": ["https://example.com/cat.png"]
      }
    ],
    "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "movement_amplitude": "auto"
  }'

---

非主体参考调用

不需要在提示词中使用 @主体ID 时，可以直接传 images。

{
  "model": "viduq3-mix",
  "images": [
    "https://example.com/reference.png"
  ],
  "prompt": "一只可爱的猫在草地上奔跑，阳光明媚，画面温馨",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

---

Body 参数

参数	类型	必填	说明
model	string	是	模型名称，例如 viduq3、viduq3-mix
prompt	string	是	视频提示词；主体调用时可使用 @id 引用主体
subjects	array	否	主体参考数组，适用于需要固定角色或物体的任务
subjects[].id	string	否	主体 ID，只能在当前请求内使用
subjects[].images	string[]	否	该主体的参考图片 URL
images	string[]	否	非主体参考图片 URL
duration	integer	否	生成视频时长
resolution	string	否	清晰度：540p、720p、1080p
aspect_ratio	string	否	画面比例，例如 16:9、9:16、1:1
movement_amplitude	string	否	运动幅度，例如 auto、standard
seed	integer	否	随机种子
bgm	boolean	否	是否生成背景音乐
audio	boolean	否	是否生成音频
watermark	boolean	否	是否添加水印
payload	string	否	自定义透传字段
client_request_id	string	否	客户端请求唯一标识

---

成功响应

{
  "task_id": "911084878697623552",
  "type": "character2video",
  "state": "created",
  "model": "viduq3",
  "style": "general",
  "prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",
  "images": [
    "https://example.com/cat.png"
  ],
  "duration": 5,
  "seed": 785540051,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "created_at": "2026-01-20T06:37:57Z",
  "credits": 45,
  "payload": "",
  "off_peak": false,
  "watermark": false
}

拿到 task_id 后，调用 Vidu 查询结果 获取最终视频 URL。