输入关键词搜索

动作同步

更新时间: 2026/08/27 10:13:38

该接口可以根据参考视频驱动人物图片生成动作同步视频。

请求信息

请求 URL

POST /hub/vidu/v2/image2dance

请求头

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

请求体

字段 类型 必填 说明
image_url string 是 人物图片地址。支持 JPG、JPEG、PNG、BMP、WEBP;宽高通常要求在 200-4096 像素之间,宽高比建议在 1:3 到 3:1 之间,文件不超过 15MB
video_url string 是 动作参考视频地址。支持 MP4、AVI、MOV;时长通常要求 2-30 秒,宽高通常要求在 200-2048 像素之间,文件不超过 200MB
payload string 否 透传字段,最长 1048576 字符
callback_url string 否 任务状态回调地址,具体规范请参考 。

请求示例

httpPOST /hub/vidu/v2/image2dance
Authorization: Bearer sk-xxxxx
Content-Type: application/json; charset=utf-8
json{
  "image_url": "https://example.com/portrait.png",
  "video_url": "https://example.com/dance.mov"
}

响应信息

响应体

字段 类型 说明
task_id string 任务 ID
state string 任务状态。常见值:created、queueing、processing、success、failed
image_url string 输入图片
video_url string 输入视频
payload string 透传字段
credits string 消耗量
created_at string 创建时间

响应示例

json{
  "task_id": "tsk_1234567895",
  "state": "created",
  "image_url": "https://example.com/portrait.png",
  "video_url": "https://example.com/dance.mov",
  "payload": "",
  "credits": "18.000000",
  "created_at": "2026-04-16T09:35:00Z"
}

错误码

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

此文档是否对你有帮助?
有帮助
去反馈
  • 请求信息
  • 请求 URL
  • 请求头
  • 请求体
  • 请求示例
  • 响应信息
  • 响应体
  • 响应示例
  • 错误码