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": "sora-2-pro",
    "action": "generate",
    "prompt": "A cat playing piano in a jazz club, cinematic lighting",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "sora-2-pro",
  "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.
Sora 2 series models will be discontinued on September 24, 2026.
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro",
    "action": "generate",
    "prompt": "A cat playing piano in a jazz club, cinematic lighting",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "sora-2-pro",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Available Models

Model IDResolution SupportDescription
sora-2-pro720p, 1080pHigh quality, supports 1080p
sora-2720pFaster processing

Common Parameters

model
string
required
Model ID
action
string
default:"generate"
Operation type: generate, remix, extend
prompt
string
required
Video description text
callback_url
string
Webhook callback URL
extra
object
Additional parameters passed through to Sora

Parameters by Operation Type

Text-to-video or image-to-video.
aspect_ratio
string
default:"9:16"
Aspect ratio: 16:9, 9:16
duration
integer
default:"4"
Video duration (seconds): 4, 8, 12, 16, 20
resolution
string
default:"720p"
Output resolution. 1080p supported by sora-2-pro only
image_urls
string[]
Reference image URLs for first-frame guidance. Image aspect ratio must match aspect_ratio
extra.characters
array
Character asset array, maximum 2. Character names must be mentioned in the prompt

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