MiniMax H3
ID:
hailuo/minimax-h3MiniMax H3(Hailuo 03)是一款统一的多模态视频生成模型,能将文本、图像、视频和音频参考转化为带原生立体声的 2K 高清视频。通过一个 MiniMax H3 API 即可创作原创场景、让静态画面动起来、编辑已有素材。
MiniMax H3Hailuo 03文生视频2K 视频原生音频视频编辑
概览
MiniMax H3(Hailuo 03)是一款统一的多模态视频生成模型,能将文本、图像、视频和音频参考转化为带原生立体声的 2K 高清视频。通过一个 MiniMax H3 API 即可创作原创场景、让静态画面动起来、编辑已有素材。
认证
所有 API 请求需要通过 Authorization 请求头以 Bearer 方式传递有效的 API 密钥。
快速开始
凭证
设置 RUNBASE_API_KEY 环境变量。
Shell
export RUNBASE_API_KEY=your-api-key创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "一张陶瓷台灯的电影级产品照片"
}
}'运行记录
运行以异步方式处理。提交请求后,轮询获取结果。
创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "一张陶瓷台灯的电影级产品照片" }
}'获取运行状态
Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"获取结果
轮询状态接口,直到 status 为 "succeeded",然后从响应中读取 output.urls。
输入 Schema
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 必填 | Prompt最多 7000 个字符 |
| aspect_ratio | string | 可选 | Aspect ratio选项: 16:99:161:14:33:421:9默认值:16:9 |
| resolution | string | 可选 | 2K requires at least one reference image; text-only generation supports 768p only.选项: 768p2k默认值:768p |
| duration | number | 可选 | Duration (seconds)范围:4–15默认值:5 |
| image_urls | string[] | 可选 | Reference images最多 5 张图片 |
输出 Schema
| 字段 | 类型 | 描述 |
|---|---|---|
| urls | string[] | 生成的输出 URL |
错误
API 使用标准 HTTP 状态码表示成功或失败。
| 状态码 | 描述 |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

