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": "wan2.5-t2v",
    "action": "generate",
    "prompt": "春天的樱花树下，花瓣随风飘落",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.5-t2v",
  "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": "wan2.5-t2v",
    "action": "generate",
    "prompt": "春天的樱花树下，花瓣随风飘落",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.5-t2v",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
Available Models

Model IDDescription
wan2.5-t2vWan 2.5 text-to-video
wan2.5-i2vWan 2.5 image-to-video
wan2.2-i2v-flashWan 2.2 image-to-video fast version
wan2.2-i2v-plusWan 2.2 image-to-video enhanced version

​
Common Parameters

​
model
string
required
Model ID
​
action
string
default:"generate"
Operation type
​
prompt
string
required
Video description text
​
aspect_ratio
string
default:"16:9"
Aspect ratio, automatically mapped to optimal resolution by the backend
​
duration
integer
default:"5"
Video duration (seconds)
​
resolution
string
Resolution: 480p, 720p, 1080p
​
seed
integer
Random seed, range 0-2147483647
​
watermark
boolean
default:"false"
Whether to add a watermark
​
image_urls
string[]
Reference image URL (for image-to-video models)
​
first_frame
string
First frame image URL
​
last_frame
string
Last frame image URL
​
negative_prompt
string
Content you do not want to appear, maximum 500 characters
​
callback_url
string
Webhook callback URL
​
extra
object
Pass-through parameters

​
Model-Specific Parameters

Model ID: wan2.5-t2v
​
extra.prompt_extend
boolean
default:"true"
Whether to enable prompt optimization and expansion
​
extra.audio
boolean
default:"false"
Whether to generate audio

​
Generation Modes

ModeModelParameters
Text-to-videowan2.5-t2vprompt
Image-to-videowan2.5-i2v / wan2.2-i2v-*prompt + image_urls
First/Last framewan2.5-i2vfirst_frame + last_frame

​
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