繁體中文
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%。它使用一把 RouterBase 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%，與 RouterBase 上每個模型使用相同 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
定價

按使用量付費

RouterBase 透傳合作方價格，與模型官方公開 API 價格對比。

解析度RouterBase官方節省
540p 5s$0.149$0.175−15%
720p 5s$0.191$0.225−15%
1080p 5s$0.489$0.575−15%
audio=true +$0.064+$0.075−15%

每秒約 $0.038。預設配置（720p）單次呼叫 $0.191。$1 大約可以呼叫本模型 5 次。

客戶故事

團隊用 Vidu Q2 API 做什麼

運行在 Vidu Q2 API 和 RouterBase 模型目錄上的真實生產負載。

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

RouterBase 一把 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 參考主體生影片任務使用人物、角色或物體等參考主體，在生成的片段中保持身份和外貌一致。當同一主體需要在一系列影片中保持可辨識時，它是合適之選。