img_uuid，然後進行輪詢或接收回調，直到任務成功或失敗為止。用於影片生成的 Vidu Q3 Pro API
透過獨立的 GoEnhance 開放 API 存取 Vidu Q3 Pro，進行文字轉影片、圖片轉影片以及首尾影格生成。提交一項非同步請求，保留回傳的
取得 API 金鑰
建立清晰的 Vidu Q3 Pro API 請求
單一端點支援三種輸入模式
使用 model: viduq3_pro 對 https://api.goenhance.ai/api/v1/videos/generations 發送 POST 請求。僅使用提示詞進行文字轉影片，加入 image_url 作為首影格，或加入 image_end_url 進行首尾影格生成。
明確的控制與非同步完成機制
在提交前驗證持續時間、解析度與文字轉影片比例。儲存回傳的任務 ID，然後使用 GET /api/v1/jobs/detail 或公開的 HTTPS custom_callback_url 來處理最終結果。
在任務進入您的影片管線前，請確保符合文件中的請求架構。
Vidu Q3 Pro API 功能與參數
模型
將 <code>model</code> 設定為 <code>viduq3_pro</code>。
提示詞
提供描述預期影片所需的文字提示詞。
首影格
加入公開的 <code>image_url</code> 進行圖片轉影片生成；若為文字轉影片則省略此項。
末影格
將 <code>image_end_url</code> 與 <code>image_url</code> 一起加入，以進行首尾影格控制。
持續時間
選擇 1 到 16 秒之間的整數。文件預設值為 5 秒。
解析度與比例
解析度支援 540p、720p 或 1080p，預設為 720p。<code>ratio</code> 欄位適用於文字轉影片請求。
估算生成成本的方式為：所選的每秒費率乘以請求的持續時間。
Vidu Q3 Pro API 定價
540p
每生成一秒消耗 2.25 個代幣，按文件記載每代幣 $0.02 的費率計算，等於每秒 $0.045。
720p
每生成一秒消耗 5 個代幣，按文件記載每代幣 $0.02 的費率計算，等於每秒 $0.10。
1080p
每生成一秒消耗 6 個代幣，按文件記載每代幣 $0.02 的費率計算，等於每秒 $0.12。
透過六個步驟整合 Vidu Q3 Pro
1
1. 建立 API 金鑰
建立一個 GoEnhance 金鑰，並將其作為 Authorization 標頭中的 bearer token 發送。
2
2. 選擇輸入模式
僅使用提示詞、加入首幀 URL，或同時加入首幀與末幀 URL。
3
3. 驗證請求
設定
viduq3_pro、1 至 16 秒的持續時間，以及其中一個已記錄的解析度值。 4
4. 提交影片任務
向
/api/v1/videos/generations 發送 POST 請求，並保存回傳的 img_uuid。 5
5. 追蹤狀態
輪詢
GET /api/v1/jobs/detail 或設定一個公開的 HTTPS 回呼 URL。 6
6. 處理完成狀態
以冪等方式處理成功與失敗狀態，並在下游使用前驗證回傳的資產。
圍繞明確的輸入與終端任務狀態，建立可重複的影片生成工作流程。
Vidu Q3 Pro API 的開發者使用案例
行銷影片變體
從結構化提示詞生成簡短的概念短片，以供創意審核與後續組裝使用。
產品動態
在您的應用程式控制提示詞、驗證與資產審核的同時，為已核准的產品畫面製作動畫。
分鏡轉場
使用首幀與末幀輸入，探索兩個已核准視覺節點之間的動態效果。
在地化創意流程
為區域行銷變體參數化提示詞，無需更改非同步任務處理器。
社群影片製作
以您的應用程式所選的解析度與持續時間，建立簡短的動態資產。
預覽製作
在全面製作前，將簡潔的鏡頭描述轉化為可供審核的動態概念。
關於定價、輸入、任務狀態以及生數影片 API 常見問題的解答。