img_uuid,並透過輪詢或 HTTPS 回呼處理非同步結果。AI Dance Move API
透過 GoEnhance 使用 AI Dance Move API,以參考舞蹈影片的動作,讓單張來源圖片中的人物動起來。提交兩個公開 URL,選擇 480p 或 720p,儲存回傳的
建立 API Key
以參考舞蹈動作驅動人像
提交前驗證來源 URL、時長、解析度與完成處理流程。
AI Dance Move API 功能與限制
確切的模型識別碼
將此路由的 <code>model</code> 設為 <code>ai_dance_move</code>。
兩個必填媒體 URL
同時提供人物的 <code>image_url</code> 與參考舞蹈的 <code>video_url</code>。
30 秒輸入限制
參考舞蹈影片不得超過 30 秒;更長的輸入會被拒絕。
480p 或 720p 輸出
選擇 <code>480p</code> 或 <code>720p</code>。文件記載的預設值為 <code>480p</code>。
非同步任務 ID
成功提交會回傳 <code>data.img_uuid</code>,而非完成的影片。
輪詢或回呼
輪詢任務詳情端點,或提供公開的 HTTPS 回呼 URL 以接收狀態變更。
GoEnhance 以所選輸出解析度,按輸入參考影片進位後的每秒計費。
AI Dance Move API 價格
480p:每秒 2 個 tokens
五秒輸入為 10 tokens,在目前的 GoEnhance 文件中列為 $0.20。
720p:每秒 4 個 tokens
五秒輸入為 20 tokens,在目前的 GoEnhance 文件中列為 $0.40。
根據輸入時長估算
將輸入影片時長無條件進位到整秒,然後乘以 2 tokens(480p)或 4 tokens(720p)。在正式批次前檢查即時價格參考。
以六個步驟整合 AI Dance Move API
1
1. 建立並妥善保管 API 金鑰
建立 GoEnhance 金鑰,並從可信的伺服器端程式碼傳送授權。
2
2. 託管來源媒體
提供一張人物圖片與一支參考舞蹈影片的公開可存取 URL,影片長度不超過 30 秒。
3
3. 建立請求
向
https://api.goenhance.ai/api/v1/videos/generations 發送 POST,並帶上 model: ai_dance_move、兩個 URL,以及 480p 或 720p 解析度。 4
4. 儲存任務識別碼
確認回應層級的成功,並在離開請求處理常式前,將回傳的
data.img_uuid 持久化儲存。 5
5. 追蹤每一種狀態
輪詢
GET /api/v1/jobs/detail,或透過公開的 HTTPS 回呼 URL 接收處理中、成功與失敗事件。 6
6. 處理最終結果
以冪等方式處理成功與失敗結果,驗證回傳的媒體,並在輪詢與回呼重疊時避免重複的下游作業。
圍繞你有權使用的來源媒體,建置受控的動作轉移工作流程。
AI Dance Move API 使用案例
創作者舞蹈短影音
將已核准的全身人像照,轉化為由所選參考舞步驅動的短舞蹈概念。
角色動作研究
在較大型的製作前,測試原創角色或表演者在動態中的呈現效果。
行銷活動概念變體
將來源圖片與已核准的編舞參考參數化,以供創意審查佇列使用。
音樂錄影帶預視
在投入時間進行正式拍攝或剪輯前,先探索舞蹈方向與取景。
在地化社群素材
讓在地來源素材通過單一已驗證的提交與完成管線。
自動化媒體工作流程
在應用程式中串接生成、任務狀態持久化、回呼處理、儲存與人工核准。
有關輸入、定價、時長、解析度與非同步傳遞的解答。


