# AI Fitzpatrick 膚色類型分析 # 概述 ![](https://plugins-media.makeupar.com/smb/blog/post/2026-01-28/webp_a00e88ca-e20a-4082-89c2-9d486b03b8e8.webp) **AI Fitzpatrick 膚色類型分析** 將 AI 驅動的 Fitzpatrick 膚色類型偵測整合到您的應用，透過攝影輸入準確分類膚質。這個 API 讓開發者為電子商務與數位健康平台建立個人化的護膚、防曬與產品推薦工作流程。 **膚色類型偵測** API 使用電腦視覺與機器學習模型分析皮膚特徵，並在單次請求中回傳 Fitzpatrick 分類。它提供結構化、客觀的資料，可由前端應用、推薦引擎或臨床系統直接消費。 由 Thomas B. Fitzpatrick 醫師提出的 Fitzpatrick 分級，依據黑色素程度與對紫外線曝露的反應定義六種膚色類型，讓系統能預測曬傷或曬黑的傾向。 **分類輸出** API 依據紫外線反應模型，回傳從 Type I 到 Type VI 六種標準化膚色類型之一。 此輸出讓開發者提供客製化的產品推薦、自動化護膚工作流程，並強化跨使用者體驗的個人化邏輯，同時維持一致性與可擴展性。 | Fitzpatrick 分級 | 膚色類型 | 皮膚對太陽的反應 | | --- | --- | --- | | Type I | 白色 | 幾乎總是曬傷，從不曬黑 | | Type II | 米色 | 通常曬傷，輕微曬黑 | | Type III | 淺棕色 | 偶爾曬傷，逐漸曬黑 | | Type V | 中棕色 | 罕見曬傷，容易曬黑 | | Type V | 深棕色 | 極罕見曬傷 | | Type VI | 極深棕色 | 幾乎從不曬傷 | ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/fitapatrick_skin_type_S_02_enu_5e4343e801.jpg) ![](https://plugins-media.makeupar.com/smb/blog/post/2026-03-10/webp_b9ca4198-1a9e-44df-9551-ac3ad8b65d17.webp) --- ## 整合指南 **1. 拍攝圖片** 在充足光線下拍攝正面圖片。確保臉部清晰可見，並佔畫面足夠的比例。 **2. 上傳圖片** 透過以下方式請求上傳網址與檔案 ID： ``` POST /s2s/v2.0/file ``` 使用回傳的網址上傳圖片。 或者，提供託管在您自有儲存空間、可公開存取的圖片網址。 **3. 選填前處理** ``` POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process ``` 當圖片包含多張臉部，或需要明確選擇目標時使用此步驟。對於單張臉部的圖片，若預設索引已足夠，可跳過此步驟。 **4. 取得前處理結果** ``` GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-ocess ``` 設定 [webhook](/develop/webhook) 或實作輪詢以取得任務結果。使用 webhook 時，您的應用會在任務完成時自動收到通知。使用輪詢時，您的系統會重複呼叫任務端點，直到狀態從 running 變為 success 或 error。 **5. 執行分析任務** ``` POST /s2s/v2.0/task/fitzpatrick-scale-analyzer ``` 使用檔案 ID 或圖片網址作為輸入提交任務。回應會回傳 task_id 用於追蹤與取得結果。 **6. 取得任務結果** ``` GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id} ``` 使用務 追蹤狀態並取得結果。 可設定 [Webhooks](/develop/webhook) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。 僅在任務成功完成時才計費。 --- ## 檔案規格與錯誤 * 支援的格式與尺寸 | AI 功能 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 | | --- | --- | --- | --- | | AI Fitzpatrick 膚色類型分析 | 較長邊不得超過 4096 像素，較短邊不得少於 320 像素。 | < 10MB | jpg/jpeg | * 錯誤代碼 | 錯誤代碼 | 說明 | | --- | --- | | 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 | --- ## 點數消耗 | AI 功能 | 消耗的點數 | | --- | --- | | AI Fitzpatrick 膚色類型分析 V1.0 | 10 | --- 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 Fitzpatrick 膚色類型分析](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_fitzpatrick_skin_type.yaml) ## V1.0 - [POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process](https://docs.perfectcorp.com/zh-tw/reference/ai_fitzpatrick_skin_type/v1.0/paths/~1s2s~1v2.0~1task~1fitzpatrick-scale-analyzer~1pre-process/post.md): 當來源照片可能包含超過一個有效目標，或您的整合需要明確選擇哪個被偵測到的目標接受特效時，請使用前處理任務。對於單一目標的圖片，當功能支援預設的 `index` 值，且您的應用程式不需要手動選擇目標時，可以跳過前處理。 前處理任務會偵測來源照片中的候選目標，並在 `data.results.result` 中回傳它們的座標。結果陣列中的每個項目代表一個被偵測到的目標。檢視回傳的座標，將它們對應到來源 - [GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_fitzpatrick_skin_type/v1.0/paths/~1s2s~1v2.0~1task~1fitzpatrick-scale-analyzer~1pre-process~1%7Btask_id%7D/get.md) - [POST /s2s/v2.0/task/fitzpatrick-scale-analyzer](https://docs.perfectcorp.com/zh-tw/reference/ai_fitzpatrick_skin_type/v1.0/paths/~1s2s~1v2.0~1task~1fitzpatrick-scale-analyzer/post.md): AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 `success` 或 `error` 通知後，使用收到的 `task_id` 查詢任務結果。設定與驗證細節請見 [webhook 整合指南](/develop/webhook)。 若您的整合不支援 webhook 或無法使用 - [GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_fitzpatrick_skin_type/v1.0/paths/~1s2s~1v2.0~1task~1fitzpatrick-scale-analyzer~1%7Btask_id%7D/get.md)