ai_dance_replace にアクセスし、参照ダンス動画内の人物を 1 枚のソース画像の人物に置き換えつつ、参照モーションを保持します。非同期タスクを送信し、その img_uuid を保存してから、完了までポーリングするかコールバックを使用します。AI Dance Replace API：モーション駆動動画向け
GoEnhance API を通じて
API キーを取得
人物置き換えダンス動画ワークフローの構築
送信前に、正確なモデル識別子、メディア URL、出力解像度を検証してください。
AI Dance Replace API の機能と入力
正確なモデル識別子
リクエストの必須フィールドとして、<code>model</code> に <code>ai_dance_replace</code> を設定します。
必須の人物画像
出力に表示される人物の有効な公開 URI として <code>image_url</code> を渡します。
必須のダンス動画
ドキュメント上の最大 30 秒以内の公開参照動画として <code>video_url</code> を渡します。
2 つの解像度オプション
<code>480p</code> または <code>720p</code> を選択します。ドキュメント上のデフォルトは <code>480p</code> です。
オプションのコールバック配信
処理中・成功・失敗の更新を受け取るには、公開 HTTPS の <code>custom_callback_url</code> を追加します。
非同期タスクのレスポンス
送信が成功すると <code>img_uuid</code> が返されます。ステータス確認と結果処理のために保存してください。
課金は入力動画の切り上げ後の再生時間に基づきます。コストは選択した解像度と請求秒数から計算します。
AI Dance Replace API の料金
480p の料金
入力動画 1 秒あたり 2 トークン、トークンあたり $0.02 で、1 秒あたり $0.04、5 秒あたり $0.20 に相当します。
720p の料金
入力動画 1 秒あたり 4 トークン、トークンあたり $0.02 で、1 秒あたり $0.08、5 秒あたり $0.40 に相当します。
時間ベースの課金
入力動画の再生時間は課金時に切り上げられます。請求秒数に選択したレートを掛けてコストを概算します。
GoEnhance API 統合の6ステップ
1
1. API キーを作成する
GoEnhance APIキーを作成し、Authorization ヘッダーのベアラートークンとして送信します。
2
2. 両方のメディアURLの検証
人物画像とダンス動画が公開されており、動画の長さが30秒以内であることを確認します。
3
3. リクエストの作成
model: ai_dance_replace を設定し、image_url と video_url を追加して、480p または 720p を選択します。 4
4. タスクの送信
JSON ボディを
https://api.goenhance.ai/api/v1/videos/generations に POST します。 5
5. 永続化と追跡
返された
img_uuid を保存し、GET /api/v1/jobs/detail をポーリングするか、コールバックイベントを受信します。 6
6. 終了状態の処理
成功と失敗を冪等に処理し、返されたアセットを検証し、後続処理が重複しないようにします。
クリエイターツール、キャンペーン制作、反復可能な動画自動化には、同意を考慮したメディアパイプラインを使用します。
ダンス置換動画の開発者向けユースケース
クリエイター向けダンステンプレート
ユーザーがガイド付き作成フロー内で、承認済みの人物画像をライセンス済みのリファレンスダンスに適用できるようにします。
キャンペーン動画のバリエーション
承認済みのソースメディアから被写体のバリエーションを生成し、社内レビューと後続編集に使用します。
キャラクター演技テスト
本番前に、提供されたキャラクター画像が既存の動作リファレンスにどのように追従するかを調査します。
ローカライズ済みクリエイターアセット
承認済みの1つのダンスリファレンスを、地域別コンテンツパイプラインのために異なる許可済み被写体と再利用します。
自動コンテンツキュー
アプリケーションのリクエストスレッドをブロックせずに、タスクIDとコールバックをバッチオーケストレーションに接続します。
モーション体験のプロトタイプ
カスタムキャプチャパイプラインに投資する前に、画像とモーションを組み合わせた製品コンセプトを検証します。
一般的な入力、料金、ステータス、コールバック、統合に関する質問への回答。