# 髪の長さ分析

# 概要
AI 髪の長さ測定では、髪の長さを分析・測定し、パーソナライズされた製品やサービスの決定を支援します。
耳上から背中中央までの 5 つの髪の長さを識別・分類します。

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/hair_length_S1_01_enu_b03bd393af.jpg)

## 統合ガイド
* 髪の長さ分析のための撮影方法
* 正面を向いて自撮り写真を撮影します
  - カメラをまっすぐ見ている、1 枚のクリアな写真のみで十分です。髪を下ろして胸にかかっている状態にし、真正面を向いて撮影してください。
  - 代わりに、JS Camera Kit を使用して写真を撮影します。髪を下ろして胸にかかっている状態にしてください。結ばないでください。

* AI による髪の長さの検出方法
* ***/s2s/v2.0/file*** API を使用して、以下のアセットをアップロードします:
  - 自撮り写真。

* AI タスク ***/s2s/v2.0/task/hair-length-detection*** の実行 </br>
正面を向いた自撮り画像を 1 枚送信して、髪の長さ検出タスクを実行します。AI のソース入力としてそのファイル ID を使用します。

* タスクのステータスを成功またはエラーになるまでポーリングで確認します</br>
この ***task_id*** は、GET 'task/hair-length-detection' によるポーリングを通じてタスクのステータスを監視するために使用され、現在のエンジンステータスを取得します。エンジンがタスクを完了するまで、ステータスは 'running' のままであり、この段階ではユニットは消費されません。

## 髪の長さの分類
|サムネイル|髪の長さの分類|説明|
| ----  | ----  | ----  |
|![](https://d3ss46vukfdtpo.cloudfront.net/static/media/thumb_hair_lenth_above_the_ears.b41525da.png)|耳上長さ|耳のすぐ上までかかる髪。|
|![](https://d3ss46vukfdtpo.cloudfront.net/static/media/thumb_hair_lenth_ear_length.0740b805.png)|耳長さ|耳たぶまで届く髪。|
|![](https://d3ss46vukfdtpo.cloudfront.net/static/media/thumb_hair_lenth_short_hair.d7f24ddb.png)|ショートヘア|肩より上でカットされた髪。|
|![](https://d3ss46vukfdtpo.cloudfront.net/static/media/thumb_hair_lenth_above_chest.1b624c17.png)|ミディアム長さ|鎖骨付近までかかる髪。|
|![](https://d3ss46vukfdtpo.cloudfront.net/static/media/thumb_hair_lenth_longer_hair.7fbcc9d0.png)|ロングヘア|背中中央までかかる髪。|

* 結果引数
* term: 結果は、検出された髪の長さタイプを示す文字列です。考えられるすべての結果文字列を配列で以下に示します:
  ```json
  ["above the ears", "ear length", "ear length or longer", "short hair", "short hair or longer", "above chest", "above chest or longer", "long hair"]
  ```

* 撮影方法の提案
![撮影方法の提案](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI%20Hair%20Length%20Detection_how%20to%20shoot.png "撮影方法の提案")

![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI%20Skin%20Analysis_camera.png)

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

|タイプ|対応寸法|対応ファイルサイズ|対応フォーマット|
|  ----  | ----  | ----  | ----  |
|髪の長さ分析|画像は幅と高さともに少なくとも 320 ピクセル、いずれかの次元で最大 4096 ピクセルである必要があります。画像の片側の長さが 1080 ピクセルを超える場合、分析のためにその制限内に自動的にリサイズされます。|< 10MB|jpg/png|

* エラーコード

|エラーコード|説明|
|  ----  | ----  |
|error_below_min_image_size|画像の幅または高さが 320 ピクセル未満の場合、小さすぎて使用できません|
|error_face_position_invalid|画像内で顔全体が完全に視認可能であり、一部が切れていない必要があります|
|error_face_position_too_small|写真内の顔が小さすぎて、適切に分析できません|
|error_face_position_out_of_boundary|顔が大きすぎるか、写真の端の一部または全体が外れています|
|error_insufficient_lighting|照明が暗すぎて、分析が困難です|
|error_face_angle_invalid|顔の角度が適切ではありません。正面を向いた撮影では、頭を正面から 10 度以内に保ってください。横を向いた撮影では、角度が 15 度以上である必要があります|

* 環境と依存関係

| サンプルコード言語 / ツール | 推奨ランタイムバージョン |
|---|---|
| cURL | - bash >= 3.2</br>   - curl >= 7.58 (モダンな TLS/HTTP サポート)</br>   - jq >= 1.6 (堅牢な JSON パーシング) |
| Node.js (JavaScript) | Node >= 18 (グローバル fetch 用) |
| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |
| PHP | PHP >= 7.4 (モダンな TLS/互換性のため), ext-curl (推奨) または allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (f-strings のため), requests >= 2.20.0 |
| Java | Java 11+ (HttpClient のため), Jackson Databind >= 2.12.0 |

---

## JS Camera Kit
{% partial file="/_partials/js-camera-kit.md" /%}

---

## ユニット消費

| 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_hair_length_detection.yaml)

## V1.0

 - [POST /s2s/v2.0/task/hair-length-detection](https://docs.perfectcorp.com/ja/reference/ai_hair_length_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-length-detection/post.md): タスクステータスの確認については、ポーリングガイドを参照してください。
 - [GET /s2s/v2.0/task/hair-length-detection/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_hair_length_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-length-detection~1%7Btask_id%7D/get.md)