video_generate.vidu_q2_r2v_novita
vidu/vidu-q2/reference-to-video
reference-to-video

Vidu Q2 API 用参考主体和文本提示词生成视频（Vidu Q2），在整段画面中保持主体身份一致——时长 1-10 秒可变，最高 1080p，可控纵横比（16:9 / 9:16 / 1:1），运动幅度可调，可选背景音乐与音频，支持可复现 seed——全部通过兼容 OpenAI 的单一 REST 接口完成，比官方价低 15%。

输入
发送给模型的文本提示词
输出
Sample edited image — run the model to replace this previewSampleRun the model to replace this preview

Vidu Q2 API：参考主体生视频

使用 Vidu Q2 API 从参考主体生成形象一致的视频 —— 最高 1080p，时长 1-10 秒。

Vidu Q2 API（video_generate.vidu_q2_r2v_novita）从参考主体（人物、角色或物体）和自然语言提示词生成视频。每次调用在每一帧中保持主体身份和外貌一致，时长 1-10 秒可变，分辨率最高 1080p。纵横比（16:9 / 9:16 / 1:1）、运动幅度、可选背景音乐和音频均可通过兼容 OpenAI 的单一 REST 调用控制。当一个反复出现的角色、吉祥物或产品需要在多条片段中保持可辨识时，团队会选用 Vidu Q2 API，而可变时长让一次渲染既能适配六秒广告，也能适配十秒剪辑，无需再裁剪。

Vidu Q2 API 价格 ¥0.191/次 —— 比官方价 ¥0.225 低 15%。它使用一把 VibeToken key，无需单独 SDK 或账号，同样的 JSON 结构覆盖 200+ 其他模型。由于 Vidu Q2 API 异步且兼容 OpenAI，，你可以把参考主体生视频任务与其他生成一起排队，整夜批量渲染整组角色，并从签名 CDN URL 拉取成片。

为什么选这个模型

团队选择 Vidu Q2 API 的六个理由

从参考主体一致性到 1080p 输出 —— Vidu Q2 API 的优势。

参考主体一致性

提供参考主体，模型在每一帧中保持其面部、服装和比例稳定，让角色在各个镜头间始终贴合设定。

最高 1080p 分辨率

可在 540p、720p 或最高 1080p 中选择 —— 每次调用可指定分辨率，用 540p 低成本打样，用 1080p 交付成片。

1-10 秒可变时长

可设置 1 到 10 秒的任意时长。Vidu Q2 API 不锁死固定片长，一次渲染既能做短循环也能做较长的社媒剪辑，无需填充。

纵横比与运动

在单次 Vidu Q2 API 请求中选择 16:9、9:16 或 1:1，并调节运动幅度（auto、小、中、高）—— 每个平台一次调用，无需重剪。

可选 BGM、音频与 seed

开关背景音乐和音频，并传入整数 seed，让重试与审批间的结果可复现。

兼容 OpenAI 且低 15%

一个端点、一个 key，¥0.191/次 —— 比官方价低 15%，与 VibeToken 上每个模型使用相同 JSON 结构，切换只需改一个 model ID。

RouterBase dashboard preview
快速上手

三步开始使用 Vidu Q2 API

从注册到第一次 Vidu Q2 API 参考主体生视频调用，5 分钟以内。

  1. 定义参考主体

    描述要保持的人物、角色或物体，并作为 subjects 提供 —— 模型用它们锁定身份，干净、光线充足的参考能让一致性更精确。

  2. POST 到 Vidu Q2 API 端点

    在 JSON 里向 POST /v1/images/generations 发送 prompt、subjects 以及 duration、resolution、aspect_ratio 等选项。端点立即返回异步任务 id；轮询 GET /v1/images/generations/{id} 直到 status=success。

  3. 轮询并下载视频

    成功响应在 results 数组中包含签名 CDN URL。把它放进 <video> 标签或复制到自有存储桶 —— 无需后处理即可使用。

Get API Key Read docs
定价

按使用量付费

VibeToken 透传合作方价格，与模型官方公开 API 价格对比。

Size540p +¥0.021/s720p +¥0.021/s1080p +¥0.043/s
4s ¥0.128 ¥0.150¥0.170 ¥0.200¥0.446 ¥0.525
5s ¥0.149 ¥0.175¥0.191 ¥0.225¥0.489 ¥0.575
8s ¥0.212 ¥0.250¥0.255 ¥0.300¥0.616 ¥0.725
10s ¥0.255 ¥0.300¥0.297 ¥0.350¥0.701 ¥0.825

本次请求费用 ¥0.191（5s / 720p）。¥1 大约可以调用本模型 5 次。

官方价 = Vidu Q2 参考主体生视频公开价格（¥0.225）。VibeToken 透传每次生成节省 15%。

客户故事

团队用 Vidu Q2 API 做什么

运行在 Vidu Q2 API 和 VibeToken 模型目录上的真实生产负载。

Marcus Reyes
Marcus ReyesCTO, Paradigm AI

把参考主体接入 Vidu Q2 API，我们的角色在 1080p 下保持身份一致。这是我们以前做不到的一致性。

Priya Lakshmi
Priya Lakshmi创始人, Quillo

一次 Vidu Q2 API 调用、一段 9:16 视频、同一个角色 —— 我们的达人团队现在几分钟就能出片。

Thomas Beck
Thomas Beck资深工程师, Northbeam

1-10 秒可变时长意味着我们不再补帧或裁剪。Vidu Q2 API 给出的正是我们要的长度。

Aoi Tanaka
Aoi TanakaML 负责人, Daybreak Robotics

我们每晚在 Vidu Q2 API 上以 1080p 渲染并开启 BGM。每个主体到早上都完好如初。

Jonas Keller
Jonas Keller独立开发者

把 subjects 和 prompt 传给 Vidu Q2 API，我的游戏角色在十条视频里保持一致。

Ethan Nguyen
Ethan Nguyen工程负责人, Compound Studio

VibeToken 一把 key 搞定 200+ 模型。我们已把 Vidu Q2 API 参考主体生视频设为品牌团队默认。

Sophia Martín
Sophia MartínCTO, Relay

¥0.191/条的 Vidu Q2 API 在广告预算里跑得下去，纵横比控制让每个平台只需渲染一次。

Lucas Fernandes
Lucas Fernandes工程经理, Light

同样的 JSON 结构，换个 model ID。Vidu Q2 API 是我们 42 个服务迁移中最顺的补充。

David Okonkwo
David Okonkwo联合创始人, Figment

Vidu Q2 API 低 15% 的价格，等你每周生成几千条品牌一致视频时感受就不一样了。

常见问题

关于 Vidu Q2 API 参考主体生视频任务的常见问题。

Vidu Q2 API 参考主体生视频任务使用人物、角色或物体等参考主体，在生成的片段中保持身份和外貌一致。当同一主体需要在一系列视频中保持可辨识时，它是合适之选。