Skip to main content
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
Async processing mode — submit a request and receive a task ID. Use the Query Task Status endpoint to retrieve generation results. Video links are valid for 24 hours. 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
Available Models

Model IDDefault ResolutionSupported DurationDescription
hailuo-2.3768P6s / 10sHailuo 2.3, supports 4K and character reference
hailuo-2.3-fast768P6s / 10sHailuo 2.3 fast version
hailuo-02768P6s / 10sHailuo 02, supports first/last frame
T2V-01-Director768P6sDirector mode with camera language control
I2V-01-Director720P6sImage-to-video director mode
S2V-01720P6sCharacter reference mode for character consistency

​
Common Parameters

​
model
string
required
Model ID
​
action
string
default:"generate"
Operation type
​
prompt
string
required
Video description text
​
duration
integer
default:"6"
Video duration (seconds): 6, 10
​
resolution
string
default:"768p"
Output resolution, available values depend on the model (see model tabs)
​
image_urls
string[]
First frame image URL for image-to-video
​
last_frame
string
Last frame image URL, requires image_urls. hailuo-02 only
​
callback_url
string
Webhook callback URL
​
extra
object
Additional parameters passed through to Hailuo (see model tabs)

​
Model-Specific Parameters

resolution options: 768p, 1080p
​
extra.prompt_optimizer
boolean
default:"true"
Whether to enable prompt optimization
​
extra.fast_pretreatment
boolean
Fast preprocessing mode
​
extra.subject_reference
array
Character reference for character consistency
"extra": {
  "subject_reference": [{
    "type": "character",
    "image": ["https://example.com/character.jpg"]
  }]
}

​
Generation Modes

ModeParametersSupported Models
Text-to-videopromptAll
Image-to-videoprompt + image_urls (1 image)All
First/Last frameimage_urls (1 image) + last_framehailuo-02
Character referenceprompt + extra.subject_referencehailuo-2.3 series

​
Response

​
task_id
string
Task ID
​
model
string
Model ID used
​
action
string
Operation type
​
status
string
Task status: queued
​
created_at
integer
Creation time (Unix millisecond timestamp)
​
progress
integer
Progress, initially 0