# AI Fitzpatrick 皮肤类型分析 # 概览 ![](https://plugins-media.makeupar.com/smb/blog/post/2026-01-28/webp_a00e88ca-e20a-4082-89c2-9d486b03b8e8.webp) **AI Fitzpatrick 皮肤类型分析** 把 AI 驱动的Fitzpatrick肤色检测接入您的应用，用相机画面准确判定肤色类型。这个接口可帮助开发者在电商与数字健康平台上搭建个性化的护肤、防晒与商品推荐流程。 **肤色检测** 接口用计算机视觉与机器学习模型分析皮肤特征，一次请求即可返回Fitzpatrick分级。它给出结构化、客观的数据，前端应用、推荐引擎、临床系统可直接取用。 Fitzpatrick肤色量表由 Thomas B. Fitzpatrick 医生提出，依据黑色素水平与紫外线反应把皮肤分为六种类型，便于系统预测晒伤与晒黑的倾向。 **分级结果** 接口基于紫外线反应建模，返回 I 型到 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. 上传图片** 通过以下接口取得上传 URL 与文件 ID： ``` POST /s2s/v2.0/file ``` 用返回的 URL 把图片上传上去。 也可以提供您自有存储上可公开访问的图片 URL。 **3. 可选的预处理** ``` POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process ``` 图片中有多张人脸，或需要显式指定目标时使用这一步。单人脸图片若默认下标够用，这一步可以跳过。 **4. 取得预处理结果** ``` GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process ``` 配置 [webhook](/develop/webhook) 或实现轮询来取得任务结果。用 Webhook 时，任务完成后应用会自动收到通知；用轮询时，系统反复调用任务接口，直到状态从 running 变为 success 或 error。 **5. 执行分析任务** ``` POST /s2s/v2.0/task/fitzpatrick-scale-analyzer ``` 用文件 ID 或图片 URL 作为输入提交任务。响应会返回一个 task_id，用于追踪并取回结果。 **6. 取回任务结果** ``` GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id} ``` 用任务 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 (modern TLS/HTTP support) - jq >= 1.6 (robust JSON parsing) | | Node.js (JavaScript) | Node >= 18 (for global fetch) | | JavaScript | - Chrome / Edge >= 80 - Firefox >= 74 - Safari >= 13.1 | | PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json | | Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 | | Java | Java 11+ (for 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 鉴权。把您的 API 密钥放进请求头： `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-CN/reference/ai_fitzpatrick_skin_type.yaml) ## V1.0 - [POST /s2s/v2.0/task/fitzpatrick-scale-analyzer/pre-process](https://docs.perfectcorp.com/zh-cn/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-cn/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-cn/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，或您的接入方式用不了 We - [GET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_fitzpatrick_skin_type/v1.0/paths/~1s2s~1v2.0~1task~1fitzpatrick-scale-analyzer~1%7Btask_id%7D/get.md)