AI Dance Move API

透過 GoEnhance 使用 AI Dance Move API,以參考舞蹈影片的動作,讓單張來源圖片中的人物動起來。提交兩個公開 URL,選擇 480p 或 720p,儲存回傳的 img_uuid,並透過輪詢或 HTTPS 回呼處理非同步結果。
建立 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. 建立並妥善保管 API 金鑰
1

1. 建立並妥善保管 API 金鑰

建立 GoEnhance 金鑰,並從可信的伺服器端程式碼傳送授權。
2. 託管來源媒體
2

2. 託管來源媒體

提供一張人物圖片與一支參考舞蹈影片的公開可存取 URL,影片長度不超過 30 秒。
3. 建立請求
3

3. 建立請求

https://api.goenhance.ai/api/v1/videos/generations 發送 POST,並帶上 model: ai_dance_move、兩個 URL,以及 480p 或 720p 解析度。
4. 儲存任務識別碼
4

4. 儲存任務識別碼

確認回應層級的成功,並在離開請求處理常式前,將回傳的 data.img_uuid 持久化儲存。
5. 追蹤每一種狀態
5

5. 追蹤每一種狀態

輪詢 GET /api/v1/jobs/detail,或透過公開的 HTTPS 回呼 URL 接收處理中、成功與失敗事件。
6. 處理最終結果
6

6. 處理最終結果

以冪等方式處理成功與失敗結果,驗證回傳的媒體,並在輪詢與回呼重疊時避免重複的下游作業。
圍繞你有權使用的來源媒體,建置受控的動作轉移工作流程。

AI Dance Move API 使用案例

創作者舞蹈短影音

將已核准的全身人像照,轉化為由所選參考舞步驅動的短舞蹈概念。

角色動作研究

在較大型的製作前,測試原創角色或表演者在動態中的呈現效果。

行銷活動概念變體

將來源圖片與已核准的編舞參考參數化,以供創意審查佇列使用。

音樂錄影帶預視

在投入時間進行正式拍攝或剪輯前,先探索舞蹈方向與取景。

在地化社群素材

讓在地來源素材通過單一已驗證的提交與完成管線。

自動化媒體工作流程

在應用程式中串接生成、任務狀態持久化、回呼處理、儲存與人工核准。
有關輸入、定價、時長、解析度與非同步傳遞的解答。

AI Dance Move API 常見問題

使用 AI Dance Move API 開發

AI Dance Move API 價格與整合 | GoEnhance