Hailuo-2.3（MiniMax 视频）

URL：/v1/video_generation

Method：POST

文生视频

请求参数

参数	类型	必填	说明
model	string	是	MiniMax-Hailuo-2.3
prompt	string	是	视频的文本描述，最大 2000 字符。支持 [指令] 运镜：如 [左移]、[右摇]、[推进]、[拉远]、[上升]、[下降]、[上摇]、[下摇]、[变焦推近]、[变焦拉远]、[晃动]、[跟随]、[固定]；可组合如 [左摇,上升]
prompt_optimizer	boolean	否	是否自动优化 prompt，默认 true
fast_pretreatment	boolean	否	是否缩短优化耗时，默认 false
duration	integer	否	时长（秒），默认 6。Hailuo：768P 支持 6 或 10，1080P 为 6
resolution	string	否	6s 可选 768P（默认）、1080P，10s 仅 768P
callback_url	string	否	任务状态回调 URL，需原样返回 challenge 验证；状态为 processing ／ success ／ failed
aigc_watermark	boolean	否	是否添加水印，默认 false

图生视频

请求参数

参数	类型	必填	说明
model	string	是	MiniMax-Hailuo-2.3
first_frame_image	string	是	首帧图片。公网 URL 或 Base64 Data URL。格式 JPG/JPEG/PNG/WebP，< 20MB，短边 > 300px，长宽比 2:5～5:2。生成视频尺寸遵循首帧
prompt	string	否	视频描述，最大 2000 字符；支持 [指令] 运镜
prompt_optimizer	boolean	否	是否自动优化 prompt，默认 true
fast_pretreatment	boolean	否	是否缩短优化耗时，默认 false
duration	integer	否	时长（秒），默认 6。768P 支持 6 或 10，1080P 为 6
resolution	string	否	768P（默认）、1080P；6s 可选两者，10s 仅 768P
callback_url	string	否	任务状态回调 URL
aigc_watermark	boolean	否	是否添加水印，默认 false

返回参数

参数	类型	必填	说明
task_id	string	—	视频生成任务 ID，用于后续查询任务状态
base_resp	object	—	status_code：0 成功，1002 限流，1004 鉴权失败，1008 余额不足，1026 描述敏感，2013 参数异常，2049 无效 api key；status_msg：具体错误详情。详见 错误码列表

cURL 示例（文生视频）

curl -X POST "$BASE_URL/v1/video_generation" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
    "duration": 6,
    "resolution": "1080P"
  }'

cURL 示例（图生视频）

curl -X POST "$BASE_URL/v1/video_generation" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-Hailuo-2.3",
    "first_frame_image": "https://example.com/first-frame.jpg",
    "prompt": "A mouse runs toward the camera, smiling and blinking.",
    "duration": 6,
    "resolution": "1080P"
  }'