はじめに
Head Swap は、対象画像の人物の頭部全体を、参照写真の頭部に置き換えます。顔、髪型、髪色、頭の輪郭がすべて移り、対象画像の体、服装、ポーズ、光、背景は元のまま残ります。
リクエストは画像 URL 2 つと任意の seed だけです。残す体を image_url、頭部を reference_image_url に入れます。プロンプトもマスクも強度の調整もなく、1 リクエストにつき 1 枚が返ります。
主な機能とハイライト
キャラクターの頭部を丸ごと既存のカットに入れる
Head Swap が変えるのは顔のアイデンティティだけではありません。新しいキャラクターの髪、髪色、頭の輪郭まで一緒に移す必要があるときに適した範囲です。対象画像の髪型を残したくない、キャラクターの差し替え、衣装のコンセプト、連続性の調整に向いています。
首のつながりが合否の判断基準
カメラの角度と光の向きがそろい、首が見えている素材を選んでください。結果を受け入れる前に、生え際、耳、あご、首の継ぎ目、影のつながりを原寸で確認します。2 枚が本当になじんでいるかは、こうした境目に表れます。
条件をそろえた画像ペアで始める
どちらの画像にもはっきり写った人物を 1 人だけにし、強いぼけ、隠れ、極端な横顔は避けます。対象画像の髪とシルエットがそのカットに欠かせないなら、無理に頭部を入れ替えず Face Swap を選んでください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 書き換えられる画像です。身体、衣装、ポーズ、光、背景は保たれ、首から上がすべて置き換わります。 1 文字以上 |
reference_image_url | はい | 頭部そのものを供給する画像です。形、髪型、髪色まで含みます。 1 文字以上 |
seed | いいえ | 同じ seed を使い回すと、同じ画像ペアでの 2 回の実行を同じ乱数のうえで比べられます。空のままにするか 0 を指定すると毎回ランダムに引き直します。 |
料金
$0.013 / 枚
ユースケース
顔だけでなく、頭部ごと入れ替える
新しい人物の髪型、髪色、頭の輪郭を一緒に持ち込む必要があるときに使います。結果を受け入れる前に、生え際、耳、首の継ぎ目を原寸で確認してください。対象画像の髪をそのカットに残したいなら、範囲の狭い Face Swap が向いています。
気に入っている体のカットで頭部を差し替える
画像の服装、ポーズ、光がすでに決まっているなら、画像全体を生成し直して構図が残ることを祈るより、頭部を入れ替えるほうが安く、結果も読みやすくなります。
衣装やコスプレのカット
生成した衣装を着た体に、キャラクター本人の頭部と髪型を載せます。メイド服、ポーズ、カフェのセットはそのまま残るので、衣装の作り込みも失われません。
同意を得た顔なら場面は問わない
使用を許されている頭部を、自分で制作したカットに移します。何が写っていても構いません。エンドポイントはその素材を特別扱いしません。基準になるのは下の制限事項にある同意の要件で、形だけの手続きではありません。
プロンプトガイドと実践のヒント
2 人分の権利があるか確認する
2 枚とも人物が写っているため、移す頭部と、それを入れる画像の両方について権利が必要です。組み込み作業を始める前に、許諾を作業記録と一緒に保管してください。
角度をそろえてからペアで送る
image_url は残す体、reference_image_url は頭部を提供する画像です。汎用の画像エディターなら、次のような指示が必要になります。「Head swap: replace the entire head of the person in the first image — face, hairstyle and hair colour — with the head from the second image, keeping the first image's body, maid outfit, pose, cafe background, lighting and colour grade unchanged. Match the neck seam, skin tone and lighting direction so the result reads as one photograph.」ここにはプロンプトの欄自体がありません。
反復する前に結果を確かめる
失敗しやすいのは首の継ぎ目です。対象画像の首がハイネック、スカーフ、髪で隠れている場合や、頭の角度が参照画像と大きく違う場合は、つなぎ目が見えてしまいます。2 枚の光の向きと肌のトーンをそろえ、頭の角度も近いものを選んでください。どちらの画像も、はっきり見えて、おおむね正面向きで、光がよく当たった、ある程度の大きさの頭部が必要です。集合写真では、エンドポイントはどの人物を指しているのか判断できません。対象画像の髪型を残したいなら Face Swap を使ってください。ここにはそれを残すパラメーターはありません。プロンプトもマスクも強度の調整もないため、結果が違うときは別の画像ペアで直します。
API クイックスタート
# 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/head-swap-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 リファレンスを参照してください。
