Akool Image Face Swap

Playground

Akool Image Face Swap swaps faces in photos using a source and target image, including multi-face replacement for group photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Akool Image Face Swap

Akool Image Face Swap is a powerful AI-powered face swapping model that seamlessly replaces faces in images with remarkable precision and realism. Swap single or multiple faces in one image while preserving natural lighting, skin tone, and facial expressions.

Why It Stands Out

Multi-face swapping: Swap multiple faces in a single image simultaneously.
High-quality blending: Seamlessly integrates swapped faces with natural lighting and skin tone matching.
Face enhancement: Optional post-swap face quality enhancement for sharper, cleaner results.
Flexible input: Upload multiple source and target face images for precise control.
One-click operation: Simple workflow — upload images and get results instantly.

Parameters

Parameter	Required	Description
image	Yes	The main image where faces will be swapped.
source_image	Yes	Face(s) to use as replacement (can add multiple).
target_image	Yes	Face(s) in the main image to be replaced (can add multiple).
face_enhance	No	Enhance face quality after swapping (default: enabled).
enable_base64_output	No	Return base64 string instead of URL (API only).

How to Use

Upload the main image — the image where you want to swap faces.
Add source image(s) — upload the face(s) you want to use as replacements.
Add target image(s) — upload reference images of the face(s) to be replaced in the main image.
Enable face enhance (recommended) — improves output quality.
Click Run and wait for processing.
Preview and download the result.

Best Use Cases

Creative Projects — Create fun, artistic face swaps for personal projects.
Content Creation — Generate engaging content for social media and entertainment.
Marketing & Advertising — Visualize models or personas in different scenarios.
Film & Video Production — Create concept images for pre-visualization.
E-commerce — Show products on different face types for diverse representation.

Pricing

Output	Price
Per image	$0.16

Pro Tips for Best Quality

Use high-resolution, well-lit face images for both source and target.
Ensure faces are clearly visible and not obscured by accessories or hair.
For best matching, use source faces with similar angles to the target faces.
Keep face_enhance enabled for sharper, more natural-looking results.
When swapping multiple faces, match source and target images in the same order.

Notes

Ensure uploaded image URLs are publicly accessible.
Processing time varies based on the number of faces and current queue load.
Please use responsibly and ensure your content complies with usage guidelines.

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/akool/image-face-swap" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "face_enhance": false,
    "enable_base64_output": false
}'

# 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		-	Image URL to be swapped
source_image	array	Yes	-	1 ~ 5 items	Source face image URL to be swapped into the video
target_image	array	Yes	-	1 ~ 5 items	Target face image URL that will be replaced in the video
face_enhance	boolean	No	false	-	Whether to enhance face quality after swapping
enable_base64_output	boolean	No	false	-	If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

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

Stability AI Stable Diffusion 3.5 Medium Akool Video Face Swap