Skip to main content
POST
/
v1
/
tasks
Hailuo Series
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "minimax-hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

MiniMax Hailuo video generation series. Two tiers — minimax-hailuo-2.3 (the 2.3 main release, adds 15 camera-movement tags) and minimax-hailuo-2.3-fast (the 2.3 accelerated tier, faster and cheaper, ideal for previews / batch). Supports text-to-video (T2V) and image-to-video (I2V).

​
Pricing

Billed by resolution × duration, in $ / second.
Model768P1080P
minimax-hailuo-2.3$0.05185$0.0765
minimax-hailuo-2.3-fast$0.02635$0.04505

​
Examples

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-hailuo-2.3",
    "prompt": "A Shiba Inu in a spacesuit walking on the moon, cinematic lighting",
    "duration": 6,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "minimax-hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
After submission, poll status with GET /v1/tasks/{task_id}; see Task System for details.

​
Available Models

Model IDResolutionDuration (sec)ActionsNotes
minimax-hailuo-2.3768p / 1080p6 / 10generate / image2video1080p only at 6 sec; 15 camera-movement tags; prompt ≤ 2000 chars
minimax-hailuo-2.3-fast768p / 1080p6 / 10generate / image2videoAccelerated tier, lower unit price

​
Common Parameters

​
model
string
required
Model ID. Allowed values:
  • minimax-hailuo-2.3
  • minimax-hailuo-2.3-fast
​
action
string
default:"generate"
Operation type, usually no need to set explicitly (the backend auto-routes by media fields). Allowed values:
  • generate — text-to-video (T2V)
  • image2video — image-to-video (I2V); pair with image_urls
​
prompt
string
required
Video description text, up to 2000 characters. Embed [tag] brackets in the text to trigger the corresponding camera movement (see Camera-movement tags below)
​
aspect_ratio
string
default:"16:9"
Frame aspect ratio. Allowed values:
  • 16:9 — landscape widescreen
  • 9:16 — portrait
  • 1:1 — square
​
resolution
string
default:"768p"
Output resolution; see Available Models for per-model support. Allowed values:
  • 768p
  • 1080p
​
duration
integer
Video duration in seconds. Allowed: 6 / 10 (1080p only at 6)
​
image_urls
string[]
Reference image URL array; triggers I2V mode. Public URL or Base64
​
callback_url
string
Webhook callback URL, invoked when the task reaches a terminal state. See Callback Mechanism
​
callback_events
string[]
Subscribed callback event types; defaults to all terminal events

​
Model-specific Parameters

​
watermark
boolean
default:"false"
Whether to overlay a MiniMax watermark on the output video
​
prompt_optimizer
boolean
default:"true"
Auto-optimize the prompt; when disabled, generation runs against the original prompt
​
fast_pretreatment
boolean
default:"false"
Shortens prompt-optimization latency
​
camera_movement_tags
string[]
Camera-movement tag list (15 total). Recommended to also embed [tag] brackets directly in the prompt; see Camera-movement tags below

​
Camera-movement Tags (2.3 / 2.3-fast)

The signature feature of the Hailuo 2.3 series — embed [tag] brackets in the prompt to trigger the corresponding camera movement; multiple tags can stack in a single sentence and the backend parses them in order. You can also pass them explicitly via the camera_movement_tags field for higher recognition reliability.
CategoryTagEffect
Translation[左移] (pan-left)Camera pans horizontally to the left
[右移] (pan-right)Camera pans horizontally to the right
[上升] (boom-up)Camera moves vertically upward
[下降] (boom-down)Camera moves vertically downward
Dolly[推进] (dolly-in)Camera physically moves forward
[拉远] (dolly-out)Camera physically moves backward
Pan/Tilt[左摇] (pan left)Body fixed, head pans left
[右摇] (pan right)Body fixed, head pans right
[上摇] (tilt up)Body fixed, head tilts up
[下摇] (tilt down)Body fixed, head tilts down
Zoom[变焦推近] (zoom-in)Focal-length zoom-in (body still)
[变焦拉远] (zoom-out)Focal-length zoom-out (body still)
Special[晃动] (shake)Handheld shake
[跟随] (follow)Follow the subject’s motion
[固定] (static)Completely static camera
Example — "[推进] cobblestone street of an old town, [变焦推近] raindrops falling from the eaves" — camera pushes forward first, then focuses on the eaves detail.

​
Resource Limits

ItemLimit
Reference image (image_urls)URL or Base64, JPG/PNG/WEBP
Prompt length≤ 2000 characters
Duration6 / 10 sec; 1080p only at 6 sec
OutputMP4, link valid for 24 hours