All Models

WaveSpeed logo

WaveSpeed Image Head Swap API

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
Try in Studio
Generate

Pricing depends on the selected inputs. See the rates below.

WaveSpeed Image Head Swap example

Supported modes

Edit

Edit uses face image and image. Adjust the model options to prepare a request for this mode.

image.edit

Pricing

Image editing

Price per run for each listed option.

OfferingPrice (USD)
Per run$0.03 / run

Edit options

OptionDetailsDefault
Face image *
face_image
A public URL, a data URI, or an asset id.—
Image *
image
A public URL, a data URI, or an asset id.—
Format
output_format
The format of the output image. Options: jpeg, png, webp."jpeg"

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.

Model publisher

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

Related models

Unified API

One API for generative media.

Protoface serves popular frontier AI models through one API.

  • minimax
  • minimax
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai

Unified API

One API for generative media.

Protoface serves popular frontier AI models through one API.

  • minimax
  • minimax
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai

Unified API

One API for generative media.

Protoface serves popular frontier AI models through one API.

  • minimax
  • minimax
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai
  • z.ai