跳转到主要内容
POST
/
v1
/
tasks
Vidu Q3 系列
curl --request POST \
  --url https://www.qingbo.dev/v1/tasks \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "action": "<string>",
  "prompt": "<string>",
  "aspect_ratio": "<string>",
  "resolution": "<string>",
  "duration": 123,
  "image_urls": [
    "<string>"
  ],
  "first_frame_image": "<string>",
  "last_frame_image": "<string>",
  "callback_url": "<string>",
  "callback_events": [
    "<string>"
  ]
}
'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3-pro",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

Documentation Index

Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt

Use this file to discover all available pages before exploring further.

生数科技 Vidu Q3 系列视频生成模型,参考生视频(R2V) 是看家本事 — 接受 1-7 张公网图作为主体 / 风格参考,prompt 只负责描述动作与镜头,人物外观由参考图决定,适合 角色一致性 / 风格延续 / 多机位切换 三类场景。 四档定位:
  • viduq3-pro — 旗舰档,按 image_urls 数量自动路由 文生 / 图生 / 首尾帧,默认开启音频直出(对白 + 音效)
  • viduq3-mix — 综合画质王,支持 多段参考视频 / 图片混剪 生成连贯视频,带音频联合生成,720P / 1080P 双档,适合短剧分镜重组、广告素材二创
  • viduq3 — 标准档,日常默认首选,镜头切换更聪明,540p / 720p / 1080p,3-16 秒
  • viduq3-turbo — 轻量快速档,生成最快、单价最低,质量略低于标准档,适合预览 / 批量 / A/B 测试
按 分辨率 × 时长 计费,每秒单价,1-16 秒任意整数。

​
定价

模型540P720P1080P
viduq3-pro$0.0595 / 秒$0.1275 / 秒$0.136 / 秒
viduq3-mix—$0.10625 / 秒$0.1275 / 秒
viduq3$0.0425 / 秒$0.085 / 秒$0.10625 / 秒
viduq3-turbo$0.034 / 秒$0.051 / 秒$0.0595 / 秒

​
调用示例

curl -X POST https://www.qingbo.dev/v1/tasks \
  -H "Authorization: Bearer $WAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3-pro",
    "prompt": "黄昏的海滩,女孩迎着夕阳奔跑,长发飞扬,电影感光影",
    "duration": 5,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3-pro",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
提交后用 GET /v1/tasks/{task_id} 轮询状态,详见 任务系统。

​
可用模型

模型 ID分辨率时长支持 action备注
viduq3-pro540p / 720p / 1080p1-16 秒generate / image2video / first_last_frame旗舰档,音频直出
viduq3-mix720P / 1080P1-16 秒reference / image2video综合画质王,多素材混剪
viduq3540p / 720p / 1080p1-16 秒reference / image2video标准档,日常首选
viduq3-turbo540p / 720p / 1080p1-16 秒reference / image2video轻量快速档,生成最快、单价最低

​
通用参数

​
model
string
必填
模型 ID,见 可用模型 表
​
action
string
操作类型,Pro 档 可省略(按 image_urls 数量自动路由),其他档建议显式指定。可选值:
  • generate — 文生视频(仅 Pro)
  • image2video — 图生视频
  • reference — 参考生视频(标准 / Mix / Turbo 默认)
  • first_last_frame — 首尾帧(仅 Pro)
​
prompt
string
必填
视频描述文本,建议描述 动作 / 镜头 / 氛围,人物外观由 image_urls 决定
​
aspect_ratio
string
默认值:"16:9"
画面宽高比,可选值:
  • 16:9 — 横版宽屏
  • 9:16 — 竖版长屏
  • 4:3 — 横版
  • 3:4 — 竖版
  • 1:1 — 正方形
​
resolution
string
默认值:"720p"
输出分辨率,各模型支持档位见 可用模型 表
​
duration
integer
默认值:"5"
视频时长(秒),范围 1-16 任意整数。Mix 档支持 1 秒短视频
​
image_urls
string[]
参考图片 URL 数组,1-7 张:
  • 标准 / Mix / Turbo:作为主体 / 风格参考(R2V)
  • Pro 档:0 张文生 / 1 张图生 / 2 张首尾帧,详见 自动路由
​
first_frame_image
string
视频首帧图 URL,Pro 档 first_last_frame 模式必填
​
last_frame_image
string
视频尾帧图 URL,Pro 档 first_last_frame 模式必填
​
callback_url
string
Webhook 回调地址,任务终态时调用。详见 回调机制
​
callback_events
string[]
订阅的回调事件,默认订阅终态(succeeded / failed / cancelled)

​
模型特定参数

​
audio
boolean
默认值:"true"
是否生成音频(默认 true)。Pro 档默认开启 音频直出(对白 + 音效),传 false 可关闭静音输出
Pro 档按 image_urls 数量自动路由模式,详见 自动路由说明。

​
自动路由说明

viduq3-pro 按 image_urls 数组长度自动选择生成模式,通常无需显式传 action:
image_urls 数量路由模式等价 action说明
0 张(或不传)文生视频generate纯 prompt 驱动
1 张图生视频image2video以图为起始画面
2 张首尾帧first_last_frame第一张作首帧,第二张作尾帧
显式传 first_frame_image + last_frame_image 时优先采用,会覆盖 image_urls 的首尾帧路由。
其他档(viduq3 / viduq3-mix / viduq3-turbo)默认走 R2V 参考生 模式,image_urls 1-7 张作为主体 / 风格参考。

​
资源限制

项目限制
参考图片最多 7 张,单张 ≤ 30MB,JPG / PNG / WEBP
首尾帧图JPG / PNG / WEBP,需公网可下载链接
Prompt 长度建议 ≤ 2000 字符
视频时长1-16 秒任意整数(Mix 支持 1 秒短视频)
输出MP4,链接 24 小时有效

​
相关文档