img_uuid を保存して、ポーリングまたは HTTPS コールバックで非同期結果を処理します。AIダンスムーブAPI
GoEnhance 経由で AI Dance Move API を使用して、1 枚のソース画像内の人物を参照ダンス動画のモーションでアニメーション化します。両方の公開 URL を送信し、480p または 720p を選択し、返された
API キーを作成
参照ダンスモーションでポートレートを駆動します。
1枚のソース画像がダンサーを定義します。
必須の公開image_urlを送信してください。その画像の人物が生成されるダンスビデオの被写体になります。そのため、動作の判読性が重要な場合は、鮮明で障害物のない全身のソースを使用してください。
1つの参照ビデオが動きを提供します。
追従するダンスモーションを含む必須の公開video_urlを送信してください。ドキュメントに記載されている最大入力動画の長さは30秒です。それより長い参照は拒否されます。
送信前に、ソースURL、再生時間、解像度、および完了処理を検証してください。
AIダンスムーブAPIの機能と制限
正確なモデル識別子
このルートでは、<code>model</code> を <code>ai_dance_move</code> に設定します。
必須のメディアURLが2つ
人物の<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トークン/秒
5秒の入力は10トークンで、現在のGoEnhanceドキュメントでは$0.20と記載されています。
720p: 秒間4トークン
5秒の入力は20トークンであり、現在のGoEnhanceドキュメントでは$0.40と記載されています。
入力時間から推定
入力動画の長さを1秒単位に切り上げ、その後、480pの場合は2トークン、720pの場合は4トークンを掛けます。本番バッチの前に、最新の料金リファレンスを確認してください。
AI Dance Move API統合の6ステップ
1
1. API キーを作成して安全に保管する
GoEnhanceキーを作成し、信頼できるサーバーサイドコードから認証を送信します。
2
2. ソースメディアをホストする
人物画像1枚と、30秒以内の参照用ダンス動画1本について、公開アクセス可能なURLを指定してください。
3
3. リクエストの作成
https://api.goenhance.ai/api/v1/videos/generations に model: ai_dance_move、両方のURL、および480pまたは720pの解像度を指定してPOSTします。 4
4. タスクIDの保存
レスポンスレベルの成功を確認し、リクエストハンドラを離れる前に、返された
data.img_uuid を永続化してください。 5
5. 全ステータスの追跡
GET /api/v1/jobs/detail をポーリングするか、公開HTTPSコールバックURLで処理中・成功・失敗イベントを受信します。 6
6. 最終結果の処理
成功と失敗を冪等に処理し、返されたメディアを検証し、ポーリングとコールバックが重複する際に下流の処理が重複しないようにしてください。
使用権限のあるソースメディアを中心に、制御されたモーショントランスファーワークフローを構築します。
AI Dance Move API のユースケース
クリエイター向けダンスクリップ
承認済みの全身ポートレートを、選択した参照ルーティンに基づく短いダンスコンセプトに変換します。
キャラクターのモーションスタディ
大規模な制作の前に、オリジナルキャラクターやパフォーマーが動きの中でどう見えるかをテストします。
キャンペーンコンセプトのバリエーション
ソース画像と承認済みの振付リファレンスを、クリエイティブレビューキュー向けにパラメータ化します。
ミュージックビデオのプリビジュアライゼーション
実際の撮影や編集に時間を投入する前に、ダンスの演出とフレーミングを検討します。
ローカライズされたソーシャルクリエイティブ
地域ごとのソースアセットを、検証済みの単一の送信・完了パイプラインで処理します。
自動化されたメディアワークフロー
アプリケーション内で、生成、タスク状態の永続化、コールバック処理、ストレージ、人間による承認を接続します。
入力、料金、時間、解像度、非同期配信についての回答。