Video Face Swap
Playground
Try it on WavespeedAI!Swap faces in any video by uploading a video and an image — perform unlimited, seamless face replacements quickly. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
AI Video Face Swap [Unlimited]
What is AI Video Face Swap?
AI Video Face Swap is an AI-powered tool that allows you to replace faces in videos with any face of your choice. It uses advanced machine learning algorithms to detect faces and seamlessly swap them while maintaining natural expressions and movements.
Pricing
Our endpoint starts with $0.05 per 5 seconds video generation and supports a maximum generation length of 10 minutes.
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/wavespeed-ai/video-face-swap" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"target_gender": "all",
"target_index": 0
}'
# 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 |
|---|---|---|---|---|---|
| video | string | Yes | - | The video that contains the face to be replaced. | |
| face_image | string | Yes | - | - | The face image as reference. |
| target_gender | string | No | all | all, female, male | Gender filter for target faces to be swapped. 'all' means no filter. |
| target_index | integer | No | - | 0 ~ 10 | 0 = largest face. To switch to another target face - switch to index 1, e.t.c. |
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 |