File size: 2,958 Bytes
c449c41 c3adbf1 c449c41 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 |
---
license: apache-2.0
title: FACE SWAP API
sdk: docker
emoji: 🏃
colorFrom: indigo
colorTo: yellow
short_description: SWAP FACES ONLINE VIA API
---
# inswapper-flask-api
Python Flask API for Face Swapper and Restoration
powered by [insightface](https://github.com/deepinsight/insightface).
## Installation
### Clone this repository
```bash
git clone https://github.com/ashleykleynhans/inswapper-flask-api.git
cd inswapper-flask-api
```
### Install the required Python dependencies
#### Linux and Mac
```
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
```
#### Windows
```
python3 -m venv venv
venv\Scripts\activate
pip3 install -r requirements.txt
```
## Download Checkpoints
You will need to download the [face swap model](
https://huggingface.co/ashleykleynhans/inswapper/resolve/main/inswapper_128.onnx) and
save it under `./checkpoints`.
```bash
mkdir checkpoints
wget -O ./checkpoints/inswapper_128.onnx https://huggingface.co/ashleykleynhans/inswapper/resolve/main/inswapper_128.onnx
```
## Face Restoration
In order to obtain better results, it is highly recommended to enable
a face restoration model, which will improve image quality.
This application uses [CodeFormer](https://github.com/sczhou/CodeFormer)
for face restoration.
The required models will be downloaded automatically the first time
the face swap API is called.
You will require [Git Large File Storage](
https://docs.github.com/en/repositories/working-with-files/managing-large-files/installing-git-large-file-storage)
to be installed on your system before you can run the following command.
```bash
git lfs install
git clone https://huggingface.co/spaces/sczhou/CodeFormer
```
## Examples
Refer to the [examples](./examples) provided for getting started
with making calls to the API.
## Benchmarks
These benchmarks are for a source image with a resolution of 960x1280
and a target image with a resolution of 1200x750, upscaled by 1 and
with CodeFormer Face Restoration enabled.
| System | Time Taken |
|---------------------------------------------|---------------|
| macOS Ventura 13.4.1 on Apple M1 Max | 68.6 seconds |
| Ubuntu 22.04 LTS on t3a.xlarge AWS instance | 248.1 seconds |
| Ubuntu 22.04 LTS on an A5000 RunPod GPU pod | 14.2 seconds |
| Windows 10 | 103.9 seconds |
Get a [RunPod](https://runpod.io?ref=w18gds2n) account.
## Acknowledgements
1. Thanks [insightface.ai](https://insightface.ai/) for releasing their powerful swap model that made this possible.
2. This codebase is built on top of [inswapper](https://github.com/haofanwang/inswapper) and [CodeFormer](
https://huggingface.co/spaces/sczhou/CodeFormer).
3. [inswapper](https://github.com/haofanwang/inswapper) is built on the top of [sd-webui-roop](
https://github.com/s0md3v/sd-webui-roop) and [CodeFormer](https://huggingface.co/spaces/sczhou/CodeFormer). |