Skip to main content
POST
  • 只做参考图生视频:至少一张参考图,可以再配参考音频。不支持文生视频、首尾帧和参考视频。
  • 分辨率 480P / 768P,时长 1~15 秒。输出默认带音轨。
  • 异步接口:提交后立即返回任务 id,再调用 查询视频任务 获取结果。
  • 按时长和分辨率计费,见 模型价格。任务失败自动退款。

模型

可用模型以 模型广场 为准。

生成模式

鉴权

string
必填
Bearer <API Key>。在 API 密钥 页面创建。

基础参数

string
必填
固定为 MiniMax-H3-Comfy。
string
必填
视频描述,不能为空,最长 7000 字符。
integer
必填
视频时长(秒):1~15 的整数。
string
默认值:"768P"
分辨率:480P 或 768P,大小写均可。不支持 2K。
string
默认值:"9:16"
宽高比:16:9、9:16、1:1。
不传或传入其他取值时按竖屏 9:16 生成。需要横屏时请显式传 16:9。
integer
随机种子。

素材参数

所有素材都需要是公网可访问的 HTTP(S) URL。请求体总大小不超过 64 MB,请使用 URL,不要传 base64。
string[]
必填
参考图 URL 数组,至少 1 张,最多 9 张。超出 9 张的部分会被忽略。
string[]
参考音频 URL 数组,最多 3 条,超出部分会被忽略。必须与至少一张参考图一起使用。
本模型只接受参考图和参考音频。first_frame_image、last_frame_image、image_with_roles、video_urls 等字段不会传给上游,传入后会被忽略。

素材要求

参数约束

参数由上游校验。提交接口会先返回 queued 任务,不满足以下约束时任务随后变为 FAILURE,原因见 fail_reason,费用自动退回: 请求体不是合法 JSON 或缺少 model 时,提交接口直接返回 400,不创建任务、不扣费。HTTP 状态码含义见 错误码。

提交响应

返回 object 为 video、status 为 queued 的任务对象,字段说明见 Seedance 2.0。用其中的 id 调用 查询视频任务。

查询结果

任务成功后,视频链接在 data.result.videos[0].url[0]:
视频链接约 24 小时后过期(见 expires_at),请及时下载转存。建议每 10 秒左右查询一次。

使用示例

仅参考图

多张参考图

参考图与参考音频