img_uuid 進行輪詢，或接收狀態回調。用於一致性影片生成的 Vidu Q3 Reference API
透過獨立的 GoEnhance 開放 API 存取 Vidu Q3 參考功能。提供 1 至 7 張參考圖片及提示詞，提交非同步影片任務，隨後使用回傳的
獲取 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 功能與限制
模型與提示詞
將 <code>model</code> 設定為 <code>viduq3_reference</code> 並提供描述預期影片的必要文字提示詞。
參考圖像
在 <code>image_urls</code> 中發送 1–7 個 URL。每張圖像必須為 PNG、JPEG、JPG 或 WebP 格式；至少 128×128 像素；不超過 50 MB；且長寬比介於 1:4 與 4:1 之間。
專用輸入模式
此路由接受 <code>image_urls</code>，而非 <code>image_url</code> 或 <code>image_end_url</code>。若需純文字、首幀或首尾幀生成，請使用 <code>viduq3_pro</code>。
時長
選擇 3 到 16 秒之間的整數。文件預設值為 5 秒。
解析度
選擇 <code>540p</code>、<code>720p</code> 或 <code>1080p</code>。文件預設值為 <code>720p</code>。
輸出比例
將 <code>ratio</code> 設定為 <code>16:9</code>、<code>9:16</code> 或 <code>1:1</code>；文件預設值為 <code>16:9</code>。<code>aspect_ratio</code> 可作為相容的別名使用。
預估成本為所選的每秒費率乘以請求的持續時間。
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. 處理完成
以冪等方式處理成功與失敗狀態，並在後續使用前驗證生成的資產。
圍繞明確的輸入與終端任務狀態，建立可重複的「參考轉影片」工作流程。
Vidu Q3 Reference API 的開發者使用案例
角色導向的宣傳短片
將核准的虛構角色或人才參考資料應用於短篇宣傳影片概念中。
產品識別序列
使用多個核准的產品視角作為視覺參考，進行以動態為核心的創意探索。
故事連貫性
在為分鏡腳本與預覽工作流程生成獨立鏡頭時，參考重複出現的主體。
在地化創意變體
在調整區域性宣傳概念的提示詞時，重複使用核准的視覺參考資料。
風格一致的社群媒體素材
圍繞一組受控的視覺參考與輸出比例，建立短影音工作流程。
創意原型製作
在投入更廣泛的製作工作流程之前，先測試參考組合、提示詞、持續時間與解析度。
關於定價、參考輸入、非同步任務以及生數 API 常見問題的解答。