制作ワークフローのための動画顔交換 API
GoEnhance API を使って、許諾を前提とした顔の差し替えを動画パイプラインに組み込めます。対象動画・元となる顔画像・出力設定・時間区間を送信し、返却されたタスク ID を保存してから非同期の結果を取得します。
API 利用を開始
役割を絞り込んだ動画顔交換 API の契約
時間区間つきの動画リクエストを準備
対象クリップは reference_video に、顔画像は reference_img に指定します。現行のリファレンスでは上限がそれぞれ 200 MB と 5 MB と記載されており、加えて start_time、end_time、upscaler の各フィールドが必須です。
完了結果は非同期で取得
送信に成功すると data.img_uuid が返ります。GET /api/v1/jobs/detail をポーリングするか、公開された HTTPS コールバックを指定してください。pending・processing・success・failed の各状態を処理し、最終的な動画を保存する前に型つきの結果エントリを確認します。
ドキュメント化されたリクエスト・タスク・結果の契約を軸に設計します。
本番運用で効いてくる機能
Bearer 認証によるリクエスト
GoEnhance API キーは自社サーバー側に保持し、Authorization ヘッダーで送信します。本番の認証情報をブラウザ側のコードに露出させないでください。
明示的なメディアの役割分担
対象クリップには <code>reference_video</code>、転写する顔には <code>reference_img</code> を使うことで、入力の取り違えというよくあるミスを防げます。
上限が定められた入力素材
送信前にメディアへアクセスできることを検証します。現行のエンドポイントリファレンスでは、動画は最大 200 MB、画像は最大 5 MB と記載されています。
時間指定の変換区間
<code>start_time</code> と <code>end_time</code> は 0 〜 120 秒の範囲で指定し、選んだ区間が元のクリップに対して妥当かどうかを検証します。
出力と補正のコントロール
<code>upscaler</code> は 1 で 720p、2 で VIP 限定の 1080p を選択します。<code>enhance_face</code> はワークフロー上必要な場合にのみ有効にしてください。
型つきの非同期結果
<code>img_uuid</code> を保存し、すべての終了状態を処理し、<code>type</code> ごとに結果エントリを確認したうえで、一時リンクが失効する前に成功した出力をコピーしておきます。
最新の課金ページとアカウント残高を正とします。
推測に頼らない動画顔交換 API の料金
最新の動画顔交換 API 料金を確認
エンドポイントリファレンスには料金の倍率のみが記載されており、固定の基本単価は示されていません。コストを見積もる前に、GoEnhance の課金ページで現在の基本料金を確認してください。
オプションの倍率も見込んでおく
現行のリファレンスでは 1080p 出力と顔補正が 1.5x 料金のオプションとされています。複数オプションを組み合わせた場合の計算方法は説明されていないため、推測せず実際の請求額で確認してください。
クレジットと予算の監視
<code>GET /api/v1/user/tokens</code> で <code>data.count</code> を読み取り、現在の GoEnhance API 料金に合わせてテナントごとの上限、タスクの利用履歴、アラートを組み込みます。
GoEnhance API を 3 ステップで実装
1
1. 許諾とメディアの検証
同意と利用権を確認し、2 つの URL に到達できることを検証し、ドキュメント記載のサイズと時間の上限を適用したうえで、非対応または曖昧な入力は送信前に弾きます。
2
2. タスクの作成と保存
必須のメディア、時間範囲、出力設定を
/api/v1/videofaceswap/generate に POST します。HTTP とレスポンス本体の両方で成功を確認してから data.img_uuid を保存します。 3
3. 追跡・確認・保存
バックオフを入れてポーリングするかコールバックの到達を検証し、終了ステータスと結果の型で分岐します。人物の同一性とフレームの一貫性を確認し、承認された出力を永続ストレージへ移します。
同意、開示、アクセス制御は任意の注意書きではなく、プロダクト要件として扱ってください。
許諾を前提とした実用的なユースケース
同意を得たキャンペーン素材のバリエーション
肖像の利用を明示的に許諾したタレント、アンバサダー、顧客向けに、承認済みの動画バリエーションを制作します。
映像制作のプレビジュアライゼーション
本制作の前にキャスティングやシーンの連続性を試作します。人によるレビューと権利処理は必ず工程に残します。
ローカライズされたクリエイティブ制作
承認済みの映像を地域ごとのキャンペーン向けに展開しつつ、素材の許諾・開示・レビューの記録を追跡可能な形で残します。
オプトイン型のエンタメツール
利用者が自ら対象クリップと元の人物写真を提供し、結果が合成であると理解している体験に活用します。
管理された社内プロトタイプ
構図やコンセプトの方向性を検証する用途に限り、生成映像を実際の出来事や本人の推薦であるかのように提示しません。
モデレーション付きのメディアアプリ
顔交換の機能を、アクセス制御・不正利用の通報・保持期間の制限・来歴の記録・承認ゲートと組み合わせて運用します。
実装、料金、タスクの扱い、責任ある利用についての実践的な回答です。