{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-CN/reference/ai_fitzpatrick_skin_type.yaml","sidebar":"sidebar-@l10n/zh-CN/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-CN/reference/ai_fitzpatrick_skin_type.yaml","settings":{"baseUrlPath":"/zh-cn/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肤色检测接入您的应用，用相机画面准确判定肤色类型。这个接口可帮助开发者在电商与数字健康平台上搭建个性化的护肤、防晒与商品推荐流程。\n\n**肤色检测**\n\n接口用计算机视觉与机器学习模型分析皮肤特征，一次请求即可返回Fitzpatrick分级。它给出结构化、客观的数据，前端应用、推荐引擎、临床系统可直接取用。\n\nFitzpatrick肤色量表由 Thomas B. Fitzpatrick 医生提出，依据黑色素水平与紫外线反应把皮肤分为六种类型，便于系统预测晒伤与晒黑的倾向。\n\n**分级结果**\n\n接口基于紫外线反应建模，返回 I 型到 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通过以下接口取得上传 URL 与文件 ID：\n\n```\nPOST /s2s/v2.0/file\n```\n\n用返回的 URL 把图片上传上去。\n也可以提供您自有存储上可公开访问的图片 URL。\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-process\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 或图片 URL 作为输入提交任务。响应会返回一个 task_id，用于追踪并取回结果。\n\n\n**6. 取回任务结果**\n\n```\nGET /s2s/v2.0/task/fitzpatrick-scale-analyzer/{task_id}\n```\n\n用任务 ID 追踪状态并取得结果。\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 (modern TLS/HTTP support)</br>   - jq >= 1.6 (robust JSON parsing) |\n| Node.js (JavaScript) | Node >= 18 (for global fetch) |\n| JavaScript | - Chrome / Edge >= 80</br>   - Firefox >= 74</br>   - Safari >= 13.1 |\n| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |\n| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |\n| Java | Java 11+ (for 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.217.126"},"lang":"zh-CN","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-cn/reference/ai_fitzpatrick_skin_type","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}