皮肤分析专业版（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 <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
建议：加强清洁控油 + 抗氧化，必要时线下面诊