Akool Image Face Swap

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 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

How to Use

1. Upload the main image — the image where you want to swap faces.
2. Add source image(s) — upload the face(s) you want to use as replacements.
3. Add target image(s) — upload reference images of the face(s) to be replaced in the main image.
4. Enable face enhance (recommended) — improves output quality.
5. Click Run and wait for processing.
6. 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

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

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "source_image": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
  ],
  "target_image": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
  ],
  "face_enhance": false
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/akool/image-face-swap" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters