多角度自拍收集+正面发际线分级（仅 multipart 直传）

多角度自拍收集接口：一次最多收 4 张不同角度自拍（front 必传，left/right/top 可选），全部落盘并整单写一行 hair_scans；当前仅 front（正面照）进入发际线三轴分级链路，其余角度只收集不分析（为后续多角度算法积累数据）。所属业务域名为 https://api.lushair.ai；nginx 按域名做接口白名单，使用皮肤业务域名会返回 404。也可使用 IP 直连。正面照无人脸、头顶未入镜或检测异常时使用真正的 HTTP 500（此时照片已落盘但不写库）。当前算法阈值尚未标定，结果仅供灰度参考，并非诊断。

仅 multipart 直传（无 JSON URL 模式）

文件字段名 = 角度枚举 front / left / right / top（front 必传，其余可选）+ 文本字段 meta：

约束（均整单 400，服务端会清掉已落盘的部分文件，不留孤儿文件）：

文件字段名只允许 4 个角度枚举，出现其他字段名整单拒绝；

front 缺失 / 任一角度同名重复 / 单文件超 10MB / 解码失败 → 400；

非 multipart 请求（如 JSON）→ 400；整请求超 100MB → HTTP 413。

响应 data 对齐 /analysis_hairline 成功契约（status/url/三轴 {value,conf}），差异：

source_urls 替代 source_url：恒含 4 个角度键，未传角度为 null；

hair_scan_uuid：整单一行写 hair_scans（selfie 多角度三层嵌套格式
{"selfie":{"front":{"white":url},...}}，scan_context=home，spectrum=["white"]），
前端凭 UUID 补写其余业务列；写库失败为 null（分析结果不受影响）。
三轴枚举映射表与 /analysis_hairline 相同（见该接口文档）。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

收集与正面照分析成功。

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "分析成功",
    "data": {
        "status": "ok",
        "url": "https://api.lushair.ai/log/hairline_multi_example/output/example_hairline.jpg",
        "source_urls": {
            "front": "https://api.lushair.ai/log/hairline_multi_example/input/example_front.jpg",
            "left": "https://api.lushair.ai/log/hairline_multi_example/input/example_left.jpg",
            "right": null,
            "top": null
        },
        "stage": {
            "value": 3,
            "conf": 0.61
        },
        "pattern": {
            "value": 3,
            "conf": 0.72
        },
        "position": {
            "value": 1,
            "conf": 0.8
        },
        "hair_scan_uuid": "550e8400-e29b-41d4-a716-446655440000"
    }
}

🟠400请求有误

🟠413

🔴500服务器错误

多角度自拍收集+正面发际线分级（仅 multipart 直传）

仅 multipart 直传（无 JSON URL 模式）#

请求参数

请求示例代码

返回响应

仅 multipart 直传（无 JSON URL 模式）