AI 髮質檢測
想像您的口袋裡有一位 AI 頭髮專家。我們的技術深入分析您頭髮的質地、厚度與捲曲模式，從十種獨特的捲曲形狀中挑選，並歸類為九種明確的類型，從 Straight（直髮）到 Super Kinky（極度捲曲）。您會獲得完整的頭髮檔案，品牌也能運用這些洞察，為您提供精準的產品推薦與建議。
如何為 AI 髮質檢測拍攝照片
從左側、正面、右側拍攝 3 張照片。
- 只需快速拍攝三張自拍。一張正對前方，一張向左轉約 45 度，一張向右轉 45 度。我們要從各角度捕捉您頭髮的完整外觀。請確保每張照片中，您的整張臉與頭髮的上緣都清晰可見。您的臉部應佔圖片寬度的約 50% 到 80%。不要太遠，也不要太近。這樣才足夠清晰供分析。拍攝側面照片時，請像說「不」一樣左右轉動頭部（這稱為 yaw 旋轉）。保持頭部水平，不要上下或左右傾斜。請避免背面或俯視角度，因為那些角度無法使用。
- 您可以使用 JS Camera Kit 拍攝照片。請確保頭髮未綁起，讓它垂在胸前。向右轉頭並保持靜止，再向左轉，取得 3 張待分析的照片。
如何用 AI 偵測髮質類型
使用 /s2s/v2.0/file API，請上傳以下資產：
- 正面、右側與左側的照片。
執行 AI 任務 /s2s/v2.0/task/hair-type-detection
傳送三張圖片執行髮質類型偵測任務：一張正面、一張右側、一張左側。使用它們的檔案 ID 作為 AI 的來源輸入。輪詢以查詢任務狀態直到成功或錯誤
這個 task_id 用於透過輪詢 GET 'task/hair-type-detection' 監控任務狀態，以取得目前的引擎狀態。在引擎完成任務之前，狀態會維持為 'running'，此階段不會消耗點數。
| 類別 | 縮略圖 | 髮質類型分類 | 說明 |
|---|---|---|---|
| 1 |  | Straight（直髮） | 此髮質類型的特徵是髮絲缺乏自然捲曲，通常從髮根到髮梢直直垂下 |
| 2A |  | Slight Wavy（微波浪） | 此髮質類型具有細微、細緻的波浪，質地平滑且略帶凌亂感，但髮根缺乏蓬度 |
| 2B |  | Medium Wavy（中等波浪） | 此髮質類型展現自然的 S 形波浪，通常從髮桿中段開始，細緻地貼合頭部，創造細膩而精緻的層次 |
| 2C |  | Thick Wavy（厚波浪） | 此髮質類型的波浪質地較粗，形狀如字母「S」，從髮根開始並沿頭髮長度向下延伸。此髮質容易毛躁 |
| 3A |  | Loose Curls（鬆散捲曲） | 這些捲曲大而放鬆、富有彈性，從髮根到髮梢都有明顯的光澤 |
| 3B |  | Medium Curls（中等捲曲） | 此髮質類型由粗而富有彈性的圓圈狀捲曲組成，容易毛躁 |
| 3C |  | 緊密捲曲 | 這些捲曲具有密集緊實的開瓶器形形狀，帶來充足的蓬度 |
| 4A |  | Kinky Soft（柔軟極捲） | 此髮質類型的特徵是緊密排列、富有彈性的 S 形螺旋 |
| 4B |  | Coily（螺旋髮） | 密集排列的螺旋緊密纏繞成銳利的鋸齒角度 |
| 4C |  | 極度螺旋 | 此髮質類型的特徵是緊密蓬鬆的螺旋，較容易斷裂 |
結果參數
mapping：結果為字串，顯示偵測到的髮質類型類別。以下以陣列列出所有可能的結果字串：
["1 to 2a", "2a to 2b", "2b to 2c", "2c to 3a", "3a to 3b", "3b to 3c", "3c to 4a", "4a to 4b", "4b to 4c"]term：髮質類型類別與其分類之間一比一對應的字串。以下以陣列列出所有可能的結果字串：
["Straight to Slight Wavy", "Slight to Medium Wavy", "Medium to Thick Wavy", "Thick Wavy to Loose Curls", "Loose to Medium Curls", "Medium to Tight Curls", "Tight Curls to Kinky Soft", "Kinky Soft to Coily", "Coily to Extremely Coily"]拍攝建議
- 支援的格式與尺寸
| 類型 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|---|---|---|---|
| AI 髮質檢測 | 圖片寬與高必須至少 320 像素，且任一維度不得超過 4096 像素。若您的圖片其中一邊超過 1080 像素，會自動調整尺寸至該限制內以進行分析。 | < 10MB | jpg/png |
- 錯誤代碼
| 錯誤代碼 | 說明 |
|---|---|
| error_mismatch_image_size | 請確保您所有的臉部照片（正面、左側、右側）尺寸相同 |
| 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 |
下载 OpenAPI 描述
语言
服务器
https://yce-api-01.makeupar.com