Advanced AI-powered face swapping with optional image enhancement using CodeFormer restoration and upscaling. Perfect for creative projects, entertainment, and media production.

What It Does

This actor performs face swapping between two images and can optionally enhance the result with AI-powered restoration and upscaling. It supports various image formats and cloud storage URLs from Google Drive, Dropbox, and OneDrive.

Input Parameters

Parameter	Type	Description	Default
`sourceImageUrl`	String	URL of the source image containing the face to be swapped	Required
`targetImageUrl`	String	URL of the target image where the face will be swapped	Required
`outputFormat`	String	Format of the output image (jpg, png)	jpg
`enhanceOutput`	Boolean	Apply AI enhancement to the swapped image	true
`enhanceQuality`	Number	Quality factor for enhancement (0.0-1.0)	0.7
`enhanceUpscale`	Integer	Upscaling factor (1-4)	2
`enhanceFaceUpsample`	Boolean	Enable face upsampling	false
`enhanceBackgroundEnhance`	Boolean	Enable background enhancement	false
`enhanceFaceRestore`	Boolean	Enable face restoration	true

Output Dataset

Field	Type	Description
`status`	String	Processing status (succeeded/failed)
`sourceUrl`	String	Source image URL
`targetUrl`	String	Target image URL
`outputUrl`	String	Resulting image URL
`outputFormat`	String	Output format
`enhanced`	Boolean	Whether enhancement was applied
`processedAt`	String	Processing timestamp
`processingTimeMs`	Number	Processing time in milliseconds
`fileSizeBytes`	Number	Output file size
`enhanceQuality`	Number	Enhancement quality used
`enhanceUpscale`	Number	Upscale factor used
`enhanceFaceUpsample`	Boolean	Face upsampling enabled
`enhanceBackgroundEnhance`	Boolean	Background enhancement enabled
`enhanceFaceRestore`	Boolean	Face restoration enabled
`errorMessage`	String	Error message if failed
`errorType`	String	Error type if failed

Usage Examples

Basic Face Swap

{
  "sourceImageUrl": "https://example.com/source.jpg",
  "targetImageUrl": "https://example.com/target.jpg"
}

Enhanced Face Swap with Upscaling

{
  "sourceImageUrl": "https://example.com/source.jpg",
  "targetImageUrl": "https://example.com/target.jpg",
  "enhanceOutput": true,
  "enhanceUpscale": 4,
  "enhanceQuality": 0.8
}

API Usage

Run the actor programmatically:

$apify call face-swap-enhancer -f input.json -o

Or via REST API:

curl -X POST "https://api.apify.com/v2/acts/face-swap-enhancer/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json

Cost and Limits

Memory: 2048-8192 MB recommended
Processing Time: 30-300 seconds depending on enhancement settings
File Size: Up to 50MB per image
Rate Limits: Subject to Apify platform limits

Supported Formats

Input: JPEG, PNG, WEBP
Output: JPEG, PNG
Cloud Storage: Google Drive, Dropbox, OneDrive direct links

Error Handling

The actor provides detailed error messages in the dataset output. Common issues include:

Invalid or inaccessible image URLs
Unsupported image formats
Memory constraints during enhancement
Face detection failures

On this page

Face Swap and Image Enhancer

Share Actor:

Face Swap

akash9078/ai-face-swap

Swap faces between images using advanced AI deep learning for natural, high-resolution results. Ideal for dev teams, automated workflows, creators, influencers, and marketers.

Akash Kumar Naik

5.0

AI Face Generator

easyapi/ai-face-generator

Effortlessly creates, processes, and stores diverse HD facial images. Perfect for designers, developers, researchers, and creatives needing unique, royalty-free face images for projects, datasets, or artistic inspiration. 🤖🎨🚀

EasyApi

Hugging Face Model Scraper

parseforge/hugging-face-model-scraper

Collect models from Hugging Face Hub via public API endpoints. Get metadata including author, downloads, likes, lastModified, task, library, license, tags and filenames.

ParseForge

5.0

This Person Does Not Exist Scraper

yourapiservice/thispersondoesnotexist-scraper

AI-Generated Face Scraper: Extract Realistic Faces from thispersondoesnotexist.com

Your API Service

Product Review Sentiment Analyzer

devwithbobby/product-review-sentiment-analyzer

Scrapes product reviews from e-commerce websites and analyzes sentiment using OpenAI or Hugging Face APIs.

Dev with Bobby

DeepFakes Faceswap AI

jupri/faceswapify

Replace face from one photo into another photo. Powered by InsightFace AI.

cat

This Person No Exist Scraper

yourapiservice/thispersonnotexist-scraper

Extract AI-Generated Face and Full-Body Images by Gender, Race, Age and Emotion from thispersonnotexist.org

Your API Service

Airbnb Property Scraper

corent1robert/airbnb-property-scraper

High-performance Airbnb property data scraper with optimized pagination and memory management. Extracts detailed property information (URLs, titles, prices, travel dates, images) from Airbnb search results with 2.5x faster performance using 8GB memory configuration.

Corentin Robert

Dataset to HuggingFace

flamboyant_leaf/DatasetToHuggingFace

Transfers data from Apify datasets to Hugging Face datasets. Bridges web scraping with ML platforms, enabling access to pre-trained models and collaborative tools. Customize transfer limits, streamline ML workflows, and leverage data versioning. Ideal for data scientists and ML researchers.

AIRabbit

OSEA® Malibu Scraper

mshopik/osear-malibu-scraper

Scrape OSEA® Malibu and extract data on face and body care from oseamalibu.com. Our OSEA® Malibu API lets you crawl product information and pricing. The saved data can be downloaded as HTML, JSON, CSV, Excel, and XML.