Face Swap Plus API

ある画像の顔を別の画像の人物に移し、その過程で 2 枚の肌のトーンを合わせます。どこまで移すかはエンジンが決めます。そのペアで自然に見えるほうを選び、顔だけか頭部全体をなじませるため、生え際が必ずそのまま残るとは限りません。対象画像のポーズ、服装、光、背景は元のままです。

Face Swap Plus は Face Swap シリーズの中で調整できるモデルです。2 枚の画像に加えて、短い文章の指示、出力ファイル形式、seed を受け取り、spicyapi/face-swap-v1-plus/edit に送ります。呼び出しは非同期で、タスク ID が返り、そのタスクをポーリングすると 1 リクエストにつき 1 枚が返ります。課金は出力 1 枚単位で、どの形式を選んでも変わりません。

肌のトーンを自動で合わせる

顔の入れ替えがいちばん見破られやすいのは境目です。暖かい光で撮った参照画像を寒色の光の対象画像に入れると、あごの周りに輪ができ、首が頭と合わなくなります。このエンジンは入れ替えの過程で 2 枚のトーンを合わせるので、近いけれど同じではない組み合わせでも、たいていは後から色を手直しせずに収まります。光の向きが関係なくなるわけではなく、反対側から照らされた顔はやはり不自然に見えますが、いちばん多い食い違いは任せられます。

どこまでなじませるかはペアごとに決まる

これはスマートな頭部入れ替えです。ペアごとに、顔だけをなじませるか頭部全体をなじませるか、どちらが自然かをエンジンが判断し、どちらかを強制する設定はありません。生え際が常に対象画像側に残るシリーズのほかのモデルとの、実用上の違いはここにあります。予想と少し違う生え際で返ってくることがあるのもそのためで、エンジンが頭部全体のほうが自然だと判断した結果です。

アバターやプロフィール画像の大量処理

対象と参照のペアのリストを、ペアごとに 1 回ずつ、プログラムからエンドポイントに流します。再試行を最初の結果と比べられるようにしたいときはペアごとに seed を固定し、結果をそのまま Web に出すなら WebP を選びます。

アップロードフォームの奥にある一般ユーザー向け機能

やり取りは、ユーザーの写真 1 枚と、こちらで用意する画像 1 枚だけです。ユーザーが設定するものも、書くプロンプトもないので、機能全体はフォームの項目 1 つとバックグラウンドのジョブ 1 つで済みます。

カタログやテンプレートの制作

用意した一連の画像に同じ参照の顔を入れれば、どれも作り直すことなく、まとまりのあるシリーズになります。出力形式の設定で、パイプラインが想定している形のままファイルを受け取れます。テンプレートが必要とする小物は、入れ替えの前に画像の中に入れておいてください。

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

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-v1-plus/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "output_format": "jpeg",
    "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 リファレンスを参照してください。