# 髪密度分析
# 概要
AI 髪密度分析では、アップロードした 1 枚の画像から頭皮の可視性と髪の分布パターンを評価し、髪の密度を 4 つのレベルに分類します。
## 統合ガイド
* AI 髪密度分析用の写真の撮影方法
* セルフィーを撮影する
- カメラを正面に向け、適切な照明の下で頭を45度下げてください。髪を結ばず、生え際全体がはっきりと見えるようにしてください。
- 代わりに、JS Camera Kit を使用して写真を撮影してください。
* AI による髪密度の検出方法
* ***/s2s/v2.0/file*** API を使用して、以下のアセットをアップロードします：
- セルフィー写真。
* AI タスク ***/s2s/v2.0/task/hair-density-detection*** を実行
正面から45度下げたセルフィー画像を1枚送信して検出タスクを実行します。AI のソース入力としてそのファイル ID を使用します。
* タスクのステータスを成功またはエラーになるまでポーリングして確認する
この ***task_id*** は、GET 'task/hair-density-detection' によるポーリングを通じてタスクのステータスを監視するために使用され、現在のエンジンステータスを取得します。エンジンがタスクを完了するまで、ステータスは 'running' のままであり、この段階ではユニットは消費されません。
## 髪密度の分類
|サムネイル|髪密度の分類|説明|
| ---- | ---- | ---- |
||レベル 1
極めて低い密度|髪が著しくまばらで、広い範囲で頭皮が見えます。|
||レベル 2
低い密度|特に頭頂部や分け目で頭皮がはっきりと見える、目立つ薄毛があります。|
||レベル 3
中程度の密度|直射日光の下で頭皮が部分的に見えますが、髪は中程度のボリュームとカバー率を維持しています。|
||レベル 4
高い密度|髪はふさふさで厚く見え、頭皮はほとんどまたは全く見えません。|
* 撮影方法のヒント
## ファイル仕様とエラー
* 対応フォーマットと寸法
|タイプ|対応寸法|対応ファイルサイズ|対応フォーマット|
| ---- | ---- | ---- | ---- |
|AI 髪密度分析|画像は幅と高さが少なくとも100ピクセル、いずれかの次元で4096ピクセル以下である必要があります。画像の片方の辺が1080ピクセルを超える場合、分析のためにその制限内に自動的にリサイズされます。|< 10MB|jpg/png|
* エラーコード
|エラーコード|説明|
| ---- | ---- |
|error_below_min_image_size|画像の幅または高さが100ピクセル未満の場合、小さすぎて使用できません|
|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 - curl >= 7.58 (モダンな TLS/HTTP サポート) - jq >= 1.6 (堅牢な JSON 解析) |
| Node.js (JavaScript) | Node >= 18 (グローバル fetch のため) |
| JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - 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 機能 | 消費ユニット |
|---|---|
| AI 髪密度分析 V1.0 | 1 |
---
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_density_detection.yaml)
## V1.0
- [POST /s2s/v2.0/task/hair-density-detection](https://docs.perfectcorp.com/ja/reference/ai_hair_density_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-density-detection/post.md): タスクのステータスを確認するにはポーリングが必要です。詳細はポーリングガイドを参照してください。
- [GET /s2s/v2.0/task/hair-density-detection/{task_id}](https://docs.perfectcorp.com/ja/reference/ai_hair_density_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-density-detection~1%7Btask_id%7D/get.md)