AI 頭髮密度分析
AI 頭髮密度分析提供快速、專業、以照片為基礎的評估，透過評估頭皮可見度與頭髮分布模式，將髮量密度精準分為四個等級，提供源自毛髮鏡的洞察而無需實體工具，並賦能企業僅從單張上傳的圖片，大規模提供專家級的個人化服務。
如何為 AI 頭髮密度分析拍攝照片
自拍
- 請在適當光線下正對鏡頭，然後將頭低下至 45 度角。保持頭髮未綁起，並確保您的整條髮際線清晰可見。
- 或者，使用 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'，此階段不會消耗點數。
- 支援的格式與尺寸
| 類型 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|---|---|---|---|
| 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 |
下载 OpenAPI 描述
语言
服务器
https://yce-api-01.makeupar.com