Image Head Swap

Image Head Swap

Playground

Instant online AI head & face swap for photos with no watermark, delivering realistic, shareable results in seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

WaveSpeedAI Image Head Swap

WaveSpeedAI Image Head Swap is an advanced AI model for replacing the entire head (face + hair + outline) of a person in a static image using a reference portrait. It keeps body, pose and background intact while rebuilding a new, realistic head that matches the scene’s lighting and perspective.

🎬 What this model does

• Replaces the full head region of the subject (face, hair, silhouette, accessories)
• Preserves body pose, clothing, background and general composition
• Adapts the new head to scene lighting, color tone and camera angle
• Produces clean, watermark-free outputs ready for editing or publication

⚙️ Why it looks realistic

• Full-head geometry replacement Swaps the whole head contour instead of only facial features, avoiding mismatched hairlines or skull shape.

• Pose and expression preservation Uses the base image to keep head angle, gaze direction and expression consistent with the original shot.

• Lighting and color matching Automatically adjusts skin tone, shadows and highlights so the new head sits naturally in the scene.

• High-resolution blending Seamless edges around neck, hair and accessories, minimizing visible artifacts.

🧾 Inputs and Parameters

Required fields:

• image: Base image whose body, background and composition you want to keep.

• face_image: Reference portrait that defines the new identity/head to be inserted.

Other options:

• output_format: Choose the final image format:

  • jpeg
  • png
  • webp

💰 Pricing

💡 Best Use Cases

• Casting and concept design Test different actors’ heads on the same body or costume for film, TV or advertising pitches.

• Privacy and anonymization Replace real heads with synthetic or authorized identities while keeping scenes and actions intact.

• Photo and key art exploration Quickly iterate on hero posters, thumbnails and cover images with different looks.

• Social media and creator workflows Create stylized or character-based versions of yourself while preserving your original photos’ composition.

📎 Tips and Notes

• Use clear, reasonably high-resolution portraits for both image and face_image.
• Try to keep camera angle and approximate lighting similar between the two inputs for best results.
• Avoid heavily occluded faces or extreme motion blur in the base image.
• Always ensure you have the legal right and consent to use all images and likenesses involved in your edits.

# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/image-head-swap" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "output_format": "jpeg",
    "enable_base64_output": false,
    "enable_sync_mode": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"