Akool Video Face Swap
Playground
Try it on WavespeedAI!AKOOL Video Face Swap replaces faces in videos from a single image, supporting multiple faces for seamless, realistic swaps. Price starts at $0.05 per video second with a minimum charge of 10 seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Akool Video Face Swap
Akool Video Face Swap is a powerful AI-powered face swapping model that replaces faces in videos with new ones. Upload source faces and their corresponding target faces, provide a video, and the model seamlessly swaps each face — perfect for content creation, entertainment, and creative projects.
Why It Stands Out
- Multi-face swapping: Swap multiple faces in a single video simultaneously.
- Face-to-face mapping: Match each source face to its corresponding target face.
- Face enhancement: Optional post-swap face quality enhancement for better results.
- High-quality output: Produces realistic, seamless face replacements.
- Long video support: Process videos up to 10 minutes (600 seconds).
Parameters
| Parameter | Required | Description |
|---|---|---|
| source_image | Yes | Face images to swap onto the video (multiple allowed). |
| target_image | Yes | Face images to be replaced in the video (multiple allowed). |
| video | Yes | Video file to process (upload or public URL). |
| face_enhance | No | Enhance face quality after swapping (default: enabled). |
| enable_base64_output | No | Return base64 string instead of URL (API only). |
How to Use
- Upload source images — add face images that will appear in the final video.
- Upload target images — add face images to be replaced (match order with source images).
- Upload your video — provide the video containing faces to swap.
- Enable face enhancement (recommended) — improves face quality after swapping.
- Click Run and wait for processing.
- Preview and download the result.
Face Mapping
The model matches source and target faces by order:
| Source Image | Target Image | Result |
|---|---|---|
| Source 1 | Target 1 | Target 1’s face replaced by Source 1 |
| Source 2 | Target 2 | Target 2’s face replaced by Source 2 |
Add multiple source/target pairs to swap multiple faces in the same video.
Best Use Cases
- Content Creation — Create engaging face-swap videos for social media.
- Entertainment — Produce fun videos with friends and family.
- Film & Production — Replace faces for creative or practical purposes.
- Marketing — Create personalized video content at scale.
- Dubbing & Localization — Swap faces for regional content adaptation.
Pricing
| Duration | Price |
|---|---|
| 10 seconds | $0.50 |
| 30 seconds | $1.50 |
| 60 seconds | $3.00 |
Billing Rules
- Billed per second at $0.05
- Minimum charge: 10 seconds
- Maximum duration: 600 seconds (10 minutes)
Pro Tips for Best Quality
- Use high-resolution, front-facing source images with clear facial features.
- Ensure target images match the faces appearing in the video.
- Keep face enhancement enabled for smoother, higher-quality results.
- Videos with well-lit, forward-facing subjects produce the best swaps.
- Match the number of source and target images correctly.
Notes
- Ensure uploaded image and video URLs are publicly accessible.
- Processing time varies based on video length and current queue load.
- Please ensure your content complies with usage guidelines and respect individuals’ likeness rights.
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/video-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
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| source_image | array | Yes | - | 1 ~ 5 items | Source face image URL to be swapped into the video |
| target_image | array | Yes | - | 1 ~ 5 items | Target face image URL that will be replaced in the video |
| video | string | Yes | - | Input video URL for face swapping | |
| face_enhance | boolean | No | false | - | Whether to enhance face quality after swapping |
| enable_base64_output | boolean | No | false | - | 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
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |