ai_dance_replace，將參考舞蹈影片中的人物替換為單一來源影像中的人物，同時保留參考動作。提交非同步任務、儲存其 img_uuid，然後輪詢或使用回呼以取得完成狀態。適用於動作驅動影片的 AI Dance Replace API
透過 GoEnhance API 存取
取得 API 金鑰
建立人物替換的舞蹈影片工作流程
提交前請驗證確切的模型識別碼、媒體 URL 與輸出解析度。
AI Dance Replace API 功能與輸入
確切的模型識別碼
將 <code>model</code> 設為 <code>ai_dance_replace</code>；這是必填的請求欄位。
必填的人物影像
將 <code>image_url</code> 作為有效公開 URI 傳入，用於指定將出現在輸出中的人物。
必填的舞蹈影片
將 <code>video_url</code> 作為公開參考影片傳入，長度不得超過文件規定的 30 秒上限。
兩種解析度選項
選擇 <code>480p</code> 或 <code>720p</code>。文件規定的預設值為 <code>480p</code>。
選用回呼傳遞
新增公開的 HTTPS <code>custom_callback_url</code>，以接收處理中、成功與失敗的更新。
非同步任務回應
成功提交會傳回 <code>img_uuid</code>；請保存它以供狀態檢查與結果處理使用。
計費採用輸入影片經無條件進位後的時長。請根據所選解析度與計費秒數計算成本。
AI Dance Replace API 計價
480p 計價
輸入影片每秒 2 個 token，等於每秒 $0.04，或每 5 秒 $0.20（每個 token $0.02）。
720p 計價
輸入影片每秒 4 個 token，等於每秒 $0.08，或每 5 秒 $0.40（每個 token $0.02）。
依時長計費
輸入影片的時長會無條件進位以計費；請以計費秒數乘以所選費率來估算成本。
以六個步驟整合 GoEnhance API
1
1. 建立 API 金鑰
建立 GoEnhance API 金鑰，並在 Authorization 標頭中作為 bearer token 傳送。
2
2. 驗證兩個媒體 URL
確認人物圖片與舞蹈影片可公開存取，且影片長度不超過 30 秒。
3
3. 建立請求
設定
model: ai_dance_replace，加入 image_url 與 video_url，然後選擇 480p 或 720p。 4
4. 提交任務
將 JSON 主體 POST 至
https://api.goenhance.ai/api/v1/videos/generations。 5
5. 持久化並追蹤
儲存回傳的
img_uuid，然後輪詢 GET /api/v1/jobs/detail 或接收回呼事件。 6
6. 處理最終狀態
以冪等方式處理成功與失敗，驗證回傳的資產，並避免重複下游工作。
使用具備同意感知的媒體管線，用於創作者工具、活動製作與可重複的影片自動化。
舞蹈替換影片的開發者使用案例
創作者舞蹈範本
讓使用者能在引導式創作流程中，將已核准的人物圖片套用到有授權的參考舞蹈。
活動影片變體
從已核准的來源媒體產生主體變體，供內部審查與後續編輯使用。
角色表演測試
在正式製作前，探索提供的角色圖片如何跟隨現有的動作參考。
本地化創作者資產
將同一個已核准的舞蹈參考搭配不同的授權主體，用於區域內容管線。
自動化內容佇列
將任務 ID 與回呼連接到批次編排，而不阻塞應用程式的請求執行緒。
製作動作體驗原型
在投入自訂拍攝管線之前，先驗證「影像 + 動作」的產品概念。
常見輸入、定價、狀態、回呼與整合問題的解答。