# メイクトランスファー

# 概要
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)、顔は 1 名のみ、顔全体が写っている必要あり|< 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

[object Object]

Type: http
Scheme: bearer

## Download OpenAPI description

 - [メイクトランスファー](https://docs.perfectcorp.com/_bundle/@l10n/ja/reference/ai_makeup_transfer.yaml)

## V1.0

 - [POST /s2s/v2.0/task/mu-transfer](https://docs.perfectcorp.com/ja/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 統合ガイド](../develo
 - [GET /s2s/v2.0/task/mu-transfer/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_makeup_transfer/v1.0/paths/~1s2s~1v2.0~1task~1mu-transfer~1%7Btask_id%7D/get.md)