跳转到主要内容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
异步处理模式 — 提交请求后返回任务 ID，通过 查询任务状态 接口获取生成结果。视频链接有效期 24 小时。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

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

​
可用模型

模型 ID说明
viduq3Vidu Q3，原生音频、16 秒、1080p
viduq3-proVidu Q3 Pro，最高画质
viduq3-turboVidu Q3 Turbo，速度优先
viduq3-mixVidu Q3 Mix，多参考图多实体一致性
viduq2Vidu Q2
viduq1Vidu Q1

​
统一参数

​
model
string
必填
模型 ID
​
action
string
默认值:"generate"
操作类型
​
prompt
string
必填
视频描述文本
​
aspect_ratio
string
默认值:"16:9"
宽高比：16:9、9:16、1:1
​
duration
integer
默认值:"5"
视频时长（秒）
​
resolution
string
默认值:"1080p"
分辨率：720p、1080p
​
seed
integer
随机种子，0 为随机
​
watermark
boolean
是否添加水印。支持自定义水印图片和位置（通过 extra）
​
image_urls
string[]
参考图片 URL 数组，数量决定生成模式：
  • 1 张 → 图生视频
  • 2 张 → 首尾帧模式
  • 3+ 张 → 参考图引导（自动使用 viduq2）
​
callback_url
string
Webhook 回调地址
​
extra
object
透传参数

​
模型特定参数

​
extra.movement_amplitude
string
默认值:"auto"
运动幅度：auto、small、medium、large
​
extra.bgm
boolean
默认值:"false"
是否添加背景音乐
​
extra.wm_url
string
自定义水印图片 URL（需 watermark: true）
​
extra.wm_position
integer
水印位置：1（左上）、2（右上）、3（左下）、4（右下）

​
生成模式

模式参数说明
文生视频prompt纯文本生成
图生视频prompt + image_urls(1张)单图参考
首尾帧image_urls(2张)起止画面过渡
参考图引导image_urls(3+张)多图参考（自动切换为 viduq2）

​
响应

​
task_id
string
任务 ID
​
model
string
使用的模型 ID
​
action
string
操作类型
​
status
string
任务状态：queued
​
created_at
integer
创建时间（Unix 毫秒时间戳）
​
progress
integer
进度，初始为 0