视频 / MiniMax 海螺
MiniMax-H3-自部署
MiniMax H3（自部署）：文生视频、图生视频、参考图、参考音频。可传 5 张参考图。按秒计费。
分组 #155「【视频】多模型按秒计费」 · Key 需属于该分组
文生视频图生视频参考图参考音频按秒计费
价格—
近 100 次成功率—
平均耗时—
能力与限制
| 时长 | 4–15 s（整数） |
| 分辨率 | 480p / 768 / 1080p / 2K / 4K |
| 画面比例 | 16:9 / 9:16 / 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 21:9 |
| 参考图 | 最多 5 张 |
| 参考视频 | 不支持 |
| 参考音频 | 可传 reference_audios（上游文档最多 3 段） |
| 首尾帧 | 不支持 |
| 生成声音 | 上游未说明 |
| 计费 | 按秒：档位单价 × 秒数 |
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 固定为 MiniMax-H3-自部署 |
prompt | string | 必填 | 画面描述，不能为空 |
duration_seconds | integer | 必填 | 4–15 s（整数）；本站按此计费，必须传 |
resolution | string | 必填 | 480p / 768 / 1080p / 2K / 4K；本站按此计费，必须传 |
aspect_ratio | string | 可选 | 16:9 / 9:16 / 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 21:9 |
referenceImages | array | 可选 | 参考图，最多 5 张，HTTPS 直链；也可写成 media_inputs |
referenceAudios | array | 可选 | 参考音频（可传 reference_audios（上游文档最多 3 段）），HTTPS 直链 |
查询与下载
- 创建任务后拿到
id。 - 每 5–10 秒
GET /v1/videos/{id}；生成和转存期间为pending/in_progress。 delivery_status变成ready后，播放地址在video.url，下载地址在video.download_url，均为本站域名，1 小时有效。- 超时不要重复创建，保留任务 id 继续查询。
注意事项
- 按秒计费：必须传 resolution 和时长，档位不在价格表里会直接返回 400。
- 参考素材必须是公网可访问的 HTTPS 直链，不支持 base64。
- 任务完成后视频链接从转存完成起 1 小时有效，请及时下载保存。
常见错误
| 返回 | 原因与处理 |
|---|---|
400 | 模型、时长或分辨率不在价格表里，按参数表检查 |
429 / 503 | 线路繁忙，稍后重试；不要重复创建同一任务 |
任务 failed | 查看返回的 error 字段；多为内容审核或素材不可访问，未成功的任务不扣费 |