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

按使用量付費

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

解析度RouterBase官方節省
generation $0.340$0.400−15%

預設配置（generation）單次呼叫 $0.340。$1 大約可以呼叫本模型 2 次。

客戶故事

團隊用 Vidu Q1 API 做什麼

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

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 到 RouterBase，傳入 reference_images。Vidu Q1 API 讓我的遊戲角色在十條影片裡保持一致。

Ethan Nguyen
Ethan Nguyen工程負責人, Compound Studio

RouterBase 一把 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 片段中保持身份與角色一致性——這與只動畫化單張輸入圖的圖生影片不同。當角色需要在許多條影片裡保持可辨識時，它就是正確選擇。