AI Dance Replace API:モーション駆動動画向け

GoEnhance API を通じて ai_dance_replace にアクセスし、参照ダンス動画内の人物を 1 枚のソース画像の人物に置き換えつつ、参照モーションを保持します。非同期タスクを送信し、その img_uuid を保存してから、完了までポーリングするかコールバックを使用します。
API キーを取得
AI Dance Replace API ワークフロー用に、映画制作スタジオで踊るダンサー

人物置き換えダンス動画ワークフローの構築

置き換え人物の定義

公開の image_url を指定します。その画像の人物が生成されるダンス動画の被写体になるため、送信前に URL を検証してください。
ダンス置き換え API で使用する人物画像のポートレート撮影設定

ダンス動画からのモーション駆動

参照ダンスを含む公開の video_url を指定します。ドキュメント上の制限は 30 秒で、それを超える動画は拒否されます。
AI ダンス置き換えワークフロー向けにモーションを撮影するダンサーとシネマカメラ
送信前に、正確なモデル識別子、メディア URL、出力解像度を検証してください。

AI Dance Replace API の機能と入力

正確なモデル識別子

リクエストの必須フィールドとして、model に ai_dance_replace を設定します。

必須の人物画像

出力に表示される人物の有効な公開 URI として image_url を渡します。

必須のダンス動画

ドキュメント上の最大 30 秒以内の公開参照動画として video_url を渡します。

2 つの解像度オプション

480p または 720p を選択します。ドキュメント上のデフォルトは 480p です。

オプションのコールバック配信

処理中・成功・失敗の更新を受け取るには、公開 HTTPS の custom_callback_url を追加します。

非同期タスクのレスポンス

送信が成功すると img_uuid が返されます。ステータス確認と結果処理のために保存してください。
課金は入力動画の切り上げ後の再生時間に基づきます。コストは選択した解像度と請求秒数から計算します。

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. 終了状態の処理

成功と失敗を冪等に処理し、返されたアセットを検証し、後続処理が重複しないようにします。
API キーの取得
クリエイターツール、キャンペーン制作、反復可能な動画自動化には、同意を考慮したメディアパイプラインを使用します。

ダンス置換動画の開発者向けユースケース

クリエイター向けダンステンプレート

ユーザーがガイド付き作成フロー内で、承認済みの人物画像をライセンス済みのリファレンスダンスに適用できるようにします。

キャンペーン動画のバリエーション

承認済みのソースメディアから被写体のバリエーションを生成し、社内レビューと後続編集に使用します。

キャラクター演技テスト

本番前に、提供されたキャラクター画像が既存の動作リファレンスにどのように追従するかを調査します。

ローカライズ済みクリエイターアセット

承認済みの1つのダンスリファレンスを、地域別コンテンツパイプラインのために異なる許可済み被写体と再利用します。

自動コンテンツキュー

アプリケーションのリクエストスレッドをブロックせずに、タスクIDとコールバックをバッチオーケストレーションに接続します。

モーション体験のプロトタイプ

カスタムキャプチャパイプラインに投資する前に、画像とモーションを組み合わせた製品コンセプトを検証します。
一般的な入力、料金、ステータス、コールバック、統合に関する質問への回答。

AI Dance Replace API FAQ

AI Dance Replace API はどのエンドポイントを使用しますか?

POST https://api.goenhance.ai/api/v1/videos/generations を、model: ai_dance_replace と公開済みの image_url および公開済みの video_url とともに送信します。

AI Dance Replace API の料金体系はどのように機能しますか?

料金は、切り上げた入力動画の長さに基づきます。480p では毎秒 2 トークン、720p では毎秒 4 トークンで、それぞれ 5 秒あたり $0.20 と $0.40 に相当します。

必須フィールドはどれですか?

ドキュメントに記載された必須フィールドは、model、image_url、video_url です。解像度とコールバック URL はオプションです。

リファレンスダンス動画の長さは最大どれくらいですか?

ドキュメント上の最大長は 30 秒です。長い動画は拒否されるため、送信前に長さを検証してください。

どの出力解像度が利用できますか?

エンドポイントは 480p と 720p を受け入れます。省略した場合、ドキュメント上のデフォルトは 480p です。

タスクのステータスを確認するにはどうすればよいですか?

返された img_uuid を永続化し、GET /api/v1/jobs/detail をポーリングするか、公開された HTTPS コールバック URL を提供します。

コールバック失敗はどのように処理されますか?

GoEnhance は、コールバックエンドポイントが HTTP 200 を返さない場合、最大 3 回の再試行を規定しており、各試行のタイムアウトは 3 秒です。

アプリはどのような権限を要求すべきですか?

処理する権限のある画像とダンス動画のみを使用し、ソースメディアに写っている特定可能な人物から適切な同意を得てください。

AI Dance Replace API で構築