WaveSpeedAI APIAkoolAkool Image Face Swap

Akool Image Face Swap

Akool Image Face Swap

Playground

Try it on WavespeedAI!

AI Image Face Swap by Akool lets you easily swap faces in images online with multiple face support. Upload an image file and another image file to replace faces seamlessly, even in images with multiple people.

Features

WaveSpeedAI Face Swap

WaveSpeedAI Face Swap lets you instantly swap faces in photos using advanced AI technology — all in one click. It’s fast, easy to use, and delivers smooth, realistic results without any watermarks.


⚙️ Why it looks so cool

  • Instant Face Swapping Upload a base image and a reference face — the model replaces the original face with the target identity while maintaining natural contours and lighting.

  • Realistic Blending Automatically adapts skin tone, lighting direction, and expression for ultra-smooth integration.

  • Expression & Pose Preservation The source image’s emotion, head tilt, and gaze direction are retained for believable results.

  • Watermark-Free Results Every generation is clean, production-ready, and suitable for both fun edits and professional use.


🧠 How to use

  • Input:

    • image → The base photo to edit
    • face_image → The reference face to swap in
  • Output: JPEG / PNG / WEBP image with replaced face

  • AI Engine: WaveSpeedAI Face Identity Alignment & Lighting Consistency Module


💰 Pricing

OperationPrice (USD)
Face Swap (per image)$0.010

💡 Best Use Cases

  • Social Media & Entertainment — Fun, shareable, and creative swaps in portraits and group photos.
  • Film & Advertising — Quick mockups for casting, storyboarding, and concept design.
  • Photography & Visual Design — Replace faces for privacy, retouching, or creative effects.
  • Virtual Production — Generate realistic composites for narrative or promotional visuals.

📝 Notes

  • For best results, use clear, front-facing portraits with consistent lighting between both faces.
  • Avoid overly complex or low-resolution images — clarity improves blending accuracy.
  • Ensure you have permission to use all uploaded images and likenesses.
  • If you are working with anime or illustrated characters, the output quality may be significantly lower due to visual style differences.

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

ParameterTypeRequiredDefaultRangeDescription
imagestringYes-Image URL to be swapped
source_imagearrayYes--Source face image URL to be swapped into the video
target_imagearrayYes--Target face image URL that will be replaced in the video
face_enhancebooleanNofalse-Whether to enhance face quality after swapping
enable_base64_outputbooleanNofalse-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

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.