视频生成 API 接口调用文档#

视频分辨率与模型配置参考#

1. 豆包 (Volcano Seedance)#

1.1 文生视频（Text-to-Video）#

1.2 图生视频（首帧图，Image-to-Video）#

图片传参格式（重要）：首帧图通过顶层 image 字段传入，仅支持以下两种格式，不支持纯 base64（必须带 data: 前缀）：

公开可访问的图片 URL（如 https://example.com/first.jpg，无需先上传到火山引擎）

Base64 Data URI（须带前缀，如 data:image/jpeg;base64,/9j/4AAQ...）

查询任务结果#

注：请将 <您的task_id> 替换为创建任务成功后返回的实际 task_id。

1.3 参考图视频（主体参考 / Reference-to-Video）#

参考图（主体参考）需使用支持该能力的模型（如 doubao-seedance-2-0-fast-260128），并通过 metadata.content 传入带 "role": "reference_image" 的图片项；顶层仍需保留 prompt。图片同样支持 URL 或 Base64 Data URI（不支持纯 base64）。

2. 即梦 (Volcano Jimeng)#

创建视频生成任务#

查询任务结果#

3. 可灵 (Kling)#

注意：可灵模型的 duration 参数要求传入字符串 (String) 类型，且画质参数使用 mode (std 或 pro) 控制。

创建视频生成任务#

查询任务结果#

4. 海螺 (Hailuo)#

模型支持模式说明：

模型	文生视频（仅 prompt）	图生视频（带首帧图）
MiniMax-Hailuo-2.3	✅ 支持	✅ 支持
MiniMax-Hailuo-2.3-Fast	❌ 不支持	✅ 支持（必须传首帧图）

图生视频参数：首帧图通过 metadata.first_frame_image 传入，支持两种格式：

图片 URL（如 https://example.com/first.jpg）

Base64 Data URI（如 data:image/jpeg;base64,/9j/4AAQ...）

4.1 文生视频（Text-to-Video）#

注意：MiniMax-Hailuo-2.3-Fast 不支持纯文本生成，纯文本场景请使用 MiniMax-Hailuo-2.3。

4.2 图生视频（Image-to-Video）#

首帧图请放入 metadata.first_frame_image（支持图片 URL 或 Base64 Data URI）。MiniMax-Hailuo-2.3 与 MiniMax-Hailuo-2.3-Fast 均支持。

查询任务结果#

5. Vidu#

创建视频生成任务#

查询任务结果#