AI Fitzpatrick 皮肤类型分析
AI Fitzpatrick 皮肤类型分析
把 AI 驱动的Fitzpatrick肤色检测接入您的应用，用相机画面准确判定肤色类型。这个接口可帮助开发者在电商与数字健康平台上搭建个性化的护肤、防晒与商品推荐流程。
肤色检测
接口用计算机视觉与机器学习模型分析皮肤特征，一次请求即可返回Fitzpatrick分级。它给出结构化、客观的数据，前端应用、推荐引擎、临床系统可直接取用。
Fitzpatrick肤色量表由 Thomas B. Fitzpatrick 医生提出，依据黑色素水平与紫外线反应把皮肤分为六种类型，便于系统预测晒伤与晒黑的倾向。
分级结果
接口基于紫外线反应建模，返回 I 型到 VI 型六种标准肤色之一。
有了这个结果，开发者可以给出针对性的商品推荐、让护肤流程自动化，并在各种使用场景中强化个性化，同时保持一致性与可扩展性。
| Fitzpatrick量表 | 肤色类型 | 皮肤对日晒的反应 |
|---|---|---|
| Type I | 白 | 几乎总是晒伤，从不晒黑 |
| Type II | 米白 | 通常会晒伤，晒黑很有限 |
| Type III | 浅棕 | 偶尔晒伤，会逐渐晒黑 |
| Type V | 中棕 | 很少晒伤，很容易晒黑 |
| Type V | 深棕 | 极少晒伤 |
| Type VI | 极深棕 | 几乎不会晒伤 |
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 或实现轮询来取得任务结果。用 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，在任务完成（状态为 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 |