MiniMax H3 Max
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型名称 | minimax-h3-max |
|---|---|
| 类型 | 文生视频、图生视频 |
| 接口 | POST /v1/tasks |
| 价格 | 查看实时价格 |
根据文字描述生成视频，也可以用图片指定视频的开始或结束画面。支持 480P、768P 分辨率和 5–15 秒视频。
生产建议
生产环境建议
- 使用 callback.url 接收任务终态通知，并按 taskId 去重处理。
- 等待中的任务继续查询；避免重复提交同一个生成请求。
适用场景
用文字生成视频
描述场景、动作和镜头，让模型生成一段视频。
让图片动起来
将图片设为视频的开始画面，用提示词描述人物动作或镜头变化；也可以指定结束画面。
请求参数
model string 必填 固定填 minimax-h3-max。
input object 必填 视频生成参数。
prompt string 必填 描述视频中的场景、人物动作、镜头运动和声音，最多 7,000 个字符。
duration integer 可选 生成视频的时长，支持 5–15 秒，按整秒设置。
resolution enum 可选 生成视频的分辨率。
aspect_ratio enum 可选 生成视频的宽高比。传入首帧或尾帧图片时，宽高比由图片决定。
first_frame_image string 可选 传入图片，用作视频的首帧。
last_frame_image string 可选 传入图片，用作视频的尾帧。
callback object 可选 任务结束后接收通知的回调配置。
url string 必填 接收任务通知的 HTTPS 地址。
when enum 可选 任务进入终态时触发通知。
用例示例
文生视频
用提示词描述纸船在雨后水面漂动的场景，生成一段横屏短片。
请求体
{
"model": "minimax-h3-max",
"input": {
"prompt": "After a morning rain, a red paper boat drifts through shallow water beneath a stone bridge. A low camera tracks smoothly beside it, small ripples spread across the water, and birds sing softly in the distance. No text or subtitles.",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9"
}
}用图片指定结束画面
传入尾帧图片链接，让镜头在指定画面结束。
请求体
{
"model": "minimax-h3-max",
"input": {
"prompt": "镜头缓缓推进，最后停留在尾帧的构图。",
"duration": 5,
"resolution": "768P",
"last_frame_image": "https://example.com/end.jpg"
}
}获取结果
- 使用 Authorization: Bearer YOUR_HIAPI_API_KEY 认证，提交后保存返回的 taskId。
- 通过 GET /v1/tasks/{taskId} 查询，或用 callback.url 接收任务终态通知。
- 排队或生成中继续查询，不重复提交；成功后从 output[].url 读取视频地址。
- 失败时根据返回的错误信息处理；回调接收端应按 taskId 去重。
常见问题
怎样生成横屏或竖屏视频？
只用文字生成时，通过 aspect_ratio 选择比例，例如 16:9 为横屏、9:16 为竖屏。使用首帧或尾帧时，请准备所需比例的图片，视频比例由图片决定。
支持参考视频、参考音频或其他控制参数吗？
此接口不接受参考视频、参考音频、mode、watermark 或 seed。请按参数表提供字段。