头发多点位多光谱分析（支持 multipart 直传）

头发主分析接口，支持 1-7 任意点位子集，且每个点位至少提供一个光源 URL。所属业务域名为 https://api.lushair.ai；nginx 按域名做接口白名单，使用皮肤业务域名会返回 404。也可使用 IP 直连。业务 code=204 通过 HTTP 200 响应体返回，不是真正的 HTTP 204。 2026-07-24 起支持 multipart/form-data 直传模式（与 JSON URL 模式按 Content-Type 自动区分，响应结构一致且每点位节点新增 source_urls 原图 URL，供调用方写扫描记录——AI 侧不写业务库）。

两种传图方式（本接口同时支持，按 Content-Type 自动区分）

方式一：JSON URL 模式（旧，兼容保留） — 图先传 OSS/图床，请求体只带 URL，服务器自行下载：

方式二：multipart 直传（新，推荐） — 图像文件直接放进请求，快约 2.2 倍（实测 21 图 46s→21s）。
文件字段名 pos{1-7}_{led|polarized|uv} 即点位×光源；公共参数打包进文本字段 meta：

在本页「Body」区域切换请求体格式可分别查看两种模式的完整字段定义。
响应结构两种模式一致；每点位节点的 source_urls（原图 URL）供业务侧写库。
限制：单文件 ≤10MB（超返 400）、整请求 ≤100MB（超返 413）。
各端（fetch/axios/微信小程序）完整接入代码见仓库 docs/multipart_frontend_examples.md。

2026-08-10 起（algo-v0.32.1）：UV 头皮油脂检测新增灰世界自动白平衡，自动兼容新厂家未做白平衡的蓝紫 UV 原图（按 B/R 通道均值比阈值 1.5 自动判别）。老设备图不触发、数值零回归；新厂家设备图此前近乎恒 0 检出，升级后 scalp_oil_area 返回真实数值属预期，勿当回归。

请求参数

Body 参数

application/json

必填

示例

{
    "gender": 1,
    "age": 25,
    "user_id": "u_123",
    "language": "zh",
    "positions": [
        {
            "position_index": 1,
            "led_image_url": "https://example.com/led.jpg",
            "polarized_image_url": "https://example.com/polarized.jpg",
            "uv_image_url": "https://example.com/uv.jpg"
        },
        {
            "position_index": 3,
            "polarized_image_url": "https://example.com/polarized-3.jpg"
        },
        {
            "position_index": 5,
            "led_image_url": "https://example.com/led-5.jpg",
            "uv_image_url": "https://example.com/uv-5.jpg"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

HTTP 200。响应体可能是成功结构，也可能是业务 code=204 的无检测对象结构；后者不是 HTTP 204 No Content。失败点位降级为 {code, msg}。

Bodyapplication/json

示例

一个点位成功HTTP 200 下的业务码 204

{
    "code": 200,
    "msg": "分析成功",
    "overall_score": 97.4,
    "success_count": 1,
    "positions": {
        "1": {
            "score": 97.4,
            "indicators": {
                "redness_area": {
                    "light": "polarized",
                    "image_key": "redness",
                    "value": 41.86,
                    "score": 91,
                    "grade": "正常",
                    "suggestion": "恭喜您，您的头皮不存在敏感问题！",
                    "url": "https://api.lushair.ai/log/example/hair_redness.jpg"
                }
            },
            "raw_metrics": {
                "follicle_density": 30.02,
                "white_hair_count": 0,
                "terminal_hair_rate": 16,
                "medium_hair_rate": 37,
                "velveolus_hair_rate": 47,
                "scurf_count": 3,
                "scalp_oil_count": 8
            }
        }
    }
}

🟠400请求有误

🟠413

头发多点位多光谱分析（支持 multipart 直传）

两种传图方式（本接口同时支持，按 Content-Type 自动区分）#

请求参数

请求示例代码

返回响应

两种传图方式（本接口同时支持，按 Content-Type 自动区分）