# AI Video Face Swap

# Overview
Video face swapping is an AI-powered process that uses YouCam’s AI Video Face Swap API to replace one person's face with another in a video.
With advanced AI technology, the AI video face swap delivers remarkably realistic results. The facial expressions, lighting, and skin tones are finely tuned to ensure that the swapped faces blend seamlessly with the original footage.

> **Note:** This API supports video with single face only. For customizable solution, please  [contact us](mailto:YouCamOnlineEditor_API@perfectcorp.com).

Sample usage cases:
![](https://plugins-media.makeupar.com/smb/blog/post/2024-08-23/b1f96100-37d6-4c28-b467-d397e9c3a25d.jpg)

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/dt_yce_video_face_swap_S3_video_03_28785ebe0c.jpg)

![](https://plugins-media.makeupar.com/smb/story/2024-09-12/3582f617-e88e-4219-9e72-43d4c26791cd.png)


License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

Use the standard 'Bearer authentication'. Put your 'API Key' in header: `Authorization:Bearer YOUR_API_KEY`. Notice that there is ' ' a space between 'Bearer' and the 'YOUR_API_KEY'.

Type: http
Scheme: bearer

## Download OpenAPI description

[AI Video Face Swap](https://docs.perfectcorp.com/_bundle/reference/ai_video_face_swap.yaml)

## V1.0

AI Face Swap (video) API allows you to swap faces between a target video and one or more reference images using AI technology.

### Create a new file.

 - [POST /s2s/v2.0/file/face-swap-vid](https://docs.perfectcorp.com/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1file~1face-swap-vid/post.md): To upload a new file, you'll first need to use the File API. It will give you a URL – use that URL to upload your file. Once the upload is finished, you can use the file_id from the same response to start using our AI features.

### Run an AI Face Swap (video) task.

 - [POST /s2s/v2.0/task/face-swap-vid](https://docs.perfectcorp.com/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid/post.md): AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.

If webhooks are not supported for the feature, or if your integration cannot use webhooks, implement polling. After starting an AI task, keep polling the task status endpoint at the given polling_interval until the task status is either success or error.

Do not stop polling a running task for longer than the allowed polling window. If the task is not polled in time, the task may expire; a later status check can return InvalidTaskId even if processing finished, and the consumed units may still be charged.

### Check the status of the AI Face Swap (video) task.

 - [GET /s2s/v2.0/task/face-swap-vid/{task_id}](https://docs.perfectcorp.com/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid~1%7Btask_id%7D/get.md)