MiniMax Hailuo 2.3

MiniMax-Hailuo-2.3：文生/首帧图生视频，6 或 10 秒，768p/1080p，异步，用 GET /v1/tasks/{task_id} 查询

MiniMax-Hailuo-2.3 当前暂未开放调用。本页字段说明仅供接入预览，实际可用状态以模型列表为准。

POST/v1/videos/generations

GET/v1/tasks/{task_id}

Hailuo 2.3 通过 /v1 统一异步视频接口调用。提交、轮询、任务对象与错误见接口说明。

项	值
模型	`MiniMax-Hailuo-2.3`
模式	异步（提交 → 轮询 `GET /v1/tasks/{task_id}`）
计费	按时长与分辨率档位，先预扣后结算，价格以定价页为准
媒体保留	`video_url` 最长保留至任务完成后 72 小时

时长 6 或 10 秒，分辨率 768p、1080p，默认 6 秒、768p。

快速开始

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "[推进]A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

响应示例（HTTP 202）：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "MiniMax-Hailuo-2.3",
  "status": "pending",
  "created_at": 1772942400,
  "duration": 6,
  "resolution": "768p"
}

用 task_id 调用 GET /v1/tasks/{task_id} 查询结果，见响应。

模式选择

模式	怎么传参
文生视频	只传 `prompt` 与控制字段
首帧图生视频	加 `first_frame_image`

请求参数

参数	类型	必填	默认	说明
`model`	string	是	-	固定为 `MiniMax-Hailuo-2.3`
`prompt`	string	是	-	视频内容描述，最长 2000 字符；可在提示词中使用镜头运动指令
`duration`	integer	否	`6`	`6` 或 `10`
`resolution`	string	否	`768p`	`768p` 或 `1080p`
`first_frame_image`	string	否	-	首帧图片，支持公网 URL 或 Base64 data URI
`prompt_optimizer`	boolean	否	`true`	是否自动优化提示词
`fast_pretreatment`	boolean	否	`false`	是否缩短提示词优化耗时；开启后优化质量可能略受影响
`watermark`	boolean	否	`false`	是否添加水印
`callback_url`	string	否	-	任务到达终态后的 HTTPS 回调地址

prompt 中可写入镜头运动指令，例如 [左移]、[右移]、[推进]、[拉远]、[上升]、[下降]、[变焦推近]、[变焦拉远]、[晃动]、[跟随]、[固定] 等。

请求示例

首帧图生视频：

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Kitten running towards camera, smiling and blinking",
  "first_frame_image": "https://example.com/cat.jpg",
  "duration": 6,
  "resolution": "1080p"
}

响应

用 GET /v1/tasks/{task_id} 查询，状态依次为 pending → running → succeeded / failed（终态）。成功后 video_url 为视频下载地址：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "MiniMax-Hailuo-2.3",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1772942400,
  "completed_at": 1772942468,
  "duration": 6,
  "resolution": "768p",
  "video_url": "https://media.example.com/video.mp4",
  "expires_at": 1773028868
}

字段	类型	说明
`video_url`	string	视频下载地址，仅 `succeeded` 返回，尽快转存
`expires_at`	integer	`video_url` 失效时间，Unix 秒
`credits_charged`	number	本次实际扣费（积分）
`error`	object	仅 `failed` 返回：`{"code": "timeout" \| "upstream_error", "message": "..."}`

完整任务对象字段见接口说明。

计费

提交时按顶层 duration、resolution 预扣，未传时按 6 秒、768p。
终态按实际结果结算，多退少补；失败全额退回预扣。

错误

通用错误见接口说明。

HTTP	code	触发场景	处理
404	`model_not_found`	`duration` / `resolution` 组合没有对应售价档位	按注意事项调整

本模型的字段范围由上游校验，不合规的请求可能在 202 之后表现为异步 failed。

注意事项

1080p → 仅支持 6 秒；768p 支持 6 秒和 10 秒。

MiniMax Hailuo 2.3

本页内容