# AI 頭髮密度分析 # 概述 AI 頭髮密度分析提供快速、專業、以照片為基礎的評估，透過評估頭皮可見度與頭髮分布模式，將髮量密度精準分為四個等級，提供源自毛髮鏡的洞察而無需實體工具，並賦能企業僅從單張上傳的圖片，大規模提供專家級的個人化服務。 ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_hair_density_S3_02_b34f2db2ce.jpg) ## 整合指南 * 如何為 AI 頭髮密度分析拍攝照片 * 自拍 - 請在適當光線下正對鏡頭，然後將頭低下至 45 度角。保持頭髮未綁起，並確保您的整條髮際線清晰可見。 ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/img_popup_step_animated_02.aadf7a34.png) - 或者，使用 JS Camera Kit 拍照。 * 如何用 AI 偵測髮量密度 * 使用 ***/s2s/v2.0/file*** API，請上傳以下資產： - 您的自拍照片。 * 執行 AI 任務 ***/s2s/v2.0/task/hair-density-detection*** 傳送一張正面、低頭 45 度的自拍圖片來執行偵測任務。使用其檔案 ID 作為 AI 的來源輸入。 * 輪詢以查詢任務狀態直到成功或錯誤 這個 ***task_id*** 用於透過輪詢 GET 'task/hair-density-detection' 監控任務狀態，以取得目前的引擎狀態。在引擎完成任務之前，狀態會維持為 'running'，此階段不會消耗點數。 ## 髮量密度分級 | 縮略圖 | 髮量密度分級 | 說明 | | --- | --- | --- | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV01.5097a6c2.png) | 等級 1極低密度 | 頭髮明顯稀疏，大面積可見頭皮。髮絲細薄且覆蓋極少。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV02.7966983d.png) | 等級 2低密度 | 明顯稀疏，頭皮清晰可見，尤其是頭頂與分線處。頭髮可能缺乏蓬度與支撐感。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV03.c49dbfb7.png) | 等級 3中等密度 | 在直射光下頭皮部分可見，但頭髮仍維持適度的蓬度與覆蓋。頭髮可能感覺較細，但相對健康。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV04.e467f2aa.png) | 等級 4高密度 | 頭髮看起來豐厚濃密，頭皮幾乎不可見。髮絲緊密排列，提供豐盈的蓬度與自然的覆蓋。 | * 拍攝建議 ![拍攝建議](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/icon_S2_step1_20d0a161da.png) ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_hair_density_S1_02_f60369b14d.jpg) ## 檔案規格與錯誤 * 支援的格式與尺寸 | 類型 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 | | --- | --- | --- | --- | | 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 --- ## 點數消耗 | 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/zh-TW/reference/ai_hair_density_detection.yaml) ## V1.0 - [POST /s2s/v2.0/task/hair-density-detection](https://docs.perfectcorp.com/zh-tw/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/zh-tw/reference/ai_hair_density_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-density-detection~1%7Btask_id%7D/get.md)