# 髪の長さ分析 # 概要 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*** の実行 正面を向いた自撮り画像を 1 枚送信して、髪の長さ検出タスクを実行します。AI のソース入力としてそのファイル ID を使用します。 * タスクのステータスを成功またはエラーになるまでポーリングで確認します この ***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 - 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 --- ## ユニット消費 | 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_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)