DragonAPI

切换主题

Vidu Q3 视频生成 ​

使用 DragonAPI 密钥和本站接口。示例中的 your-media.example 是占位地址，需替换为你自己的可访问素材或回调地址。协议、可用性与价格以当前模型说明和控制台为准。

使用 Vidu Q3 系列模型生成视频，支持文生视频、图生视频、首尾帧、参考生成和 Subjects 生成

  • 异步任务接口，提交后返回任务 ID
  • 支持模型：viduq3-pro、viduq3-turbo、viduq3
  • viduq3-pro：高质量模型，支持音视频同步和分镜视频生成
  • viduq3-turbo：快速模型，支持智能场景切换，生成速度最快，性价比最高
  • viduq3：多机位一致性最优，支持智能镜头切换和多参考图生成

请传入公网可访问的图片 URL。不要在 image_urls 中直接传 base64 图片数据；本地图片请先保存到可公开访问的 HTTPS 地址。

认证 ​

Authorization ​

string · 必填

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

text
Authorization: Bearer YOUR_DRAGONAPI_KEY

请求参数 ​

model ​

string · 必填

Vidu Q3 模型名称。

可选值：

  • viduq3-pro - 高质量模型，支持音视频同步和分镜视频生成
  • viduq3-turbo - 快速模型，支持智能场景切换，生成速度最快
  • viduq3 - 多机位一致性最优，适用于多参考图/Subjects 生成

prompt ​

string · 必填

视频提示词，最大 5000 字符 。

描述主体、动作、场景、镜头和风格。使用 subjects 时可通过 @name 引用主体。

示例："一只猫咪在弹钢琴，镜头缓缓推近，电影质感"

duration ​

integer · 可选 · 默认 5

视频时长，单位秒。

  • viduq3-pro / viduq3-turbo：1 到 16
  • viduq3：3 到 16

resolution ​

string · 可选 · 默认 720p

视频分辨率。

可选值：

  • 540p
  • 720p
  • 1080p

aspect_ratio ​

string · 可选

视频宽高比。

常用值：16:9、9:16、1:1

Q3 系列模型支持任意宽高比。传入 image_urls 时，宽高比通常由参考图片决定。

image_urls ​

string[] · 可选

参考图片 URL 数组。

  • viduq3-pro / viduq3-turbo
  • 不传：文生视频
  • 传 1 张：图生视频，图片作为首帧
  • 传 2 张：首尾帧，第一张为首帧，第二张为尾帧
  • viduq3
  • 必填，最多 7 张参考图片

示例：["https://your-media.example/reference.jpg"]

audio ​

boolean · 可选

是否启用音视频输出。

  • 所有 Q3 模型默认 true

设为 true 时，系统根据提示词生成语音和背景音效。

seed ​

integer · 可选

随机种子，用于在相同参数下复现相近结果。

metadata ​

object · 可选

扩展参数，用于传递官方 API 支持但未作为顶层字段暴露的参数。

显示 metadata 字段

subjects ​

array · 可选

主体列表（Subjects 模式，仅 viduq3 支持）。每个主体包含 name 和 images 字段。

  • 最多 7 个主体
  • 每个主体最多 3 张图片
  • 使用时在 prompt 中通过 @name 引用主体

示例：

json
    [
      {"name": "cat", "images": ["https://your-media.example/cat.jpg"]},
      {"name": "dog", "images": ["https://your-media.example/dog.jpg"]}
    ]

auto_subjects ​

boolean · 可选

是否启用智能实体库能力，默认 false。

voice_id ​

string · 可选

语音 ID，用于指定视频中的语音角色。系统会自动推荐合适的语音。

audio_type ​

string · 可选

音频类型，audio 为 true 时有效。

可选值：

  • all - 音效+人声（默认）
  • speech_only - 仅人声
  • sound-effect_only - 仅音效

off_peak ​

boolean · 可选

闲时模式，默认 false。

  • true：闲时生成，消耗更少积分
  • 闲时任务将在 48 小时内生成，未完成自动取消并退还积分
  • Q3 模型在 audio=true 时支持闲时任务

payload ​

string · 可选

透传参数，不做处理仅传递数据，最大 1048576 字符。

callback_url ​

string · 可选

DragonAPI 最终任务 Webhook。需先配置 Token URL 和签名密钥；详见 任务日志。

模型选择 ​

模型适用场景图片输入分辨率时长
viduq3-pro高质量文生/图生/首尾帧可选，最多 2 张540p / 720p / 1080p1-16s
viduq3-turbo快速文生/图生/首尾帧可选，最多 2 张540p / 720p / 1080p1-16s
viduq3多参考图/Subjects 生成必填，最多 7 张540p / 720p / 1080p3-16s

响应 ​

id ​

string · 可选

任务 ID，用于查询任务状态。

object ​

string · 可选

对象类型，通常为 generation.task。

model ​

string · 可选

本次请求使用的模型名称。

status ​

string · 可选

任务状态：queued、in_progress、completed 或 failed。

created_at ​

integer · 可选

任务创建时间戳。

示例 ​

文生视频 ​

json
{
"model": "viduq3-pro",
"prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
"duration": 8,
"resolution": "1080p",
"aspect_ratio": "16:9",
"audio": true
}

图生视频 ​

json
{
"model": "viduq3-turbo",
"prompt": "让图片中的人物缓缓转身并微笑",
"image_urls": ["https://your-media.example/portrait.jpg"],
"duration": 5,
"resolution": "720p"
}

首尾帧 ​

json
{
"model": "viduq3-pro",
"prompt": "人物从站立自然坐下，动作流畅",
"image_urls": [
  "https://your-media.example/first-frame.jpg",
  "https://your-media.example/last-frame.jpg"
],
"duration": 8,
"resolution": "720p"
}

多参考图生成视频 ​

json
{
"model": "viduq3",
"prompt": "保持参考图中的角色一致，在未来城市街道中行走",
"image_urls": [
  "https://your-media.example/character-front.jpg",
  "https://your-media.example/character-side.jpg"
],
"duration": 6,
"resolution": "1080p"
}

Subjects 模式 ​

json
{
"model": "viduq3",
"prompt": "@cat 和 @dog 在公园里奔跑，阳光明媚",
"image_urls": ["https://your-media.example/park-bg.jpg"],
"duration": 8,
"resolution": "720p",
"audio": true,
"metadata": {
  "subjects": [
    {"name": "cat", "images": ["https://your-media.example/cat.jpg"]},
    {"name": "dog", "images": ["https://your-media.example/dog.jpg"]}
  ],
  "audio_type": "all"
}
}

视频生成为异步任务。提交后使用 统一任务查询接口 查询进度和结果。

curl --request POST \
  --url https://newapi.dragon3api.com/v1/videos \
  --header 'Authorization: Bearer YOUR_DRAGONAPI_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "audio": true
  }'
import requests

response = requests.post(
    "https://newapi.dragon3api.com/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_DRAGONAPI_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "viduq3-pro",
        "prompt": "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
        "duration": 8,
        "resolution": "1080p",
        "aspect_ratio": "16:9",
        "audio": True,
    },
)

print(response.json())
const response = await fetch("https://newapi.dragon3api.com/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_DRAGONAPI_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "viduq3-pro",
    prompt: "一只猫咪在弹钢琴，镜头缓缓推近，电影质感",
    duration: 8,
    resolution: "1080p",
    aspect_ratio: "16:9",
    audio: true
  })
});

console.log(await response.json());

模型、价格与服务规则以当前控制台为准。

DragonAPI