获取 API Key 获取 API
文档

Vidu Q3(mix/standard) 参考生视频

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

  • 上传 1-7 张参考图 + 文字提示词,生成包含参考主体的短视频
  • 支持 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",
    "prompt": "圣诞老人与熊在湖边相拥",
    "image_urls": [
      "https://example.com/santa.png",
      "https://example.com/bear.png"
    ],
    "duration": 8,
    "resolution": "720p",
    "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-mix - 综合画质王,智能转场更强,支持 1 秒短视频
  • viduq3 - 默认首选,镜头切换更聪明

注意



如何选择:日常用 viduq3;要冲画质或要做 1-2 秒动效就用 viduq3-mix。

prompt string

文本提示词,最长 5000 个字符

描述动作和镜头,不要描述外观(外观由参考图片决定)。

示例:"圣诞老人与熊在湖边相拥"

image_urls string

" required>
参考图片 URL 数组,1-7 张

支持公网可访问的图片 URL(http\:// 或 https\://)

示例:["https://example.com/santa.png", "https://example.com/bear.png"]

警告



* 数量:1-7 张

* 支持格式:PNG、JPEG、JPG、WebP

* 最小尺寸:128×128

* 宽高比:1:4 \~ 4:1 之间

* 单张大小:≤ 50MB

* 必须是公网可访问的 URL

duration integer

视频时长(秒)

  • viduq3-mix:1 到 16
  • viduq3:3 到 16

默认值:5

警告



viduq3 最低支持 3 秒,viduq3-mix 最低支持 1 秒。请根据所选模型传入有效时长。

resolution string

视频分辨率

  • viduq3-mix:720p(默认)/ 1080p
  • viduq3:540p / 720p(默认)/ 1080p

警告



viduq3-mix 不支持 540p,请使用 720p 或 1080p。

aspect_ratio string

视频宽高比

可选值:

  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
  • 4:3 - 传统比例
  • 3:4 - 竖版传统比例
  • 1:1 - 方形
seed integer

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

不传则随机生成。

注意



相同参数下使用相同 seed 值会生成类似的结果,但不保证完全一致。

模型对比

特性 viduq3 viduq3-mix
推荐场景 日常使用、多机位镜头切换 冲画质、1-2 秒动效
时长范围 3-16 秒 1-16 秒
分辨率 540p / 720p / 1080p 720p / 1080p
参考图数量 1-7 张 1-7 张

响应

code integer

响应状态码,成功时为 200

data array
返回数据数组
status string

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

task_id string

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

使用场景

场景 1:viduq3 基础参考生视频

{
  "model": "viduq3",
  "prompt": "圣诞老人与熊在湖边相拥",
  "image_urls": [
    "https://example.com/santa.png",
    "https://example.com/bear.png"
  ]
}

场景 2:viduq3-mix 高画质参考生视频

{
  "model": "viduq3-mix",
  "prompt": "参考图中的猫走过赛博朋克霓虹街道",
  "image_urls": [
    "https://example.com/cat-1.png",
    "https://example.com/cat-2.png",
    "https://example.com/cat-3.png"
  ],
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "seed": 42
}
注意

查询任务结果

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