Image Body Swap

Playground

Image Body Swap replaces the body in a target image with your face. Upload a face image and a body image to get a seamless swap. Ready-to-use REST inference API, no coldstarts, affordable pricing.

Features

Image Body Swap

Image Body Swap places your face onto any body image in seconds. Upload a face photo and a body photo — AI composites them together with natural blending, consistent lighting, and seamless results.

Why You’ll Love It

Instant face-to-body compositing Advanced AI places your face onto any body photo with natural blending and consistent skin tone matching.
Two-image simplicity No masks, no manual editing, no technical knowledge needed — just a face and a body.
Endlessly versatile Swap onto fitness photos, fashion looks, fun costumes, or any creative scenario you can imagine.

How to Use

Upload your face image — a clear, front-facing portrait with good lighting works best.
Upload your body image — the photo whose body you want to swap the face onto.
Hit Run — your swapped portrait is ready in seconds.
Download and share.

Pricing

Just $0.05 per image.

Best Use Cases

Fashion & styling — Try on outfits or looks without physically wearing them.
Fun and social content — Swap onto wild, funny, or dramatic body photos for shareable posts.
Creative projects — Composite faces into illustrations, costumes, or character designs.
Personalized gifts — Put a friend’s face on a superhero, athlete, or iconic figure for a one-of-a-kind gift.

Pro Tips

Use a clear, well-lit face photo with a front-facing angle for the most natural compositing result.
Body images with a clearly visible, unobstructed upper body blend more cleanly.
Similar face angles between the face image and body image produce the most realistic output.

Notes

Both image and body_image are required fields.
Ensure image URLs are publicly accessible if using links rather than direct uploads.
Please ensure your content complies with WaveSpeed AI’s usage policies.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


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

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

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
image	string	Yes		-	The URL of the face/head image.
body_image	string	Yes	-	-	The URL of the target body image.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Image Background Remover Image Captioner