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

ModelModeLabelInput requirements
minimax/hailuo-2.3text_to_videoText to VideoPrompt max 2000 chars
minimax/hailuo-2.3frames_to_videoFrames to VideoPrompt max 2000 chars
Images start_frame: 1-1 files, 10 MB, formats jpg, png, webp

Options

ModelOptionDefaultAllowed valuesApplies to
minimax/hailuo-2.3duration6s6s, 10sAll modes
minimax/hailuo-2.3resolution768p768p, 1080pAll modes

Pricing

ModelPricing
minimax/hailuo-2.32 credits per second; option multipliers: resolution={"768P":1,"1080p":2}

Production guidance

  • Pass mode explicitly.
  • Use only option values listed above.
  • Upload media with POST /api/v1/files before 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"
  }'