Face Swap Pro API

ある画像の顔立ちを、別の画像の人物に移します。移るのは顔立ちだけで、対象画像の髪型、生え際、頭の輪郭、ポーズ、服装、光、背景は元のまま残ります。だからこそ、結果は元の写真の上に貼り付いたものではなく、写真の中に収まったものになります。

Face Swap Pro は Face Swap シリーズの精度重視のモデルです。エンジンが 2 枚の写真から顔の特徴点を自動で見つけ、一方をもう一方に対応させます。その後、結果に処理を重ねることはありません。リクエストは画像 URL 2 つだけで、変更する写真を image_url、顔を reference_image_url に入れて spicyapi/face-swap-pro-v1/edit に送ります。呼び出しは非同期で、タスク ID が返り、そのタスクをポーリングすると 1 リクエストにつき 1 枚が返ります。課金は出力 1 枚単位です。

特徴点で顔を対応させる

Pro は精密な仕事のために作られています。領域を貼り移すのではなく、両方の写真で顔の特徴点を見つけて対応させるので、目、鼻、口は対象の顔の骨格が決める位置に収まります。このエンドポイントでは検出は自動で、送るのは画像 2 枚だけです。後処理の補正もかからないため、毛穴、細かなしわ、粒子感が残り、顔は周囲と同じシャープさになります。フィルターのかかった入れ替えより見栄えが劣って見えることがあるのもそのためです。正確さと美化は別の目的です。

画像 URL が 2 つだけ、間違えようがない

このカタログで、2 枚の画像以外を何も受け取らない顔入れ替えエンドポイントはこれだけです。書くプロンプトも、塗る領域も、調整する強度も、固定する seed もありません。あいまいな指示から生まれる失敗がまるごとなくなり、1 件ずつ判断することなくペアのリストを流せるので、バッチ処理も簡単です。未知のキーは無視されずに拒否されるため、フィールド名の打ち間違いは既定値に黙って戻ることなく、送信時に失敗します。本当に大事なのは、どの URL をどちらに入れるかだけです。2 つのフィールドは対称ではなく、入れ替えても有効なリクエストとして通り、まったく違う結果になります。

対象の写真はそのまま残る

ここにはアスペクト比も解像度の設定もありません。画像を作り直すのではなく、既存の写真の一部を置き換えるだけだからです。そのため、すでに承認済みのカットにも使えます。顔以外のものは何も動きません。

印刷される雑誌・キャンペーンのカット

なめらかに加工された顔は、印刷サイズでは破綻します。シャープな服や背景の隣で、肌がプラスチックのように見えるからです。元の質感を残せば、サムネイルではなく近くで見られても画面が持ちこたえます。

承認済みのカットで人物だけを差し替える

光もポーズもセットもすでに決まっていて、画面全体を作り直せばそのすべてが振り出しに戻ります。代わりに顔だけをそのカットに移せば、承認したものはすべてそのまま残ります。

シリーズを通して同じ人物にする

場面はどのモデルで生成してもかまいません。そのあとで同じ顔をすべてに移せば、シリーズ全体が同じ人物として読めます。髪と服はそれぞれの対象画像のものが残るので、生成したバリエーションも失われません。

検閲なしのカットで問われるのは、題材ではなく同意

SpicyAPI は独自のコンテンツフィルターを追加せず、コンテンツフラグも求めないため、フレームに何が写っていてもリクエスト本文は同じ二つのフィールドです。緩まないのは許可です。描かれている人物の、その素材における、その特定の顔についての明確で説明を受けた同意が必要で、写真が公開されていることは同意とはみなされません。

# 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-pro-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png"
  }
}'

# 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 リファレンスを参照してください。