皮肤多点位多光谱分析（支持 multipart 直传）

皮肤主推接口，支持 1-7 任意点位子集，且每个点位至少提供一个光源 URL。所属业务为皮肤业务，计划使用 https://api.glamskin.ai；但该新路由尚未加入 nginx 域名白名单，经域名调用会 404，当前仅 http://45.207.228.66:5000 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 检出，升级后 oil_count/oil_density/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": 2,
            "led_image_url": "https://example.com/led-2.jpg",
            "polarized_image_url": "https://example.com/polarized-2.jpg"
        },
        {
            "position_index": 6,
            "polarized_image_url": "https://example.com/polarized-6.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

示例

{
    "code": 200,
    "msg": "分析成功",
    "overall_score": 91.3,
    "success_count": 1,
    "positions": {
        "1": {
            "score": 91.3,
            "score_sep": {
                "acne": 98.5,
                "pigment": 95.2,
                "sensitive": 72.4,
                "blackhead": 88,
                "oil": 96.7,
                "skin_tone": 90.1
            },
            "suggestion": {
                "acne": "皮肤清洁状态良好...",
                "pigment": "皮肤色斑状态良好...",
                "sensitive": "皮肤出现中度敏感反应...",
                "blackhead": "黑头状态良好...",
                "oil": "油脂状态良好...",
                "skin_tone": "肤色较为均匀..."
            },
            "urls": {
                "led": {
                    "wrinkle": "http://45.207.228.66:5000/log/example/skin_wrinkle.jpg"
                },
                "polarized": {
                    "acne": "http://45.207.228.66:5000/log/example/skin_acne.jpg",
                    "pigment": "http://45.207.228.66:5000/log/example/skin_pigment.jpg",
                    "sensitive": "http://45.207.228.66:5000/log/example/skin_sensitive.jpg",
                    "blackhead": "http://45.207.228.66:5000/log/example/skin_blackhead.jpg",
                    "skin_tone": "http://45.207.228.66:5000/log/example/skin_tone.jpg"
                },
                "uv": {
                    "oil": "http://45.207.228.66:5000/log/example/skin_oil.jpg"
                }
            },
            "data": {
                "wrinkle_area": 0,
                "pore_count": 0,
                "pore_density": 0,
                "acne_area_rate": 0.31,
                "acne_count": 2,
                "acne_avg_area": 18000,
                "acne_area": 0.31,
                "pigment_area_rate": 0.1,
                "pigment_count": 1,
                "pigment_avg_area": 12000,
                "pigment_area": 0.1,
                "sensitive_area_rate": 40,
                "sensitive_area": 40,
                "blackhead_count": 4,
                "blackhead_density": 0.02,
                "blackhead_area": 2,
                "oil_count": 18,
                "oil_density": 0.03,
                "oil_area": 12,
                "skin_tone_score": 0.146
            }
        },
        "6": {
            "code": 204,
            "msg": "未检测到对象"
        }
    }
}

🟠400请求有误

🟠413

皮肤多点位多光谱分析（支持 multipart 直传）

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

请求参数

请求示例代码

返回响应

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