How to Swap Faces in Images with an AI API

#ai #api #python #tutorial

Want to add face swapping to your app? Whether it's for entertainment, e-commerce virtual try-on, or privacy anonymization, a Face Swap API lets you do it in a single HTTP call — no ML models to train or GPUs to manage.

What the API Can Do

The Face Swap API exposes 5 endpoints:

Swap Face — swap faces between two images
Detect Faces — find all faces with bounding boxes
Target Face — swap a specific face by index in group photos
Enhance Face — upscale and sharpen faces without swapping
Swap Face with URL — same as swap but with URLs instead of file uploads

Quick Start: Swap Two Faces

import requests

url = "https://deepfake-face-swap-ai.p.rapidapi.com/swap-face"
headers = {
    "x-rapidapi-host": "deepfake-face-swap-ai.p.rapidapi.com",
    "x-rapidapi-key": "YOUR_API_KEY",
}

with open("source.jpg", "rb") as src, open("target.jpg", "rb") as tgt:
    files = {"SourceImage": src, "TargetImage": tgt}
    response = requests.post(url, headers=headers, files=files)

result = response.json()
print(result["body"]["resultImageUrl"])

The API detects the face in each image, maps facial landmarks, and blends the source face onto the target — all in one call.

Targeting a Specific Face in a Group Photo

When the target image has multiple faces, use /target-face with a FaceIndex parameter:

url = "https://deepfake-face-swap-ai.p.rapidapi.com/target-face"

with open("source.jpg", "rb") as src, open("group.jpg", "rb") as tgt:
    files = {"SourceImage": src, "TargetImage": tgt}
    data = {"FaceIndex": "2"}  # swap the 3rd face (0-indexed)
    response = requests.post(url, headers=headers, files=files, data=data)

print(response.json()["body"]["resultImageUrl"])