Hailuo 2.3 API

Hailuo 2.3 是聚焦的视频模型，支持文生视频和首帧图生视频。

模型 key

minimax/hailuo-2.3 — Hailuo 2.3

支持的 mode 与输入

模型	Mode	名称	输入要求
`minimax/hailuo-2.3`	`text_to_video`	文生视频	Prompt max 2000 chars
`minimax/hailuo-2.3`	`frames_to_video`	首帧生成视频	Prompt max 2000 chars Images `start_frame`: 1-1 files, 10 MB, formats jpg, png, webp

参数

模型	参数	默认值	可选值	适用 mode
`minimax/hailuo-2.3`	`duration`	`6s`	`6s`, `10s`	全部 mode
`minimax/hailuo-2.3`	`resolution`	`768p`	`768p`, `1080p`	全部 mode

价格

模型	价格
`minimax/hailuo-2.3`	每秒 2 credits；参数倍率：`resolution`=`{"768P":1,"1080p":2}`

生产建议

显式传入 mode。
只使用上表列出的参数值。
媒体输入类 mode 请先用 POST /api/v1/files 上传素材。
如果页面包含多个变体，请使用你真正需要的模型 key。

示例：文生视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-2.3",
    "mode": "text_to_video",
    "prompt": "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    "duration": "6s",
    "resolution": "768p"
  }'

示例：素材驱动视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-2.3",
    "mode": "frames_to_video",
    "prompt": "Animate the source into a polished cinematic motion shot with natural camera movement",
    "start_frame": "https://example.com/start.png",
    "duration": "6s",
    "resolution": "768p"
  }'

Hailuo 2.3 API

On this page