AI 生视频V3

请求体

模型参数

原生有声模型无需传 voice 或参考音频 audio 即可生成声音。仅支持声音开关的模型可传 voice；其他模型请省略，不能用 false 请求静音。参考音频是可选素材，支持范围见素材规则。

素材规则

• Seedance 2.0、2.0 Fast、2.0 Mini、2.5、MiniMax H3（minimax-h3-lite）和 WAN3（WAN3）支持文生视频：填写 prompt，不传参考素材。其他模型仍需至少一项参考素材，Vidu Q4 必须传图片。
• 参考素材的类型和数量见模型参数。Seedance 2.0 系列的音频需配图片或视频，Seedance 2.5 支持仅参考音频。
• MiniMax H3 参考音频：audio 需配 1–9 张参考图 imageList，不能只传音频或搭配尾帧。最多 3 段，每段 2–15 秒，合计不超过 15 秒；每段默认不超过 15 MiB，支持 480P / 720P / 768P。
• 视频时长、分辨率和比例见模型参数；MiniMax H3 需填写 resolution。仅传尾帧不属于文生视频。文生视频不支持 videoTime=-1；传入参考视频时才可按模型规则使用。

请求示例

Seedance 文生视频

{
  "videoType": "doubao-seedance-2-0-fast",
  "videoTime": 8,
  "prompt": "镜头缓慢推进，展示海边城市的日出，海面波光粼粼，画面写实自然",
  "resolution": "720P",
  "aspectRatio": "16:9",
  "voice": false
}

同样支持 doubao-seedance-2-0、doubao-seedance-2-0-mini 和 doubao-seedance-2-5，按模型参数选择视频规格。

MiniMax H3 文生视频

{
  "videoType": "minimax-h3-lite",
  "videoTime": 5,
  "prompt": "镜头缓慢推进，展示海边城市的日出，海面波光粼粼，画面写实自然",
  "resolution": "768P",
  "aspectRatio": "16:9"
}

不传任何参考素材，无需传模式字段；默认有声，无需传 voice。时长、分辨率和比例见模型参数。

比例限制：MiniMax H3 纯文生视频必须显式传入固定比例 aspectRatio（如 16:9），不支持自适应比例 adaptive，也不能省略或留空。此限制仅适用于不传任何参考素材的纯文生视频；参考素材生视频仍按模型参数选择比例。

WAN3 文生视频

{
  "videoType": "WAN3",
  "videoTime": 5,
  "prompt": "镜头缓慢推进，展示海边城市的日出，海面波光粼粼，画面写实自然",
  "resolution": "720P",
  "aspectRatio": "16:9"
}

不传任何参考素材，无需传模式字段。时长、分辨率和比例见模型参数。

Seedance 多图参考

{
  "videoType": "doubao-seedance-2-5",
  "videoTime": 10,
  "prompt": "保持商品主体一致，镜头缓慢环绕并展示材质细节",
  "imageList": [
    "https://example.com/product-front.jpg",
    "https://example.com/product-side.jpg"
  ],
  "resolution": "720P",
  "aspectRatio": "16:9",
  "voice": true
}

Vidu Q4 参考图 + 参考音频

{
  "videoType": "viduq4-preview",
  "prompt": "保持商品外观，参考音频节奏展示商品的材质细节",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "audio": [
    "https://example.com/beat.mp3"
  ],
  "videoTime": 5,
  "resolution": "720P",
  "aspectRatio": "9:16",
  "promptOptimizer": false
}

MiniMax H3 参考图 + 参考音频

{
  "videoType": "minimax-h3-lite",
  "prompt": "保持商品外观，参考音频的节奏与声音展示商品细节",
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "audio": [
    "https://example.com/beat.mp3"
  ],
  "videoTime": 5,
  "resolution": "768P",
  "aspectRatio": "9:16"
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

扣费标准

按模型、分辨率和输出时长计算基础扣点；每秒价乘输出时长，按次价或时长档位价直接作为基础点数。WAN3 与 Seedance 系列有参考视频时另加下述费用。

WAN3 参考视频费用：总扣点 = 输出扣点 + 向上取整（参考视频总秒数 × 当前分辨率每秒点数）。参考视频时长支持小数秒；图片、音频不额外收费。

例如：每秒 35 点，生成 5 秒视频，参考视频共 2.41 秒，总计 175 + 85 = 260 点。

Seedance 参考视频费用：适用于 Seedance 2.0、2.0 Fast、2.0 Mini、2.5。总扣点 = 输出扣点 + 向上取整（参考视频真实总秒数 × 当前模型、分辨率的 AI 生视频每秒点数）。输入与输出使用同一有效单价；有团队专属价时按专属价计算。

参考视频真实时长由服务端读取，保留小数秒；多段先合计，只对附加点数向上取整一次。例如，某 Seedance 模型的有效每秒价为 80 点，生成 5 秒视频，参考视频共 2.41 秒，总计 400 + 193 = 593 点。

费用在创建前统一计算并扣除，失败沿用原退款规则。没有参考视频时费用不变；参考图片、音频不新增附加费。