皮肤单点位三光谱分析

兼容保留的单点位三光谱接口，三个光源图片均必传；新接入推荐使用 /analysis_skin_multi。所属业务域名为 https://api.glamskin.ai；nginx 按域名做接口白名单，使用头发业务域名会返回 404。也可使用 IP 直连。业务 code=204 通过 HTTP 200 响应体返回，不是真正的 HTTP 204。

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

请求参数

Body 参数application/json必填

示例

{
    "led_image_url": "https://example.com/led.jpg",
    "polarized_image_url": "https://example.com/polarized.jpg",
    "uv_image_url": "https://example.com/uv.jpg",
    "gender": 1,
    "age": 25,
    "user_id": "u_123",
    "position": 1,
    "language": "zh"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

HTTP 200。响应体可能是成功结构，也可能是业务 code=204 的无检测对象结构；后者不是 HTTP 204 No Content。

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "分析成功",
    "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": "https://api.glamskin.ai/log/example/skin_wrinkle.jpg"
        },
        "polarized": {
            "acne": "https://api.glamskin.ai/log/example/skin_acne.jpg",
            "pigment": "https://api.glamskin.ai/log/example/skin_pigment.jpg",
            "sensitive": "https://api.glamskin.ai/log/example/skin_sensitive.jpg",
            "blackhead": "https://api.glamskin.ai/log/example/skin_blackhead.jpg",
            "skin_tone": "https://api.glamskin.ai/log/example/skin_tone.jpg"
        },
        "uv": {
            "oil": "https://api.glamskin.ai/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
    }
}

🟠400请求有误

🟠413