Hailuo 2.3 API
Model-specific Buble API parameters, modes, pricing, and examples for Hailuo 2.3.
Hailuo 2.3 API
Hailuo 2.3 is a focused video model for text-to-video and start-frame image-to-video generation.
Model keys
minimax/hailuo-2.3— Hailuo 2.3
Supported modes and inputs
| Model | Mode | Label | Input requirements |
|---|---|---|---|
minimax/hailuo-2.3 | text_to_video | Text to Video | Prompt max 2000 chars |
minimax/hailuo-2.3 | frames_to_video | Frames to Video | Prompt max 2000 chars Images start_frame: 1-1 files, 10 MB, formats jpg, png, webp |
Options
| Model | Option | Default | Allowed values | Applies to |
|---|---|---|---|---|
minimax/hailuo-2.3 | duration | 6s | 6s, 10s | All modes |
minimax/hailuo-2.3 | resolution | 768p | 768p, 1080p | All modes |
Pricing
| Model | Pricing |
|---|---|
minimax/hailuo-2.3 | 2 credits per second; option multipliers: resolution={"768P":1,"1080p":2} |
Production guidance
- Pass
modeexplicitly. - Use only option values listed above.
- Upload media with
POST /api/v1/filesbefore calling media-input modes. - Use the exact model key for the variant you want.
Example: text to video
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"
}'Example: media-guided video
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"
}'