视频 / MiniMax 海螺
minimax_h3
4-15秒（默认4秒）；480P/768/1080P/2K/4K（默认768）；9图 / 3视频 / 3音频（合计≤12）；2K/4K需参考素材；按秒。
分组 #155「【视频】多模型按秒计费」 · Key 需属于该分组
文生视频图生视频参考图参考视频参考音频按秒计费
价格—
近 100 次成功率—
平均耗时—
能力与限制
| 时长 | 4–15 s（默认 4 s） |
| 分辨率 | 480p / 768 / 1080p / 2K / 4K |
| 画面比例 | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 |
| 参考图 | 最多 9 张 |
| 参考视频 | 最多 3 段（需逐条声明 referenceVideoDurations；上游按当前分辨率每秒单价另收） |
| 参考音频 | 最多 3 段 |
| 首尾帧 | 不支持 |
| 生成声音 | 上游未说明 |
| 计费 | 按秒：档位单价 × 秒数 |
模型简介与素材限制
根据上游模型广场 2026-10-31 的简介与参数表同步。本站售价见页首实时价格。
| 项目 | 说明 |
|---|---|
| 模型简介 | 4-15秒（默认4秒）；480P/768/1080P/2K/4K（默认768）；9图 / 3视频 / 3音频（合计≤12）；2K/4K需参考素材；按秒。 |
- 参考图片最多 9 张、视频最多 3 段、音频最多 3 段，素材合计不超过 12 个。
- 2K / 4K 必须带参考素材；纯文生请使用较低分辨率。
请求参数
| 字段 | 类型 | 说明 | |
|---|---|---|---|
model | string | 必填 | 固定为 minimax_h3 |
prompt | string | 必填 | 提示词 |
prompt_enhance | boolean | 可选 | 提示词增强 |
duration_seconds | integer | 必填 | 时长（秒）：4–15；上游默认 4；本站计费必填 |
aspect_ratio | string | 可选 | 画面比例：21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16；上游默认 "16:9" |
resolution | string | 必填 | 分辨率：480p / 768 / 1080p / 2K / 4K；上游默认 "768"；本站计费必填 |
referenceImages | array | 可选 | 参考图片，最多 9 项；公网可访问的 HTTPS 直链 |
referenceVideos | array | 可选 | 参考视频，最多 3 项；公网可访问的 HTTPS 直链 |
referenceVideoDurations | array | 可选 | 参考视频时长（秒），最多 3 项；与 referenceVideos 一一对应，单位秒 |
referenceAudios | array | 可选 | 参考音频，最多 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 字段；多为内容审核或素材不可访问，未成功的任务不扣费 |