# AI 视频换脸

# 概览
AI 视频换脸是一项由 AI 驱动的处理：借助 YouCam 的 AI 视频换脸接口，把视频里一个人的脸换成另一个人的脸。
在先进 AI 技术的加持下，AI 视频换脸的效果相当逼真。脸部表情、光线、肤色都会精细调校，换上来的脸与原视频画面浑然一体。
> **说明：** 本接口仅支持单人脸视频。需要定制方案，请[联系我们](mailto:YouCamOnlineEditor_API@perfectcorp.com)。

使用示例：
![](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)


---

## 文件规格与错误码
* 支持的格式与尺寸

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 视频换脸 | 输入视频不得超过 30 秒、4K 分辨率或 30 FPS；输出限制为长边 1280 分辨率、30 FPS、最长 30 秒。 | 时长上限：30 秒 | 封装格式：mov、mp4 视频编码：MPEG-4、MPEG-4 AVC，音频编码：aac、amr、mp3 |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| error_download_video | 下载源视频出错 |
| error_decode_video | 解码源视频出错 |
| error_unsupported_video | 视频格式不受支持 |
| exceed_max_filesize | 输入文件大小超出上限 |
| error_nsfw_content_detected | 在源文件中检测到不适宜内容（NSFW） |
| error_decode_mask | 解码蒙版图片出错 |
| invalid_parameter | 参数取值无效 |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 视频换脸 V1.0 | 1（每 5 秒）* |

> *若图片数量或视频时长不能整除，点数按向上取整计算。



---

License: Privacy policy

## Servers

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

## Security

### BearerAuthenticationV2

使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 视频换脸](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_video_face_swap.yaml)

## V1.0

 - [POST /s2s/v2.0/task/face-swap-vid](https://docs.perfectcorp.com/zh-cn/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid/post.md): AI 任务是异步处理的。功能支持 Webhook 时，优先用 Webhook 来接收完成通知。配置好您的 Webhook 端点、校验 Webhook 签名，收到 `success` 或 `error` 通知后，用收到的 `task_id` 查询任务结果。配置与校验的细节请见 [Webhook 接入指南](/develop/webhook)。 若功能不支持 Webhook，或您的接入方式用不了 We
 - [GET /s2s/v2.0/task/face-swap-vid/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_video_face_swap/v1.0/paths/~1s2s~1v2.0~1task~1face-swap-vid~1%7Btask_id%7D/get.md)