# ヘアボリューム

# 概要
AI でふんわりしたボリュームヘアにできます。
細毛や薄毛に自然なボリュームを付けられます。AI で隙間を埋めたり、髪を追加したりできます。ストレート、カール、細毛などすべての髪質に対応しています。
プライベート、ビジネス、SNS などの写真で、髪のボリュームと密度を調整できます。
ユースケース:
![AI Hair Volume Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/YCE_web_Hair_Volume_Filter_S4_img_01_836436ca00.jpg)
![AI Hair Volume Generator](https://plugins-media.makeupar.com/smb/blog/post/2024-08-26/51eadc51-aaa7-4ebc-ac78-e389be5e16b0.jpg)
撮影時の推奨事項:
![Suggestions for How to Shoot](https://bcw-media.s3.ap-northeast-1.amazonaws.com/AI_Hair_Extension_recommendation_ba24bd5d92.png)


---

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

| AI 機能 | 対応サイズ | 対応ファイルサイズ | 対応フォーマット |
|  --- | --- | --- | --- |
| ヘアボリューム | 長辺 <= 1024、顔幅 >= 128、顔の向き: -10 < pitch < +10, -45 < yaw < +45, -15 < roll < +15、単一の顔のみ、顔全体が写っている必要あり | < 10MB | jpg/jpeg/png |

* エラーコード

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



---

## ユニット消費量
| 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_hair_volume.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/hair-vol](https://docs.perfectcorp.com/ja/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1template~1hair-vol/get.md)
 - [POST /s2s/v2.0/task/hair-vol](https://docs.perfectcorp.com/ja/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1hair-vol/post.md): AI タスクは非同期です。機能ごとに Webhook がサポートされている場合は、Webhook による完了処理を優先します。Webhook エンドポイントを設定し、Webhook 署名を検証したうえで、`success` または `error` の通知が来たら、受け取った `task_id` を使ってタスクの結果を照会します。設定と検証の詳細は [Webhook 統合ガイド](/develop/
 - [GET /s2s/v2.0/task/hair-vol/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_hair_volume/v1.0/paths/~1s2s~1v2.0~1task~1hair-vol~1%7Btask_id%7D/get.md)