video_generate.vidu_q1_r2v_novita
vidu/vidu-q1/reference-to-video
reference-to-video

Vidu Q1 API 从参考图和可选提示词生成视频（Vidu Q1）——固定 5 秒 1080p 输出，跨帧保持人物/形象一致性，运动幅度可调（自动 / 小 / 中 / 大），可选背景音乐，支持可复现 seed——全部通过兼容 OpenAI 的单一 REST 接口完成，比官方价低 15%。

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

Vidu Q1 API：参考图生视频

使用 Vidu Q1 API 从主体参考图生成形象一致的 5 秒 1080p 视频片段。

Vidu Q1 API（video_generate.vidu_q1_r2v_novita）从参考图和可选的自然语言提示词生成 5 秒 1080p 视频片段。每次 Vidu Q1 API 调用都会用你提供的参考图锁定主体的身份与外貌，输出时间上高度一致的画面，运动幅度可调（auto/small/medium/large），并支持可选背景音乐，全部通过兼容 OpenAI 的单一 REST 接口完成。Vidu Q1 API 专为角色驱动的创作打造——虚拟人、吉祥物或游戏主角——它会先读取整组参考图锁定身份，然后再渲染，让同一张脸和同一套服装在每一帧都保持不变。

Vidu Q1 API 的价格是每次生成 ¥0.34——比官方公开价低 15%。Vidu Q1 API 只用一把 VibeToken key，无需 Vidu 专属 SDK，也无需单独开户。由于该接口异步且兼容 OpenAI，你可以把任务排在一起通宵批量渲染，最后从 CDN URL 拉取全部成片。

为什么选这个模型

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

从参考图形象一致性到单次调用的运动控制——Vidu Q1 API 做对了哪些事。

形象一致性

提供参考图，模型在整个 5 秒 1080p 片段中保持主体的脸部、服装和身材比例，让角色在不同镜头间始终不走样。

5 秒 1080p 视频

每次 Vidu Q1 API 调用都生成 5 秒 1080p 视频——固定时长消除了编码上的猜测，让整批任务的成本与存储都可预测。

运动幅度控制

每次调用传入 auto/small/medium/large。small 让肖像保持稳定，large 驱动动作，auto 则让模型依据场景自行决定动感。

可选背景音乐

在请求中设置 bgm=true 即可为片段自动配上合适的 BGM；省略该参数则输出静音，方便你自行配音。

¥0.34/次

比官方公开价低 15%——无论运动幅度、参考图数量还是 BGM 设置，都是每次统一计价，支出稳定可控。

兼容 OpenAI 的 REST

一个端点、一把 key——Vidu Q1 API 与 VibeToken 上每个模型使用相同的 JSON 结构和 Bearer 认证头，切换过来只需改一个 model ID。

RouterBase dashboard preview
快速上手

三步开始使用 Vidu Q1 API

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

  1. 上传参考图

    把主体图片托管到公开 URL——接口接受一张或多张参考图 URL，多提供几个角度能让身份一致性更牢。

  2. POST 到 Vidu Q1 API 端点

    在 JSON 里发送 reference_images、可选 prompt、motion_amplitude 和 bgm，POST 到 /v1/images/generations。接口立即返回异步任务 id；轮询 GET /v1/images/generations/{id} 直到 status=success。

  3. 下载视频

    成功响应会在 results 数组中给出一个签名 CDN URL。把它放进 <video> 标签或复制到你自己的存储桶——5 秒 1080p 的 MP4 无需后处理即可使用。

Get API Key Read docs
定价

按使用量付费

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

分辨率VibeToken官方节省
5s · 1080p fixed¥0.340¥0.400−15%

本次请求费用 ¥0.340（5s · 1080p）。¥1 大约可以调用本模型 2 次。

官方价 = Vidu Q1 参考图生视频公开价格。VibeToken 透传每次生成节省 15%。

客户故事

团队用 Vidu Q1 API 做什么

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

Marcus Reyes
Marcus ReyesCTO, Paradigm AI

把参考图接入 Vidu Q1 API，每条视频的头像始终保持一致。这是我们以前从未实现过的一致性。

Priya Lakshmi
Priya Lakshmi创始人, Quillo

一张参考照片、一次 Vidu Q1 API 调用——同一角色、5 秒视频，90 秒上线。达人团队超喜欢。

Thomas Beck
Thomas Beck资深工程师, Northbeam

Vidu Q1 API 的参考图生视频让我们不再为连续性重复上传帧。一张照片，搞定。

Aoi Tanaka
Aoi TanakaML 负责人, Daybreak Robotics

每晚把参考图推给 Vidu Q1 API。BGM 开着，运动幅度 auto——每天早上角色都完好如初。

Jonas Keller
Jonas Keller独立开发者

切换 base URL 到 VibeToken，传入 reference_images。Vidu Q1 API 让我的游戏角色在十条视频里保持一致。

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

VibeToken 一把 key 搞定 200+ 模型。Vidu Q1 API 参考图生视频是我们品牌团队每个 sprint 都要排的。

Sophia Martín
Sophia MartínCTO, Relay

¥0.34/条在广告预算里跑得下去——发言人在每条视频里都一样。

Lucas Fernandes
Lucas Fernandes工程经理, Light

同样的 JSON 结构，换个 model ID。Vidu Q1 API 参考图生视频是我们 42 个服务迁移中最顺的一个。

David Okonkwo
David Okonkwo联合创始人, Figment

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

常见问题

关于 Vidu Q1 API 参考图生视频任务的常见问题。

Vidu Q1 API 参考图生视频任务使用主体的参考图，在生成的 5 秒 1080p 片段中保持身份与角色一致性——这与只动画化单张输入图的图生视频不同。当角色需要在许多条视频里保持可辨识时，它就是正确选择。