# AI 发型发量密度检测 # 概览 AI 发密度检测用照片就能快速做出专业评估：通过观察头皮显露程度与头发分布形态，把发密度分成四档，给出近似毛发镜检查的洞察，不必借助任何实体工具。商家上传一张图即可规模化地提供专家级的个性化服务。 ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_hair_density_S3_02_b34f2db2ce.jpg) ## 接入指南 * AI 发密度检测怎么拍照 * 拍一张自拍 - 请正对镜头、光线充足，然后把头低到 45 度。头发不要扎起来，整条发际线要清楚可见。 ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/img_popup_step_animated_02.aadf7a34.png) - 也可以用 JS Camera Kit 拍照。 * 如何用 AI 检测发密度 * 请用 ***/s2s/v2.0/file*** 接口上传以下素材： - 您的自拍照片。 * 执行 AI 任务 ***/s2s/v2.0/task/hair-density-detection*** 送一张正脸、低头 45 度的自拍图片来执行检测任务，把它的文件 ID 作为 AI 的输入源。 * 轮询任务状态，直到成功或报错 用这个 ***task_id*** 轮询 GET 'task/hair-density-detection' 监控任务状态，取得引擎当前的处理进度。引擎完成任务之前，状态会一直是 'running'，这一阶段不消耗点数。 ## 发密度分级 | 缩略图 | 发密度分级 | 说明 | | --- | --- | --- | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV01.5097a6c2.png) | 第 1 级极低密度 | 头发明显稀疏，大面积可见头皮。发丝细，覆盖度很低。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV02.7966983d.png) | 第 2 级低密度 | 稀疏可见，头顶与分缝处头皮尤其明显。头发缺少蓬松感与厚度。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV03.c49dbfb7.png) | 第 3 级中等密度 | 强光下可部分看到头皮，但头发仍有一定蓬松度与覆盖度。发丝偏细，整体还算健康。 | | ![](https://d3ss46vukfdtpo.cloudfront.net/static/media/dt_classification_LV04.e467f2aa.png) | 第 4 级高密度 | 头发饱满浓密，几乎看不到头皮。发丝排列紧密，蓬松充足、覆盖自然。 | * 拍摄建议 ![Suggestions for How to Shoot](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/icon_S2_step1_20d0a161da.png) ![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_hair_density_S1_02_f60369b14d.jpg) ## 文件规格与错误码 * 支持的格式与尺寸 | 类型 | 支持尺寸 | 支持文件大小 | 支持格式 | | --- | --- | --- | --- | | AI 发密度检测 | 图片宽高至少 100 像素，任一维度不超过 4096 像素。若某一边超过 1080 像素，会自动缩放到该上限以内进行分析。 | < 10MB | jpg/png | * 错误码 | 错误码 | 说明 | | --- | --- | | error_below_min_image_size | 图片宽或高小于 100 像素，尺寸过小，无法使用 | | 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 | --- ## JS Camera Kit --- ## 点数消耗 | AI 功能 | 消耗点数 | | --- | --- | | AI 发密度检测 V1.0 | 1 | --- 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 发型发量密度检测](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_hair_density_detection.yaml) ## V1.0 - [POST /s2s/v2.0/task/hair-density-detection](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_density_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-density-detection/post.md): 需要轮询才能查到任务状态，细节请参见轮询指南。 - [GET /s2s/v2.0/task/hair-density-detection/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_hair_density_detection/v1.0/paths/~1s2s~1v2.0~1task~1hair-density-detection~1%7Btask_id%7D/get.md)