皮肤专业版（Skin Pro）

皮肤分析专业版（skin-pro）何时使用 用户上传人脸正面照片，要求专业皮肤检测 用户询问皮肤年龄、肤质、毛孔、痘痘、色斑、皱纹、敏感、黑头、黑眼圈、眼袋等 用户要求皮肤综合评分或多区域细分检测

接口元数据 请求方式：POST URL：https://facepro.ragehealth.cn/openapi-test/face/skin-pro Content-Type：multipart/form-data 认证头：AccessKey、Signature（每次调用前需重新生成）

请求参数 参数 类型 必填 说明 imageUrl String 二选一 图片 URL imageFile File 二选一 图片二进制（jpg/png/webp，≥640×640，≤5MB；优先级高于 imageUrl） faceIdDetect Boolean 否 是否开启 faceId 检测 userGroup String 条件必填 faceIdDetect=true 时必填，作为人脸 id 隔离分组 analyseStrategy Int 否 计分策略：1=skin-pro 默认（默认值），2=察颜小程序计分

调用方式 python scripts/call_skin_pro.py \ --image-url https://example.com/face.jpg \ [--image-file ./face.jpg] \ [--face-id-detect --user-group ] \ [--analyse-strategy 1|2] \ [--output result.json] 凭证由脚本自动从环境变量 SKIN_PRO_AK / SKIN_PRO_SK 读取，不要作为参数传入。首次使用前需前往 https://chayan-test.ragehealth.cn/client 注册申请 AK/SK，写入 scripts/.env。脚本内部会生成 Signature 并以 multipart/form-data 提交。

执行步骤 校验输入：必须有 imageUrl 或本地图片；图片需 jpg/png/webp、≥640×640、≤5MB。 调脚本：拿到 JSON；success=false 时提示用户重拍或检查图片质量。 质量门禁：先看 data.image_quality，命中以下任一项 → 不出报告，提示重拍： brightness.grade != 'zhengchang'（过亮/过暗） blur > 0.3（模糊） face_ratio < 0.5（脸太小，官方默认阈值） abs(face_orientation.yaw) > 15 或 abs(pitch) > 15（侧脸/抬低头过度） hair_occlusion > 0.3（刘海遮挡严重）

解读关键指标（从 data 中按需取）： 综合：skin_score / skin_age / aging_index / skd / skin_rank 肤质：skin_type / skin_tone 主要问题：acne / acne_mark / blackhead / blackhead_count / enlarged_pore_count（dict，按 5 个区域分别计数）/ melanin / sensitivity / oily_intensity 皱纹：forehead_wrinkle / crows_feet / eye_finelines / glabella_wrinkle / nasolabial_fold / wrinkle_count 眼部：eye_pouch / dark_circle 严重度汇总：analyse_result（list[dict]，每项含 type(英文键名)、score(0~100)、label(良好/轻度/中度/重度)、levels；左右脸项目额外含 leftScore/rightScore/leftLabel/rightLabel） 可视化：display_img（带标注展示图）/ face_maps（各维度热力图） 生成报告：综合分 → 肤质 → 主要问题 Top3（优先 label in {中度,重度}，其次按 100-score 降序）→ 改善建议 → 附 display_img。 详细响应字段说明见 references/response_schema.md。

安全 & 合规 必须提醒：检测结果仅供参考，不能替代专业医美/皮肤科诊断 严重皮肤问题应建议线下面诊 不在响应中泄露 AccessKey / SecretKey

示例 用户：帮我用专业版分析下这张照片的皮肤。imageUrl=https://example.com/face.jpg 操作（凭证已在宿主环境配置完成，工具调用只携带业务参数）： python scripts/call_skin_pro.py \ --image-url https://example.com/face.jpg \ --analyse-strategy 1 回复（节选）： 综合评分：78 分，肌龄 26.4，肤质：混合型 主要问题：毛孔（中度，左脸颊 220 个）、黑头（轻度，58 个）、色沉（面积 12%） 皱纹：抬头纹 1，鱼尾纹 2/2 建议：加强清洁控油 + 抗氧化，必要时线下面诊