获取 API Key 获取 API
文档

Vidu Q3(pro/turbo) 视频生成

- 异步处理模式,返回任务ID用于后续查询

  • 支持文生视频、图生视频、首尾帧生视频
  • 支持 540p / 720p / 1080p 分辨率
  • 时长范围 1-16 秒,默认开启音频直出

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "一只猫在弹钢琴,镜头缓缓拉近",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_xxxxxxxxxx"
    }
  ]
}

认证

Authorization string

所有接口均需要使用 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

请求参数

model string

视频生成模型名称

支持的模型:

  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
prompt string

文本描述,最长 2000 个字符

文生视频时必填,图生视频和首尾帧模式下可选。

示例:"一只猫在弹钢琴,镜头缓缓拉近"

duration integer

视频时长(秒)

范围:1 到 16

默认值:5

resolution string

视频分辨率

可选值:

  • 540p - 标清
  • 720p - 高清(默认)
  • 1080p - 全高清

默认值:720p

aspect_ratio string

视频宽高比(仅文生视频模式可用)

可选值:

  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 4:3 - 传统比例
  • 3:4 - 竖版传统比例
  • 1:1 - 方形

警告



此参数仅在文生视频模式下可用(不传 image_urls 时)。

image_urls string

">
图片 URL 数组,用于图生视频

系统根据图片数量自动判断生成模式:

  • 0 张(不传):文生视频模式
  • 1 张:图生视频模式(以该图为起始画面)
  • 2 张:首尾帧生视频模式(第一张=首帧,第二张=尾帧)

示例:["https://example.com/photo.jpg"]

警告



* 最多支持 2 张图片

* 首尾帧模式必须传恰好 2 张图片

* 只要传入 image_urls(无论 1 张还是 2 张),就不能同时设置 aspect_ratio 参数,视频比例将由图片自动决定

audio boolean

是否生成音频(对白、音效)

默认值:true

如需静音视频,设置为 false。

seed integer

种子整数,用于控制生成内容的随机性

取值范围:-1 \~ 2^32-1 之间的整数

注意



* 相同的请求下,模型收到不同的 seed 值(如:不指定 seed 值或令 seed 取值为 -1,会使用随机数替代),将生成不同的结果

* 相同的请求下,模型收到相同的 seed 值,会生成类似的结果,但不保证完全一致

自动路由规则

系统根据 image_urls 的图片数量自动判断生成模式:

图片数 模式 说明
0 张(不传) 文生视频 纯文本描述生成
1 张 图生视频 以该图为起始画面
2 张 首尾帧生视频 第一张=首帧,第二张=尾帧

参数支持矩阵

参数 文生视频 图生视频 首尾帧
model ✅ 必填 ✅ 必填 ✅ 必填
prompt ✅ 必填 选填 选填
image_urls - ✅ 1张 ✅ 2张
duration ✅ 1-16秒 ✅ 1-16秒 ✅ 1-16秒
resolution ✅ ✅ ✅
aspect_ratio ✅ - -
audio ✅ ✅ ✅
seed ✅ ✅ ✅

响应

code integer

响应状态码,成功时为 200

data array
返回数据数组
status string

任务状态,初始提交时为 submitted

task_id string

任务唯一标识符,用于查询任务状态和结果

使用场景

场景 1:文生视频

{
  "model": "viduq3-pro",
  "prompt": "一只猫在弹钢琴,镜头缓缓拉近",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

场景 2:图生视频(单张图片)

{
  "model": "viduq3-pro",
  "prompt": "人物缓缓转身微笑",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

场景 3:首尾帧生视频

{
  "model": "viduq3-pro",
  "prompt": "人物从站立缓缓坐下",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

场景 4:关闭音频(静音视频)

{
  "model": "viduq3-pro",
  "prompt": "日落海景延时摄影",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
注意

查询任务结果

视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。