该接口可以通过首帧和多组关键帧配置生成多帧视频。

请求信息

请求 URL

POST /hub/vidu/v2/multiframe

请求头

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

请求体

字段	类型	必填	说明
model	string	是	模型名称。常见可选值：viduq2-turbo、viduq2-pro
start_image	string	是	首帧图片。支持 URL 或 Base64；通常仅支持 1 张，body 建议不超过 10MB
- image_settings	object[]	是	关键帧配置，最少 2 组，最多 9 组
prompt	string	否	当前关键帧延长提示词
key_image	string	是	当前关键帧图片。输入顺序即时间顺序
duration	int	否	当前关键帧时长，默认通常为 5 秒，常见可选范围：2-7 秒
resolution	string	否	输出分辨率，默认通常为 720p。常见可选值：540p、720p、1080p
watermark	bool	否	是否添加水印
wm_url	string	否	自定义水印图片地址
wm_position	string	否	水印位置。常见值：top_left、top_right、bottom_right、bottom_left
meta_data	string	否	元数据标识，JSON 字符串，透传使用
payload	string	否	透传字段，最长 1048576 字符
callback_url	string	否	任务状态回调地址，具体规范请参考 。

请求示例

json{
  "model": "viduq2-turbo",
  "start_image": "https://example.com/start.png",
  "image_settings": [
    {
      "prompt": "人物起身向前走",
      "key_image": "https://example.com/frame-1.png",
      "duration": 5
    },
    {
      "prompt": "人物回头看向镜头",
      "key_image": "https://example.com/frame-2.png",
      "duration": 5
    }
  ],
  "resolution": "1080p"
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：created、queueing、processing、success、failed
model	string	模型名称
start_image	string	首帧图片
image_settings	object[]	关键帧配置
resolution	string	分辨率
watermark	bool	是否水印
wm_url	string	水印内容
wm_position	string	水印位置
meta_data	string	元数据标识
payload	string	透传字段
credits	string	消耗量
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567899",
  "state": "created",
  "model": "viduq2-turbo",
  "start_image": "https://example.com/start.png",
  "image_settings": [
    {
      "prompt": "人物起身向前走",
      "key_image": "https://example.com/frame-1.png",
      "duration": 5
    },
    {
      "prompt": "人物回头看向镜头",
      "key_image": "https://example.com/frame-2.png",
      "duration": 5
    }
  ],
  "resolution": "1080p",
  "watermark": false,
  "wm_url": "",
  "wm_position": "bottom_left",
  "meta_data": "",
  "payload": "",
  "credits": "40.000000",
  "created_at": "2026-04-16T09:39:00Z"
}

错误码

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