# メイクトランスファー # 概要 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 標準の 'Bearer authentication' を使用します。ヘッダーに 'API Key' を設定してください: `Authorization:Bearer YOUR_API_KEY`。'Bearer' と 'YOUR_API_KEY' の間にスペースがあることに注意してください。 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 統合ガイド](/develop/ - [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)