# 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 authentication'。請在標頭中放入您的 'API Key'：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 仿妝](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_makeup_transfer.yaml)

## V1.0

 - [POST /s2s/v2.0/task/mu-transfer](https://docs.perfectcorp.com/zh-tw/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 或無法使用
 - [GET /s2s/v2.0/task/mu-transfer/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_makeup_transfer/v1.0/paths/~1s2s~1v2.0~1task~1mu-transfer~1%7Btask_id%7D/get.md)