MiniMax H3
MiniMax H3 在共用 AI 视频生成接口上的专属模型、限制与计费。
MiniMax H3 走共用的视频生成接口。接口本身、调用流程、输入内容、轮询、任务列表和错误码请看 AI 视频总览，本页只讲 MiniMax H3 的专属部分。
模型
| 模型 | 适用场景 | 限流 |
|---|---|---|
MiniMax-H3 | 原生带音轨的片段，支持单独尾帧与参考音频 | 5 RPM |
在 POST /v1/video-generation/generate 的 model 字段里传模型名。字面量区分大小写：MiniMax-H3。
限制
| 限制项 | MiniMax H3 |
|---|---|
| 分辨率 | 768p、2k |
| 时长 | 4-15 秒，只接受整数秒 |
| 宽高比 | 16:9、4:3、1:1、3:4、9:16、21:9 |
| 提示词长度 | 最多 2500 字符，必填 |
| 参考图 | 单次最多 5 张 |
| 参考视频 | 单次最多 3 个 |
| 参考音频 | 单次最多 3 个 |
inputVideoDuration | 2-15 秒，带参考视频时必填 |
768p 按短边 768 像素出片——16:9 下为 1344×768；2k 按长边 2560 像素出片。这两档是 MiniMax H3 独有的：共用接口上的其他模型都不接受，MiniMax H3 也不接受 480p、720p、1080p。
MiniMax H3 支持 first_frame、last_frame，两者也可以同时给。它是这个接口上唯一允许单独传尾帧的模型——其他模型的尾帧必须和首帧一起给，所以「落在这一画面上」的需求在这里不用再凑一张首帧。帧角色与参考角色（reference_image、reference_video、reference_audio）不能在同一次请求里混用。
图生视频时，上游按输入图推导画幅，ratio 会被接受但忽略。想控制构图请裁剪输入图，而不是改这个参数。
MiniMax H3 只接受 768p 和 2k——传 480p、720p、1080p 会返回
400，其他模型也都不接受 768p 和 2k。时长范围是 4-15 秒。4:5、5:4
会被拒绝，图生视频下 ratio 更是整个被忽略。seed 和 generateAudio
为兼容保留但不起作用：生成结果不按 seed 复现，输出也一定带音轨。参考图单次上限是
5 张，不是共用接口在别处允许的 9 张。
计费
积分随分辨率和时长增长。总额向上取整到整数积分。
| 分辨率 | 积分 / 秒 | 4 秒 | 10 秒 | 15 秒 |
|---|---|---|---|---|
768p | 9.3075 | 38 | 94 | 140 |
2k | 15.1247 | 61 | 152 | 227 |
生成前想拿准确数字，用 MiniMax H3 的 model、resolution、duration 调 POST /v1/video-generation/estimate-credits。积分在任务创建时扣除，失败自动退回。
示例
curl -X POST "https://api.marswave.ai/openapi/v1/video-generation/generate" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MiniMax-H3",
"content": [
{ "type": "text", "text": "The camera pushes in slowly as the city lights come up" },
{ "type": "image_url", "role": "first_frame", "image_url": { "url": "https://example.com/open.jpg" } },
{ "type": "image_url", "role": "last_frame", "image_url": { "url": "https://example.com/close.jpg" } }
],
"resolution": "768p",
"ratio": "16:9",
"duration": 8
}'完整参数列表，以及文生视频、图生视频的请求结构，见 AI 视频总览。