{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_fitzpatrick_skin_type.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_fitzpatrick_skin_type.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_fitzpatrick_skin_type"},"disableAutoScroll":true,"seo":{"title":"AI Fitzpatrick 膚色類型分析","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI Fitzpatrick 膚色類型分析","version":"","description":"# 概述\n\n![](https://plugins-media.makeupar.com/smb/blog/post/2026-01-28/webp_a00e88ca-e20a-4082-89c2-9d486b03b8e8.webp)\n\n**AI Fitzpatrick 膚色類型分析**\n\n將 AI 驅動的 Fitzpatrick 膚色類型偵測整合到您的應用，透過攝影輸入準確分類膚質。這個 API 讓開發者為電子商務與數位健康平台建立個人化的護膚、防曬與產品推薦工作流程。\n\n**膚色類型偵測**\n\nAPI 使用電腦視覺與機器學習模型分析皮膚特徵，並在單次請求中回傳 Fitzpatrick 分類。它提供結構化、客觀的資料，可由前端應用、推薦引擎或臨床系統直接消費。\n\n由 Thomas B. Fitzpatrick 醫師提出的 Fitzpatrick 分級，依據黑色素程度與對紫外線曝露的反應定義六種膚色類型，讓系統能預測曬傷或曬黑的傾向。\n\n**分類輸出**\n\nAPI 依據紫外線反應模型，回傳從 Type I 到 Type VI 六種標準化膚色類型之一。\n\n此輸出讓開發者提供客製化的產品推薦、自動化護膚工作流程，並強化跨使用者體驗的個人化邏輯，同時維持一致性與可擴展性。\n\n| Fitzpatrick 分級 | 膚色類型 | 皮膚對太陽的反應 |\n|  ----  | ----  | ---- |\n| Type I | 白色 | 幾乎總是曬傷，從不曬黑 |\n| Type II |  米色 | 通常曬傷，輕微曬黑 |\n| Type III | 淺棕色 | 偶爾曬傷，逐漸曬黑 |\n| Type V | 中棕色 | 罕見曬傷，容易曬黑 |\n| Type V | 深棕色 | 極罕見曬傷 |\n| Type VI | 極深棕色 | 幾乎從不曬傷 |\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/fitapatrick_skin_type_S_02_enu_5e4343e801.jpg)\n\n![](https://plugins-media.makeupar.com/smb/blog/post/2026-03-10/webp_b9ca4198-1a9e-44df-9551-ac3ad8b65d17.webp)\n\n---\n\n## 整合指南\n\n**1. 拍攝圖片**\n在充足光線下拍攝正面圖片。確保臉部清晰可見，並佔畫面足夠的比例。\n\n\n**2. 上傳圖片**\n透過以下方式請求上傳網址與檔案 ID：\n\n```\nPOST /s2s/v2.0/file\n```\n\n使用回傳的網址上傳圖片。\n或者，提供託管在您自有儲存空間、可公開存取的圖片網址。\n\n\n**3. 選填前處理**\n\n```\nPOST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process\n```\n\n當圖片包含多張臉部，或需要明確選擇目標時使用此步驟。對於單張臉部的圖片，若預設索引已足夠，可跳過此步驟。\n\n\n**4. 取得前處理結果**\n\n```\nGET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-ocess\n```\n\n設定 [webhook](/develop/webhook.md) 或實作輪詢以取得任務結果。使用 webhook 時，您的應用會在任務完成時自動收到通知。使用輪詢時，您的系統會重複呼叫任務端點，直到狀態從 running 變為 success 或 error。\n\n**5. 執行分析任務**\n\n```\nPOST /s2s/v2.0/task/fitzpatrick-scale-analyzer\n```\n\n使用檔案 ID 或圖片網址作為輸入提交任務。回應會回傳 task_id 用於追蹤與取得結果。\n\n\n**6. 取得任務結果**\n\n```\nGET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id}\n```\n\n使用務  追蹤狀態並取得結果。\n\n可設定 [Webhooks](/develop/webhook.md) 在任務完成時接收非同步通知，狀態為 success 或 error。也支援輪詢，重複呼叫任務端點直到狀態從 running 更新為 success 或 error。\n\n僅在任務成功完成時才計費。\n\n---\n\n## 檔案規格與錯誤\n\n* 支援的格式與尺寸\n\n|AI 功能|支援的尺寸|支援的檔案大小|支援的格式|\n|  ----  | ----  | ----  | ----  |\n| AI Fitzpatrick 膚色類型分析 | 較長邊不得超過 4096 像素，較短邊不得少於 320 像素。 | < 10MB | jpg/jpeg |\n\n* 錯誤代碼\n\n|錯誤代碼|說明|\n|  ----  | ----  |\n| error_below_min_image_size | 來源圖片尺寸必須至少為 320 像素。 |\n|error_face_position_invalid|您的臉部必須在圖片中完全可見，不可有任何部分被裁切|\n|error_face_position_too_small|您照片中的臉部太小，無法妥善分析|\n|error_face_position_out_of_boundary|您的臉部過大，或部分超出照片邊緣|\n|error_insufficient_lighting|光線過暗，導致難以分析|\n|error_face_angle_invalid|您的臉部角度不太正確。正面拍攝時，請讓頭部偏離直線不超過 10 度。側面拍攝時，角度應超過 15 度|\n\n* 環境與相依性\n\n| 範例程式語言 / 工具 | 建議的執行環境版本 |\n|---|---|\n| cURL | - bash >= 3.2</br>   - curl >= 7.58（現代 TLS/HTTP 支援）</br>   - jq >= 1.6（穩健的 JSON 解析） |\n| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |\n| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |\n| Java | Java 11+（支援 HttpClient），Jackson Databind >= 2.12.0 |\n\n---\n\n## 點數消耗\n\n| AI 功能 | 消耗的點數 |\n|---|---|\n| AI Fitzpatrick 膚色類型分析 V1.0 | 10 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.199"},"lang":"zh-TW","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/reference/ai_fitzpatrick_skin_type","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}