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の機能と制限
正確なモデル識別子
このルートでは、
model を ai_dance_move に設定します。必須のメディアURLが2つ
人物の
image_urlと、参照ダンス用のvideo_urlの両方を指定してください。30秒の入力制限
参照用ダンス動画は30秒以内でなければなりません。それより長い入力は拒否されます。
480pまたは720p出力
480p または 720p を選択してください。ドキュメント上のデフォルトは 480p です。非同期タスクID
送信が成功すると、
data.img_uuid が返されます。完成した動画は返されません。ポーリングまたはコールバック
ジョブ詳細エンドポイントをポーリングするか、ステータス変更用の公開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 のユースケース
クリエイター向けダンスクリップ
承認済みの全身ポートレートを、選択した参照ルーティンに基づく短いダンスコンセプトに変換します。
キャラクターのモーションスタディ
大規模な制作の前に、オリジナルキャラクターやパフォーマーが動きの中でどう見えるかをテストします。
キャンペーンコンセプトのバリエーション
ソース画像と承認済みの振付リファレンスを、クリエイティブレビューキュー向けにパラメータ化します。
ミュージックビデオのプリビジュアライゼーション
実際の撮影や編集に時間を投入する前に、ダンスの演出とフレーミングを検討します。
ローカライズされたソーシャルクリエイティブ
地域ごとのソースアセットを、検証済みの単一の送信・完了パイプラインで処理します。
自動化されたメディアワークフロー
アプリケーション内で、生成、タスク状態の永続化、コールバック処理、ストレージ、人間による承認を接続します。
入力、料金、時間、解像度、非同期配信についての回答。
AI Dance Move API FAQ
AI Dance Move API はどのエンドポイントを使用しますか?
model を ai_dance_move に設定し、https://api.goenhance.ai/api/v1/videos/generations に認可されたPOSTリクエストを送信します。
必要な入力は何ですか?
リクエストには、人物用の image_url と、参照ダンス用の video_url が必要です。両方の値は有効なURLである必要があります。
AI Dance Move API の料金体系はどうなっていますか?
課金は、入力参照動画の時間を切り上げて計算します。480pでは1秒あたり2トークン、720pでは1秒あたり4トークンです。現在のドキュメントでは、5秒間がそれぞれ $0.20 または $0.40 と記載されています。
参照ダンス動画の長さはどのくらいまでですか?
ドキュメント上の最大長は30秒です。それより長い video_url の入力は拒否されます。
利用可能な出力解像度はどれですか?
ドキュメント上のオプションは480pと720pで、デフォルトは480pです。解像度は1秒あたりのトークンレートも決定します。
リクエストは完了したダンス動画をすぐに返しますか?
いいえ。送信が成功すると data.img_uuid が返されます。この識別子を GET /api/v1/jobs/detail と併用するか、コールバックを設定して、最終結果を取得してください。
GoEnhance のコールバックはどのように動作しますか?
公開アクセス可能なHTTPSの custom_callback_url を指定してください。GoEnhance は処理中・成功・失敗の更新を送信します。200以外のレスポンスの場合は、1回あたり3秒のタイムアウトで最大3回再試行される仕様です。
これは、別のダンスアプリやモデルベンダーの公式APIですか?
このページは、モデル識別子が ai_dance_move である GoEnhance ルートについて説明しています。このページは、いかなる独立したダンスプラットフォームやモデルベンダーとの提携、パートナーシップ、または推薦を主張するものではありません。
