🎬 Vidu 系列视频接口

四个模型统一走同一套端点，差异仅体现在各模型支持的分辨率/能力白名单。

接口地址#

提交任务#

POST https://www.moyu.info/v1/video/generations

查询结果#

GET https://www.moyu.info/v1/videos/{task_id}

获取视频内容#

GET https://www.moyu.info/v1/videos/{task_id}/content

模型说明#

可用模型#

注意：分辨率白名单为平台前置校验，传入不在白名单内的值（例如给 viduq1 传 720p、给 viduq3-pro 传 480p）会在提交阶段直接返回参数错误。

生成模式（按 images 数量自动判定）#

也可通过 metadata.action 显式指定动作，覆盖上述自动判定。

⚠️ 关于 viduq3-pro 与参考图：这里的「参考图生视频（Reference-to-Video）」特指传入 ≥3 张图触发的模式。

传 1 张图走的是「图生视频（Image-to-Video）」，viduq3-pro 完全支持（即使这张图是产品参考图）。

只有传 ≥3 张图 时才进入 Reference-to-Video 模式，viduq3-pro 在该模式下会被拦截并返回 viduq3-pro does not support reference-to-video，此时请改用 viduq3-turbo。

请求示例#

1. 文生视频 (Text-to-Video)#

基础示例#

带完整参数的示例#

2. 图生视频 (Image-to-Video)#

3. 首尾帧生视频 (Start-End-to-Video)#

4. 参考图生视频 (Reference-to-Video)#

viduq3-pro 不支持本模式（≥3 张图），请使用 viduq3-turbo、viduq1 或 vidu2.0。若只需用单张参考图驱动，直接传 1 张图走「图生视频」即可，viduq3-pro 支持。

请求参数详解#

核心参数#

size 兼容：若未单独传 resolution / aspect_ratio，平台会尝试从 size 兜底判断——含 :（如 16:9）视为宽高比，其他（如 720p）视为分辨率。

高级参数（放入顶层 metadata 对象透传）#

上表中的参数也可直接放在请求体顶层（如 movement_amplitude、off_peak 等），效果相同；metadata 内的同名值优先级更高。

提交任务响应格式#

成功响应#

{
  "id": "task_xxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxx",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "",
  "progress": 0,
  "created_at": 1770265725
}

响应字段说明#

查询任务结果#

查询请求#

查询响应示例#

任务处理中#

{
  "id": "task_xxxxxxxxxxxx",
  "object": "video",
  "model": "",
  "status": "in_progress",
  "progress": 45,
  "created_at": 1770265725
}

任务成功#

{
  "id": "task_xxxxxxxxxxxx",
  "object": "video",
  "model": "",
  "status": "completed",
  "progress": 100,
  "created_at": 1770265725,
  "completed_at": 1770265850,
  "metadata": {
    "url": "https://example.com/output_video.mp4"
  }
}

任务失败#

{
  "id": "task_xxxxxxxxxxxx",
  "object": "video",
  "model": "",
  "status": "failed",
  "created_at": 1770265725,
  "completed_at": 1770265780,
  "error": {
    "code": "FieldInvalid",
    "message": "FieldInvalid"
  }
}

说明：查询接口返回的 model 字段为空字符串，如需按模型区分请以提交时的 task_id 自行关联。成功时视频地址在 metadata.url（为带签名的临时下载链接，请及时转存）。

状态码说明#

获取视频内容#

方式一：直接使用结果 URL#

方式二：使用内容接口#

最佳实践#

提示词建议#

图片要求#

分辨率选择#

性能优化#

常见问题#

技术支持#