MiniMax Hailuo-2.3-Fast 视频生成

MiniMax 海螺 Hailuo-2.3-Fast 视频生成模型，图生视频专用，生成速度提升 2.5 倍，成本降低近 50%，适合批量生产。

模型信息

属性	值
模型ID	MiniMax-Hailuo-2.3-Fast
任务类型	image-to-video
输入	图像 + 文本（可选）
输出	视频（通过 file_id 下载）
视频时长	6 或 10 秒（1080P 仅 6 秒）
视频分辨率	768P / 1080P

支持的功能

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

API 调用

端点

创建任务：

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-2.3-Fast	模型ID
first_frame_image	string	是	—	URL 或 base64	首帧图像
prompt	string	否	—	最长 2000 字符	文本提示词，支持 [] 运镜命令
prompt_optimizer	boolean	否	true	true/false	自动优化提示词
fast_pretreatment	boolean	否	false	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

请求示例

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-2.3-Fast",
    "first_frame_image": "https://example.com/input.jpg",
    "prompt": "画面缓缓动起来，花瓣飘落",
    "duration": 6,
    "resolution": "768P"
  }'

查询任务状态

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": 1366,
  "video_height": 768,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

任务状态

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

计费

分辨率	时长	价格（元/视频）
768P	6s	1.35
768P	10s	2.25
1080P	6s	2.31

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

与 Hailuo-2.3 对比

特性	Hailuo-2.3	Hailuo-2.3-Fast
文生视频	支持	不支持
图生视频	支持	支持
生成速度	标准	提升 2.5 倍
768P 6s 价格	2.00 元	1.35 元
适用场景	高质量创作	批量生产、快速迭代

数据来源

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