# AI ヘアエクステ

# 概要
AI で理想のヘアエクステを見つけよう
長さはロングからエクストラロングまで、スタイル、カラー、前髪など、さまざまな組み合わせをデバイス上で試せます。生成 AI により、ヘアエクステのスタイルがどのように見えるかを確認できます。
現在の髪の長さに自然に馴染む AI ヘアエクステで、超ロングスタイルを試す絶好の機会です。
ユースケース:
![AI ヘアエクステ](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Extension_Filter_S2_img_07_098b6e08c4.jpg)
![AI ヘアエクステ](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Extension_Filter_S1_img_01_eab88fe3e2.jpg)
撮影時の推奨事項:
![Suggestions for How to Shoot](https://bcw-media.s3.ap-northeast-1.amazonaws.com/AI_Hair_Extension_recommendation_ba24bd5d92.png)


---

## ファイル仕様とエラー
* 対応フォーマットと寸法

| AI 機能 | 対応寸法 | 対応ファイルサイズ | 対応フォーマット |
|  --- | --- | --- | --- |
| AI ヘアエクステ | 長辺 <= 1024、顔幅 >= 128、顔の姿勢: -10 < pitch < +10, -45 < yaw < +45, -15 < roll < +15、単一の顔のみ、顔全体が写っている必要あり | < 10MB | jpg/jpeg |

* エラーコード

| エラーコード | 説明 |
|  --- | --- |
| error_no_shoulder | ソース画像に肩が写っていません |
| error_large_face_angle | アップロードされた画像の顔の角度が大きすぎます |
| error_insufficient_landmarks | ソース画像で十分な顔または体のランドマークを検出できません |
| error_hair_too_short | 入力された髪が短すぎます |
| error_face_pose | ソース画像の顔の姿勢はサポートされていません |
| error_bald_image | 入力されたヘアスタイルがハゲています |



---

## ユニット消費量
| AI 機能 | 消費ユニット |
|  --- | --- |
| AI ヘアエクステ V1.0 | 1 |



---

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/ja/reference/ai_hair_extension.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/hair-ext](https://docs.perfectcorp.com/ja/reference/ai_hair_extension/v1.0/paths/~1s2s~1v2.0~1task~1template~1hair-ext/get.md)
 - [POST /s2s/v2.0/task/hair-ext](https://docs.perfectcorp.com/ja/reference/ai_hair_extension/v1.0/paths/~1s2s~1v2.0~1task~1hair-ext/post.md): このエンドポイントは、テンプレートとソース画像を使用してヘアエクステ生成プロセスを開始します。タスクは非同期で処理され、このレスポンスで返される task_id を使用してステータスを確認できます。
 - [GET /s2s/v2.0/task/hair-ext/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_hair_extension/v1.0/paths/~1s2s~1v2.0~1task~1hair-ext~1%7Btask_id%7D/get.md)
