Video Face Swap API

Video Face Swap は、参考画像 1 枚の顔立ちを動画に映る人物へ、クリップの全フレームにわたって移し替えます。移るのは顔のパーツだけです。出演者の髪型、頭の輪郭、動き、衣装、ライティング、カメラワーク、背景は撮影したときのまま残るため、仕上がりは上から貼り付けたものではなく、元の映像として見えます。

Video Face Swap は動画クリップと参考の顔画像を受け取り、顔立ちだけを映像の人物に移し替えます。髪、動き、構図、背景はそのまま残ります。URL 2 つと任意の質感設定だけで、書くべき prompt 欄はありません。

演技を保ち、顔のアイデンティティを置き換える

Face Swap は、承認済みの参照画像のアイデンティティを映像内の人物に適用し、実写の演技を保ちます。人物、構図、光がすでに成立しているクリップを選んでください。このワークフローはアイデンティティを置き換えるもので、ショットを作り直すものではありません。

合成シーンではなく連続性を確認する

回転、カット、速い動きを含め、通常速度で結果を確認します。アイデンティティの置き換えが自然で、髪、動き、衣装、背景が元映像として読み取れるかを確かめてください。

指定したクリップを変更する

Video Face Swap は、参考画像 1 枚の顔立ちを動画に映る人物へ、クリップの全フレームにわたって移し替えます。移るのは顔のパーツだけです。出演者の髪型、頭の輪郭、動き、衣装、ライティング、カメラワーク、背景は撮影したときのまま残るため、仕上がりは上から貼り付けたものではなく、元の映像として見えます。元動画を編集の出発点にするときに使います。変更を具体的に記述し、連続性、タイミング、残す細部を確認します。

生成したシリーズを同じ顔でそろえる

任意の動画モデルでクリップを何本か生成し、同意を得た 1 つの顔をすべてに移し替えれば、シリーズ全体が同じ人物として見えます。動き、衣装、セットはクリップごとに残るので、生成で得たバリエーションはそのまま生きます。

同意を得た出演者の肖像で検閲なしのコンテンツを作る

使用権限のある顔を、自分で制作した映像に移し替えます。検閲なしの素材でもリクエストの内容は何も変わりません。ただし、下の利用範囲にある権限の要件は形式ではなく、厳格な条件です。

すでに仕上がったテイクの出演者を差し替える

ライティング、立ち位置、カメラワークが承認済みのテイクはそのまま残し、顔だけを差し替えます。ショット全体を作り直して、せっかくの演技を失う必要はありません。

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "spicyapi/face-swap-video-v1/video-edit",
  "input": {
    "reference_image_url": "https://example.com/reference.png",
    "style": "realistic",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。