MiniMax H3 MAX
MiniMax H3 MAX 是 MiniMax（海螺 Hailuo 视频引擎团队）推出的经济快速版视频生成模型，支持文生视频、首帧生视频与首尾帧生视频三种模式，可直出 768P 高清视频。模型通过首尾帧双重控制精准锁定视频起止画面，单次生成 4–15 秒，覆盖 21:9 至 9:16 多种画幅。计费透明：480P 低至 $0.05/秒、768P $0.08/秒，仅按实际生成的输出秒数扣费，输入文本与首尾帧图片完全不计费，是电商展示、社媒短视频与批量创意生产的高性价比之选。
MiniMax H3 Max 视频
MiniMax H3 Max 视频生成模型可通过文本和图片生成高质量视频，支持 768P 直出及首尾帧控制。
Base URL
https://api.icreat.ai认证
所有 API 请求均需通过 API Key 认证。
export ICREAT_API_KEY="your-api-key-here"HTTP 请求头
import os
API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer " + API_KEY,
}保护好您的 API Key
切勿在客户端代码或公开仓库中暴露 API Key。请使用环境变量或后端代理。
代码示例
视频生成采用二段式异步调用：先提交任务获取 task_id，再通过查询任务结果接口轮询进度。以下示例使用同一 task_id 串联两个步骤。
1. 提交任务
2. 查询任务结果（轮询）
使用提交步骤返回的 task_id 查询任务进度，直至状态变为 SUCCEEDED 或 FAILED。
输入参数
提交任务 - 输入参数
以下参数在提交任务请求体中被接受。
总计：7，必填：5，可选：2。
模型名称。使用当前模型入口时填写 minimax/h3-max。
输入内容数组。必须包含且只能包含一个非空文本项，可附带首帧或尾帧图片。
视频分辨率。
生成视频时长，单位为秒。
Min: 4 Max: 15
生成视频的宽高比。文生视频必须指定具体比例，不能使用 adaptive。
协议保留字段。当前任务流程仍以主动查询状态为准。
是否添加 AIGC 标识水印，具体效果取决于实际线路。
内容校验规则
content必须包含且只能包含一个非空text项。- 每个图片项必须提供非空的
image_url.url和对应的role。 first_frame和last_frame最多各一个。- 使用
last_frame时必须同时提供first_frame。 - 文生视频不能使用
adaptive。 - 所有图片 URL 必须非空且可由服务端访问。
查询任务结果 - 输入参数
总计：1，必填：1，可选：0。
提交任务接口返回的任务 ID。
输出参数
提交任务 - 输出参数
总计：1。
异步任务的唯一标识。使用此 ID 查询任务状态。
查询任务结果 - 输出参数
当前任务状态。
视频资源列表。任务处理中或失败时为 []。
任务费用（美元），仅在任务成功时出现。
任务失败时返回的错误代码。
任务失败时返回的英文错误信息。
场景示例
文生视频
文生视频必须指定具体画面比例。
{
"model": "minimax/h3-max",
"content": [
{
"type": "text",
"text": "一只金毛在海滩上奔跑，慢镜头，夕阳，电影感"
}
],
"resolution": "480P",
"duration": 5,
"ratio": "16:9"
}首帧生视频
{
"model": "minimax/h3-max",
"content": [
{
"type": "text",
"text": "让画面中的人物自然走向远处"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.jpg"
},
"role": "first_frame"
}
],
"resolution": "768P",
"duration": 5,
"ratio": "adaptive"
}首尾帧生视频
last_frame 必须与 first_frame 一起使用。
{
"model": "minimax/h3-max",
"content": [
{
"type": "text",
"text": "让画面中的人物自然走向远处"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/first-frame.jpg"
},
"role": "first_frame"
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/last-frame.jpg"
},
"role": "last_frame"
}
],
"resolution": "768P",
"duration": 5,
"ratio": "adaptive"
}LLM 友好的提示词
# minimax/h3-max
> MiniMax H3 Max 视频生成模型支持文本生成视频、首帧生视频和首尾帧生视频，可生成 768P 或 480P 视频。
## API 信息
- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint**：`POST /v1/task/submit/minimax/h3-max`
- **Query endpoint**：`POST /v1/task/result`
- **Model ID**：`minimax/h3-max`
- **model 参数**：`minimax/h3-max`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`
## 调用流程
1. 提交任务并保存响应中的 `task_id`。
2. 使用同一 `task_id` 调用 `/v1/task/result`。
3. `SUBMITTED` 或 `IN_PROGRESS` 时继续轮询。
4. `SUCCEEDED` 时从 `result` 读取视频 URL。
5. `FAILED` 时读取 `error_code` 和 `error_message`。
## 输入要点
- `model`：必须为 `minimax/h3-max`。
- `content`：必须且只能包含一个非空文本项，可附带首帧或尾帧图片。
- `resolution`：`768P` 或 `480P`。
- `duration`：4 至 15 秒。
- `ratio`：`adaptive`、`21:9`、`16:9`、`4:3`、`1:1`、`3:4` 或 `9:16`。
- 文生视频不能使用 `adaptive`。
- 图片角色支持 `first_frame` 和 `last_frame`。
- `first_frame` 和 `last_frame` 最多各一个。
- 使用 `last_frame` 时必须同时提供 `first_frame`。
- `aigc_watermark` 默认为 `false`。
## 输出要点
成功提交：
`{ "task_id": "task-xxx" }`
处理中：
`{ "status": "IN_PROGRESS", "result": [] }`
成功：
`{ "status": "SUCCEEDED", "result": [{ "type": "video", "url": "..." }], "costUSD": "0.1234" }`
失败：
`{ "status": "FAILED", "error_code": "...", "error_message": "...", "result": [] }`