Vidu 首尾帧生视频

提供两张图片，由模型生成从首帧画面自然过渡到尾帧画面的视频。

images 数组中的图片顺序非常重要：

1. 第一张图片是首帧
2. 第二张图片是尾帧

接口信息

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

---

请求头

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

---

请求示例

{
  "model": "viduq3-pro",
  "images": [
    "https://example.com/start-frame.png",
    "https://example.com/end-frame.png"
  ],
  "prompt": "镜头从首帧画面平稳向前移动，产品逐渐旋转并自然过渡到尾帧姿态，保持产品外观、颜色和结构稳定，运动连续流畅，不出现画面闪烁、变形、字幕或水印。",
  "duration": 10,
  "resolution": "1080p",
  "seed": 12345,
  "audio": true,
  "off_peak": false,
  "watermark": false
}

cURL 示例

curl https://api000.com/ent/v2/start-end2video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
  -d '{
    "model": "viduq3-pro",
    "images": [
      "https://example.com/start-frame.png",
      "https://example.com/end-frame.png"
    ],
    "prompt": "镜头平稳运动，画面从首帧自然过渡到尾帧，主体保持一致。",
    "duration": 10,
    "resolution": "1080p",
    "audio": true,
    "off_peak": false,
    "watermark": false
  }'

---

图片要求

项目	要求
图片数量	必须传入两张图片
第一张图片	视频首帧
第二张图片	视频尾帧
图片来源	公网 URL 或 Base64
支持格式	PNG、JPEG、JPG、WebP
单张大小	不超过 50MB
两张图片比例	两张图片的宽高比应尽量一致
比例差异	首尾帧比例比值应处于 0.8–1.25 之间

---

Body 参数

参数	类型	必填	说明
model	string	是	模型名称，例如 viduq3-pro、viduq2-pro
images	string[]	是	两张图片；第一张为首帧，第二张为尾帧
prompt	string	否	描述首尾帧之间的动作、镜头和过渡方式
duration	integer	否	Q3 通常支持 1–16 秒，Q2 通常支持 1–8 秒
resolution	string	否	清晰度，例如 540p、720p、1080p
seed	integer	否	随机种子
movement_amplitude	string	否	运动幅度，例如 auto、small、medium、large
audio	boolean	否	是否生成声音；仅 Q3 模型支持
bgm	boolean	否	是否添加背景音乐；Q3 模型不支持
off_peak	boolean	否	是否使用错峰生成
watermark	boolean	否	是否添加水印
payload	string	否	自定义业务追踪字段
callback_url	string	否	任务状态回调地址

首尾帧的产品、人物、背景和构图差异不要过大，否则容易出现主体变形、突然跳变或过渡不自然。

---

成功响应

{
  "task_id": "911084878697623552",
  "state": "created",
  "model": "viduq3-pro",
  "images": [
    "https://example.com/start-frame.png",
    "https://example.com/end-frame.png"
  ],
  "prompt": "镜头平稳运动，画面从首帧自然过渡到尾帧",
  "duration": 10,
  "resolution": "1080p",
  "audio": true,
  "off_peak": false,
  "created_at": "2026-01-20T06:37:57Z"
}

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