该接口可以根据首帧和尾帧图片生成视频。

请求信息

请求 URL

POST /hub/vidu/v2/start-end2video

请求头

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

请求体

字段	类型	必填	说明
model	string	是	模型名称。常见可选值：viduq3-turbo、viduq3-pro、viduq2-pro-fast、viduq2-pro、viduq2-turbo、viduq1、viduq1-classic、vidu2.0
images	string[]	是	输入 2 张图，第一张为首帧，第二张为尾帧。两张图分辨率应尽量接近，比例建议在 1:4 到 4:1 之间
prompt	string	否	文本提示词，最长 5000 字符。若 is_rec=true，模型通常忽略该字段
is_rec	bool	否	是否启用推荐提示词。true 时由系统自动推荐 1 条提示词生成
duration	int	否	视频时长。viduq3 系列默认 5 秒，可选 1-16；viduq2 系列默认 5 秒，可选 1-8；vidu2.0 常见可选 4、8
seed	int	否	随机种子。传 0 或不传时自动生成
resolution	string	否	输出分辨率。默认值与模型和时长有关，常见可选值：360p、540p、720p、1080p
movement_amplitude	string	否	运动幅度，默认 auto。可选值：auto、small、medium、large
audio	bool	否	是否启用音视频直出。仅部分模型支持
bgm	bool	否	是否添加背景音乐，默认 false
payload	string	否	透传字段，最长 1048576 字符
off_peak	bool	否	是否启用错峰模式，默认 false
watermark	bool	否	是否添加水印
wm_position	int	否	水印位置。可选值：1、2、3、4；默认 3
wm_url	string	否	自定义水印图片地址
meta_data	string	否	元数据标识，JSON 字符串，透传使用
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

httpPOST /hub/vidu/v2/start-end2video
Authorization: Bearer sk-xxxxx
Content-Type: application/json; charset=utf-8

json{
  "model": "viduq3-pro",
  "images": [
    "https://example.com/start.jpeg",
    "https://example.com/end.jpeg"
  ],
  "prompt": "小鸟从枝头振翅起飞，带着红色流光飞向右上方。",
  "duration": 5,
  "seed": 0,
  "resolution": "1080p",
  "audio": true,
  "off_peak": false
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
model	string	模型名称
images	string[]	输入图片
prompt	string	提示词
duration	int	视频时长
seed	int	随机种子
resolution	string	分辨率
audio	bool	是否音视频直出
bgm	bool	是否背景音乐
payload	string	透传字段
off_peak	bool	是否错峰
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567892",
  "state": "created",
  "model": "viduq3-pro",
  "images": [
    "https://example.com/start.jpeg",
    "https://example.com/end.jpeg"
  ],
  "prompt": "小鸟从枝头振翅起飞，带着红色流光飞向右上方。",
  "duration": 5,
  "seed": 9876543,
  "resolution": "1080p",
  "audio": true,
  "bgm": false,
  "payload": "",
  "off_peak": false,
  "credits": "15.000000",
  "created_at": "2026-04-16T09:32:00Z"
}

错误码

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