# AI 仿妆迁移

# 概览
看到喜欢的造型，直接上传就行！AI 仿妆迁移让您轻松好玩地尝试各种造型：上传您中意的照片，一张张换着试。有想试的妆容？让 AI 仿妆迁移给您一个惊喜！
首先，上传一张您本人的照片作为目标图，要求脸部与五官清楚可见。
然后，上传一张您喜欢的妆容照片作为参考图。
就这么简单——一张 AI 仿妆迁移好的照片就有了。
示例：
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Makeup_Transfer_s1_img_be53c5c345.jpg)
![](https://plugins-media.makeupar.com/smb/blog/post/2024-06-24/fda62e5d-ba58-4ecf-838a-c7d5f804c77b.jpg)


---

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

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 仿妆迁移 | 1024x1024（长边 <= 1024），仅支持单人脸，需露出完整脸部 | < 10MB | jpg/jpeg/png |

* 错误码

| 错误码 | 说明 |
|  --- | --- |
| error_src_no_face | 用户图中未检测到人脸 |
| error_ref_no_face | 参考图中未检测到人脸 |
| error_src_face_too_small | 用户图中的人脸过小 |
| error_ref_face_too_small | 参考图中的人脸过小 |
| error_src_large_face_angle | 用户图需为正脸 |
| error_ref_large_face_angle | 参考图需为正脸 |
| error_src_eye_closed | 用户图中有眼睛闭合 |
| error_ref_eye_closed | 参考图中有眼睛闭合 |
| error_src_eye_occluded | 用户图中眼睛被遮挡 |
| error_ref_eye_occluded | 参考图中眼睛被遮挡 |
| error_src_lip_occluded | 用户图中嘴唇被遮挡 |
| error_ref_lip_occluded | 参考图中嘴唇被遮挡 |
| error_inappropriate_ref_case01 | 参考图中双眼周围头发过于贴近眼部，或眼尾旁侧的皮肤区域不够大 |
| error_inappropriate_ref_case02 | 参考图中一只眼周围头发过于贴近眼部、或眼尾旁侧的皮肤区域不够大，另一只眼的朝向不够正 |



---

## 点数消耗
| AI 功能 | 消耗点数 |
|  --- | --- |
| AI 仿妆迁移 V1.0 | 2 |



---

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_makeup_transfer.yaml)

## V1.0

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