用於一致性影片生成的 Vidu Q3 Reference API

透過獨立的 GoEnhance 開放 API 存取 Vidu Q3 參考功能。提供 1 至 7 張參考圖片及提示詞,提交非同步影片任務,隨後使用回傳的 img_uuid 進行輪詢,或接收狀態回調。
獲取 API 金鑰
展現參考圖轉影片一致性的電影感湖畔場景

建立 Vidu Q3 Reference API 請求

為一致性而打造的參考圖像輸入

POST 至 https://api.goenhance.ai/api/v1/videos/generations,並使用 model: viduq3_reference、必要的提示詞,以及包含 1–7 張公開參考圖像的 image_urls。
用於視覺參考的無品牌角色模型擺設

已驗證的請求與非同步結果

提交前請驗證圖像格式、尺寸、長寬比、時長、解析度與輸出比例。保留 img_uuid,然後輪詢 GET /api/v1/jobs/detail 或使用公開的 HTTPS 回調。
代表非同步生產工作流程的電影攝影機設備
提交任務前,請確保符合文件中的參考轉影片請求架構。

Vidu Q3 Reference API 功能與限制

模型與提示詞

將 model 設定為 viduq3_reference 並提供描述預期影片的必要文字提示詞。

參考圖像

在 image_urls 中發送 1–7 個 URL。每張圖像必須為 PNG、JPEG、JPG 或 WebP 格式;至少 128×128 像素;不超過 50 MB;且長寬比介於 1:4 與 4:1 之間。

專用輸入模式

此路由接受 image_urls,而非 image_url 或 image_end_url。若需純文字、首幀或首尾幀生成,請使用 viduq3_pro。

時長

選擇 3 到 16 秒之間的整數。文件預設值為 5 秒。

解析度

選擇 540p、720p 或 1080p。文件預設值為 720p。

輸出比例

將 ratio 設定為 16:9、9:16 或 1:1;文件預設值為 16:9。aspect_ratio 可作為相容的別名使用。
預估成本為所選的每秒費率乘以請求的持續時間。

Vidu Q3 Reference API 定價

540p

每生成一秒消耗 1.75 個代幣,按文件規定的每代幣 $0.02 費率計算,等於每秒 $0.035。

720p

每生成一秒消耗 3 個代幣,按文件規定的每代幣 $0.02 費率計算,等於每秒 $0.06。

1080p

每生成一秒消耗 3.75 個代幣,按文件規定的每代幣 $0.02 費率計算,等於每秒 $0.075。

透過六個步驟整合 Vidu Q3 Reference

1

1. 建立 API 金鑰

建立一個 GoEnhance 金鑰,並將其作為 Authorization 標頭中的 bearer token 發送。
2

2. 準備參考資料

在公開網址託管 1 至 7 張符合規範的參考圖片,並決定提示詞應保留哪些視覺細節。
3

3. 驗證請求

設定 viduq3_reference、3 至 16 秒的持續時間、支援的解析度以及支援的比例。
4

4. 提交任務

向 /api/v1/videos/generations 發送 POST 請求,並保存回傳的 img_uuid。
5

5. 追蹤狀態

輪詢 GET /api/v1/jobs/detail 或設定公開的 HTTPS custom_callback_url。
6

6. 處理完成

以冪等方式處理成功與失敗狀態,並在後續使用前驗證生成的資產。
取得 API 金鑰
圍繞明確的輸入與終端任務狀態,建立可重複的「參考轉影片」工作流程。

Vidu Q3 Reference API 的開發者使用案例

角色導向的宣傳短片

將核准的虛構角色或人才參考資料應用於短篇宣傳影片概念中。

產品識別序列

使用多個核准的產品視角作為視覺參考,進行以動態為核心的創意探索。

故事連貫性

在為分鏡腳本與預覽工作流程生成獨立鏡頭時,參考重複出現的主體。

在地化創意變體

在調整區域性宣傳概念的提示詞時,重複使用核准的視覺參考資料。

風格一致的社群媒體素材

圍繞一組受控的視覺參考與輸出比例,建立短影音工作流程。

創意原型製作

在投入更廣泛的製作工作流程之前,先測試參考組合、提示詞、持續時間與解析度。
關於定價、參考輸入、非同步任務以及生數 API 常見問題的解答。

Vidu Q3 Reference API 常見問題

GoEnhance 上的 Vidu Q3 Reference API 端點是什麼?

提交 POST https://api.goenhance.ai/api/v1/videos/generations 並將 model 設定為 viduq3_reference。成功提交後會回傳 img_uuid 以供非同步追蹤。

Vidu Q3 Reference API 的定價方式為何?

定價按生成秒數計算:540p 為 1.75 tokens/秒($0.035/秒),720p 為 3 tokens/秒($0.06/秒),1080p 為 3.75 tokens/秒($0.075/秒)。將所選費率乘以持續時間即可。

我可以發送多少張參考圖片?

文件中規定的 image_urls 陣列需要 1 至 7 張圖片。每張圖片都必須符合發布的格式、大小、尺寸與長寬比限制。

我可以發送 image_url 或 image_end_url 嗎?

不行。此專用參考路由僅接受 image_urls。請使用另行記載的 viduq3_pro 路由進行文字轉影片、首幀圖片轉影片或首尾幀生成。

支援哪些持續時間、解析度與比例數值?

時長為 3–16 秒。解析度支援 540p、720p 和 1080p。比例支援 16:9、9:16 和 1:1。

我該如何得知影片何時完成?

請保留 img_uuid 並輪詢 GET /api/v1/jobs/detail,或提供一個公開的 HTTPS custom_callback_url。若回呼回應非 200,系統將重試最多三次,每次嘗試的逾時時間為三秒。

這是官方的生數 API 嗎?

不是。Vidu 由生數科技開發。本頁面說明的是透過 GoEnhance 進行的獨立第三方 API 存取,並不代表任何關聯、合作或背書。

Vidu Q3 Reference 與 Turbo 參考層級有何不同?

本頁面涵蓋標準的 viduq3_reference 路由。另有文件說明的 viduq3_turbo_reference 路由是速度更快、價格更低的參考層級;請勿將其模型識別碼或定價混入此請求中。

開始使用 Vidu Q3 Reference API 進行開發

Vidu Q3 Reference API 定價與指南 | GoEnhance