这是什么。 标准 AI 肤质分析针对您选定的皮肤问题给出客观、量化的评分，并附上精准的检测蒙版与热力图。
依托先进的 AI 深度学习与面部区域分割技术，Perfect Corp AI 肤质分析无需物理接触，即可从数字图片中评估可见的皮肤状况。方案会输出量化评分、检测蒙版、热力图与 AR 叠加效果，用个性化的护肤洞察帮助用户更了解自己的皮肤，并据此定制属于每个人的护肤流程。
支持的皮肤问题包括：
- 皱纹
- 水润度
- 紧致度
- 上睑下垂
- 下睑下垂
- 毛孔
- 纹理
- 痘痘
- 出油
- 色斑
- 黑眼圈
- 光泽度
- 泛红
- 眼袋
- 泪沟
此外还会输出肤质、预估肌肤年龄与整体肌肤状况评分。所有结果都是基于图片的指标，仅供护肤参考，不构成临床测量、诊断或医学评估。
- 创建 AI 任务
# Standard Skin Analysis V2.1
curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"src_file_url": "https://your-cdn.example.com/customer-001.jpg",
"dst_actions": ["hd_wrinkle", "hd_pore", "hd_texture", "hd_acne"],
"format": "zip",
"pf_camera_kit": true
}'- 轮询获取报告与推荐
每次调用都会立刻返回一个 BasicRunTaskResponseV2。用返回的 id 轮询任务即可；报告与推荐结果都在 llm_results.json 里。
# 1. Run the task and capture the task id
TASK_ID=$(curl -sS -X POST "$BASE_URL/s2s/v2.1/task/skin-analysis" \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{ ... }' | jq -r '.data.task_id')
# 2. Poll until task_status is "success"
curl -sS -H "Authorization: Bearer $API_KEY" \
"$BASE_URL/s2s/v2.1/task/skin-analysis/$TASK_ID"task_status 会从 running 走到 success | error。用 format: zip 时，results.url 是一条有效期为 2 小时的下载链接，ZIP 里有 skinanalysisResult 目录，内含 score_info.json 和所有检测结果图片。用 format: json 时，results.output 会把评分直接写在响应体里。
- 请求字段速查
| 字段 | 必填 | 说明 |
|---|---|---|
src_file_id / src_file_url | 是（二选一） | 输入图片，规则同 BasicRunTaskV2 |
dst_actions | 是 | 要么全是 HD 项目，要么全是 SD 项目——不能混用 |
format | 否 | zip（默认）| json——两者的响应结构不同 |
pf_camera_kit | 否 | V2.1 新增；脸部轮廓与五官定位 |
miniserver_args | 否 | 蒙版叠加，以及 HD 毛孔／皱纹的底图控制项 |
advanced_report | 否 | 传了就出报告；{} 表示全部用默认值；不传就没有报告 |
product_recommendation | 否 | 传了就出推荐；需要 catalog_id |
分辨率。 所有输出图片的长边都限制在 2560 px 以内，输入图片会自动缩放。若 enable_mask_overlay 为 false，您拿到的是原始蒙版 .png，需要自行合成——请先确认输入图片的分辨率，长边超过 2560 px 时，按 2560 px 来规划您的显示尺寸。