WaveSpeed Image Head Swap replaces a person’s full head using a reference portrait, including hair and head shape, while keeping the body and surrounding scene intact.
Model overview
- Model ID
wavespeed-ai/image-head-swap- Output Type
- Image
- Pricing
- $0.03 / run
- Provider
- WaveSpeed
- Hosting
- External

WaveSpeed Image Head Swap Edit API example
curl -X POST https://api.protoface.com/v1/run/wavespeed-ai/image-head-swap \
-H "Authorization: Bearer $PROTOFACE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"operation": "image.edit",
"face_image": "https://example.com/your-image.png",
"image": "https://example.com/your-image.png",
"output_format": "jpeg"
}'Replace example input URLs with your own public URLs or uploaded asset IDs. This request uses the selected mode and settings.
Supported modes
Edit
Edit uses face image and image. Adjust the model options to prepare a request for this mode.
image.editPricing
Image editing
Price per run for each listed option.
| Offering | Price (USD) |
|---|---|
| Per run | $0.03 / run |
Edit options
WaveSpeed Image Head Swap
WaveSpeed Image Head Swap edits a still image by replacing a person’s head with one based on a reference portrait. The replacement covers facial features, hair, and the outer head shape. The base image supplies the body, clothing, and setting that remain in the finished picture.
The model adapts the inserted head to the scene’s illumination and camera perspective. It also follows the original subject’s head angle, gaze, and expression, connecting the reference identity to the pose already present in the photograph.
What it's good for
Casting studies can use the same costume and staging to explore different actor appearances. Character designers can test how a reference identity fits an established wardrobe or scene, keeping the surrounding visual context consistent across edits.
For poster concepts and cover artwork, full-head replacement supports changes to a character’s appearance while retaining the framing and background used by the design.
Run WaveSpeed Image Head Swap on Protoface
Use WaveSpeed Image Head Swap in Protoface Studio without writing code. Choose your inputs and generation settings, then generate with affordable, usage-based pricing. For your own AI app or workflow, use the Protoface API to submit generations and retrieve their outputs.

About WaveSpeed
WaveSpeed is an AI inference platform offering third-party generative models through developer APIs and creator applications. Its image and video workflows sit alongside WaveSpeed-branded media tools, including Video Face Swap, which takes source footage and a reference portrait to replace a selected face in a video.
- Media inference
- Creative tools
- Video face swap










