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": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "veo-3.1",
  "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 — please download promptly. 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1",
    "action": "generate",
    "prompt": "A golden retriever running on a beach at sunset, cinematic lighting, slow motion",
    "aspect_ratio": "16:9",
    "duration": 8,
    "resolution": "1080p"
  }'

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

​
Available Models

Model IDDescription
veo-3.1VEO 3.1, supports 4K and native audio
veo-3.1-fastVEO 3.1 fast version
veo-3.0VEO 3.0

​
Common Parameters

​
model
string
required
Model ID
​
action
string
default:"generate"
Operation type
​
prompt
string
required
Video description text. VEO 3+ supports describing sound effects and dialogue in the prompt, and the model will automatically generate corresponding audio
​
aspect_ratio
string
default:"16:9"
Aspect ratio: 16:9, 9:16
​
duration
integer
default:"8"
Video duration (seconds): 4, 6, 8
​
resolution
string
default:"720p"
Output resolution, available values depend on the model (see model tabs)
​
negative_prompt
string
Content you do not want to appear. Describe directly (do not use negation statements)
​
seed
integer
Random seed for improved reproducibility (exact results not guaranteed). VEO 3.1 series only
​
callback_url
string
Webhook callback URL
​
extra
object
Additional parameters passed through to Google VEO (see model tabs)

​
Model-Specific Parameters

resolution options: 720p, 1080p, 4k
​
extra.personGeneration
string
default:"allow_all"
Person generation control:
  • allow_all — Allow all persons
  • allow_adult — Allow adults only
  • dont_allow — Disallow person generation
Unique capabilities:
  • Native audio generation (dialogue + ambient sound + sound effects, no additional parameters required)
  • 4K resolution output

​
Constraints

ConstraintRequirement
Resolution 1080p or 4kduration must be 8
Resolution 4kVEO 3.1 and 3.1 Fast only
Output frame rate24 FPS
Output formatMP4
VEO 3+ natively supports audio generation with no additional parameters required. Describe sound effects in the prompt (e.g., “the sound of waves crashing”).

​
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