MiniMax Hailuo-02 视频生成

MiniMax 海螺 Hailuo-02 视频生成模型，支持文生视频、图生视频、首尾帧生视频，原生 1080p，SOTA 指令遵循，极致物理表现。

模型信息

属性	值
模型ID	`MiniMax-Hailuo-02`
任务类型	text-to-video / image-to-video / first-last-frame-to-video
输入	文本 / 图像 + 文本 / 首尾帧图像 + 文本
输出	视频（通过 file_id 下载）
视频时长	6 或 10 秒（1080P 仅 6 秒）
视频分辨率	512P / 768P / 1080P

支持的功能

功能	说明
文生视频 (T2V)	文本描述生成视频
图生视频 (I2V)	指定首帧图像生成视频
首尾帧生视频 (FL2V)	指定首帧和尾帧图像生成视频
运镜控制	支持 15 种镜头运动命令（用 `[]` 包裹）

API 调用

端点

创建任务（文生视频 / 图生视频）：

POST https://api.minimax.io/v1/video_generation

创建任务（首尾帧生视频）：

POST https://api.minimax.io/v1/video_generation

查询任务状态：

GET https://api.minimax.io/v1/query/video_generation?task_id={task_id}

请求头

参数	类型	必填	说明
Content-Type	string	是	`application/json`
Authorization	string	是	`Bearer $MINIMAX_API_KEY`

请求参数（文生视频）

参数	类型	必填	默认值	取值范围	说明
model	string	是	—	`MiniMax-Hailuo-02`	模型ID
prompt	string	是	—	最长 2000 字符	文本提示词，支持 `[]` 运镜命令
prompt_optimizer	boolean	否	true	true/false	自动优化提示词
duration	integer	否	6	6 或 10（1080P 仅 6）	视频时长（秒）
resolution	string	否	—	`512P` / `768P` / `1080P`	视频分辨率
callback_url	string	否	—	URL	异步回调 URL

请求参数（图生视频）

参数	类型	必填	默认值	取值范围	说明
model	string	是	—	`MiniMax-Hailuo-02`	模型ID
first_frame_image	string	是	—	URL 或 base64	首帧图像
prompt	string	否	—	最长 2000 字符	文本提示词
prompt_optimizer	boolean	否	true	true/false	自动优化提示词
duration	integer	否	6	6 或 10（1080P 仅 6）	视频时长（秒）
resolution	string	否	—	`512P` / `768P` / `1080P`	视频分辨率
callback_url	string	否	—	URL	异步回调 URL

请求参数（首尾帧生视频）

参数	类型	必填	默认值	取值范围	说明
model	string	是	—	`MiniMax-Hailuo-02`	模型ID
last_frame_image	string	是	—	URL 或 base64	尾帧图像
first_frame_image	string	否	—	URL 或 base64	首帧图像
prompt	string	否	—	最长 2000 字符	文本提示词
prompt_optimizer	boolean	否	true	true/false	自动优化提示词
duration	integer	否	6	6 或 10（1080P 仅 6）	视频时长（秒）
resolution	string	否	—	`768P` / `1080P`	视频分辨率
callback_url	string	否	—	URL	异步回调 URL

输入图像要求

属性	要求
格式	JPG, JPEG, PNG, WebP
文件大小	最大 20MB
分辨率	短边 > 300px
宽高比	2:5 ~ 5:2

运镜命令

使用 [] 包裹，支持以下 15 种镜头运动：

命令	说明
`[Truck left]` / `[Truck right]`	横移
`[Pan left]` / `[Pan right]`	水平摇摄
`[Push in]` / `[Pull out]`	推拉
`[Pedestal up]` / `[Pedestal down]`	升降
`[Tilt up]` / `[Tilt down]`	俯仰
`[Zoom in]` / `[Zoom out]`	变焦
`[Shake]`	手持抖动
`[Tracking shot]`	跟踪拍摄
`[Static shot]`	静止机位

请求示例（文生视频）

curl -X POST 'https://api.minimax.io/v1/video_generation' \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "[Push in] 一只猫在花园里追蝴蝶，阳光明媚",
    "duration": 6,
    "resolution": "1080P"
  }'

请求示例（图生视频）

curl -X POST 'https://api.minimax.io/v1/video_generation' \
  -H "Authorization: Bearer $MINIMAX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "MiniMax-Hailuo-02",
    "first_frame_image": "https://example.com/first.jpg",
    "prompt": "画面中的人物缓缓转头微笑",
    "duration": 6,
    "resolution": "1080P"
  }'

查询任务状态

curl -X GET 'https://api.minimax.io/v1/query/video_generation?task_id=176843862716480' \
  -H "Authorization: Bearer $MINIMAX_API_KEY"

响应示例（任务创建）

{
  "task_id": "176843862716480",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

响应示例（任务完成）

{
  "task_id": "176843862716480",
  "status": "Success",
  "file_id": "176844028768320",
  "video_width": 1920,
  "video_height": 1080,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

任务状态

状态	说明
Preparing	准备中
Queueing	排队中
Processing	生成中
Success	成功
Fail	失败

错误码

状态码	说明
0	成功
1002	频率限制
1004	认证失败
1008	余额不足
1026	内容审核不通过
2013	参数无效
2049	API Key 无效

计费

分辨率	时长	价格（元/视频）
512P	6s	0.60
512P	10s	1.00
768P	6s	2.00
768P	10s	4.00
1080P	6s	3.50

生成失败或触发安全审核的视频不计费。视频通过 file_id 获取，请及时下载。

数据来源

API 参考（文生视频）：https://platform.minimax.io/docs/api-reference/video-generation-t2v
API 参考（图生视频）：https://platform.minimax.io/docs/api-reference/video-generation-i2v
API 参考（首尾帧）：https://platform.minimax.io/docs/api-reference/video-generation-fl2v
API 参考（查询任务）：https://platform.minimax.io/docs/api-reference/video-generation-query
计费信息：https://platform.minimaxi.com/docs/pricing/pay-as-you-go