# 肌肤拟真

# 概览
**AI 驱动的显老/肤质模拟：精准、专业地可视化护理成效**
我们这套前沿的 AI 肤质模拟技术，能对脸部皮肤状态做出高度还原的调整前后对比，让专业人员和消费者都能客观追踪护肤方案随时间的效果。方案以高保真写实与临床级洞察为设计目标，最多可支持 10 项皮肤问题的可视化：光泽度、痘痘、出油、眼袋、黑眼圈、斑点、毛孔、肤质纹理、皱纹、泛红。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-04-17/4edad54f-ef6b-4842-b104-d114889318b1.jpg)
系统把精密的机器学习模型与强大的增强现实能力结合在一起，只用一部普通手机相机或电脑摄像头，就能给出逼真、非侵入式的成效预览。每次模拟几秒钟完成，用户立刻就能得到一个有科学依据的直观认知：针对性的护肤干预会怎样让肤色肤质随时间变好。
![](https://plugins-media.makeupar.com/smb/blog/post/2025-11-13/webp_27e3ad50-7769-46de-822c-c9300f87f57d.webp)
这套平台专为护肤品牌、皮肤科诊所、医美机构、美妆零售打造，在数字与线下各触点都能轻松接入，包括电商网站、移动应用、线上咨询、门店自助终端。可用场景很广：个性化护肤方案推荐、产品效果模拟、专业疗程方案规划，以及互动式科普工具——这些都能提升客户参与度，让品牌主张更可信。
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_Skin_Simulation_pores_b1e209ee58.jpg)
借助客观的可视化与数据驱动的呈现，我们的 AI 肤质模拟帮助护肤专业人员设定合理预期、定制护理方案、展示可量化的进展，最终把客户体验抬上一个台阶，在日趋竞争的市场里坐实"有效果、有依据"。
![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/strapi/assets/AI_Skin_Simulation_283421234a.jpg)


---

## 接入指南
本指南将带您走完全流程：
AI 年龄模拟器接口的流程：
**接口地址：** `/s2s/v2.0/task/skin-simulation`
**需要鉴权：** `Authorization: Bearer YOUR_API_KEY`
**流程步骤：**
1. **准备图片上传：**
  - 第一步是准备一张自拍照。
2. **肌肤拟真**
每项皮肤问题（例如皱纹、毛孔、泛红）都用 **0.0 到 1.0** 的数值调整 **模拟强度**：
  - **0.0**
：显示您
*原本*
的皮肤状态——不做任何改变。
  - **1.0**
：套用 AI 能为该项问题生成的
*最自然、最健康*
的改善。
**运作方式：**
  - 低强度（例如 0.2–0.4）时，细纹与小瑕疵只是轻轻柔化。
  - 高强度（例如 0.7–1.0）时，改善更明显，例如中度到较深的皱纹显著变浅、纹理更平滑、肤色更均匀，同时仍保留皮肤的自然细节。
一点点调，调到您满意的样子！
3. **发起 AI 任务并取得 Task ID：**
  - 把上传好的图片连同 AI 年龄模拟器配置，通过 HTTP POST 请求送到
`/s2s/v2.0/task/skin-simulation`
。
  - 响应会返回一个唯一的任务 ID，用于标识本次调用。
4. **轮询任务状态（持续检查）：**
  - 用取得的
`task_id`
 通过 HTTP GET 请求定期轮询任务状态（例如
`GET /task/${task_id}`
）。
  - 持续留意：
    - `Task_status = "success"`
（处理完成）。
    - `Task_status = "error"`
（视情况排查或重试）。
  - 状态转为 success 后，按流程继续往下走。

这套规整的流程能顺畅对接用户输入、自动监控任务，并顺利取回结果。


---

* 鉴权

- 请在请求头中以
**Bearer Token**
 方式带上您的 API 密钥：

```
Authorization: Bearer YOUR_API_KEY
```

API Key 可在 https://yce.makeupar.com/api-console/en/api-keys/ 获取。


---

* 上传图片

您可以把文件直接上传到服务器，也可以在 AI 任务参数中提供有效的图片 URL。
* 上传接口


```
POST /s2s/v2.0/file
```
如果您已有公开可访问的图片 URL，这一步可以跳过。


---

* 调整 AI 年龄模拟器强度

**肌肤拟真**

每项皮肤问题（例如皱纹、毛孔、泛红）都可以在 **0.0 到 1.0** 的范围内调整 **模拟强度**：
- **0.0**
 →
*原本状态*
 — 不做任何 AI 增强。
- **1.0**
 → 该项问题
*最大幅度的自然健康改善*
，由我们的 AI 模型按写实方式呈现。

**不同强度档位能看到的效果：**
| 强度区间 | 效果 |
|  --- | --- |
| **0.1 – 0.3** | 轻度修饰 — 细纹轻微柔化、毛孔略微变浅、泛红温和减轻。适合自然的"素净好气色"。 |
| **0.4 – 0.6** | 均衡增强 — 纹理与通透度有明显改善，同时保留个人皮肤的特点。 |
| **0.7 – 1.0** | 全面改善 — 中度到较深的皱纹显著变浅、肤色更均匀、毛孔与泛红减少、整体光泽提升，*不会*有过度磨皮的假感。 |

**行家提示：** 从低档位开始（例如 0.2），一点点调高，直到效果的真实感达到您要的程度。


---

* 创建 AI 年龄模拟器任务并轮询结果

上传图片后，只要把**至少一项**皮肤问题的模拟强度调到 0.0 以上，就可以发起任务。接口异步处理请求，您需要轮询任务状态，直到状态变为 `success` 或 `error`。
* 创建任务接口


```
POST /s2s/v2.0/task/skin-simulation
```
* 轮询接口


```
GET /s2s/v2.0/task/skin-simulation/{task_id}
```


---

## 文件规格与错误码
* AI 年龄模拟器规格

**相机与拍摄指引**
**光线条件**
环境要明亮、光照均匀。避免强逆光、局部过曝，或脸上有大片阴影。尽量使用自然日光或柔和的室内光。不要使用彩色灯光，包括粉色、蓝色等带色温的光源，它们会让肤色呈现失真。
**脸部位置与遮挡**
采用正面视角，脸部正对相机。头部转动要小，避免向任一侧过度倾斜或转动。整张脸——包括额头、脸颊、下巴——都要完整可见、无遮挡。不要用头发、口罩、手、镜框、手机等任何部分遮挡面部特征的物体。
**表情与姿态**
保持自然放松的表情，双眼睁开。嘴巴可以闭合也可以微张，不要绷脸或做夸张姿态。
**画面中的脸部大小**
脸部宽度需至少占图片宽度的 60%，以确保有足够的细节支撑准确分析。不要拍摄过小、过远或构图不当的对象。
![](https://plugins-media.makeupar.com/strapi/assets/thumbnail_skin_analysis_01_5b5defd339.png)


---

* 支持的格式与尺寸

| AI 功能 | 支持尺寸 | 支持文件大小 | 支持格式 |
|  --- | --- | --- | --- |
| AI 年龄模拟器 | 短边 >= 480，长边 <= 2560 | < 10MB | jpg/jpeg/png |

* 错误码

| **错误码** | **说明** |
|  --- | --- |
| `error_below_min_image_size` | 输入图片分辨率低于最小要求（例如 < 256×256 像素）。请上传更高分辨率的图片。 |
| `error_exceed_max_image_size` | 输入图片分辨率超出允许上限（例如 > 2560×2560 像素）。请先缩放或缩小图片再上传。 |
| `error_invalid_params` | 提供的请求参数无效。 |
| `error_src_face_too_small` | 检测到的人脸占图片宽度不足 60%——太小，无法准确做皮肤分析。请改用脸部更大、更清楚且居于画面中央的图片。 |
| `error_src_face_out_of_bound` | 检测到的人脸部分或完全超出画面边界（例如裁得太紧）。请确保整张脸——包括额头、脸颊、下巴——可见且构图得当。 |
| `error_lighting_dark` | 图片环境光线不足以支撑可靠的皮肤分析（例如曝光不足、脸部被阴影主导）。请上传在明亮环境下拍摄、脸部光照均匀的图片。 |

* 运行环境与依赖

| 示例代码语言 / 工具 | 建议运行时版本 |
|  --- | --- |
| cURL | - bash >= 3.2   - curl >= 7.58 (modern TLS/HTTP support)   - jq >= 1.6 (robust JSON parsing) |
| Node.js (JavaScript) | Node >= 18 (for global fetch) |
| JavaScript | - Chrome / Edge >= 80   - Firefox >= 74   - Safari >= 13.1 |
| PHP | PHP >= 7.4 (for modern TLS/compat), ext-curl (recommended) or allow_url_fopen=On + ext-openssl, ext-json |
| Python | Python >= 3.10 (for f-strings), requests >= 2.20.0 |
| Java | Java 11+ (for HttpClient), Jackson Databind >= 2.12.0 |



---

## JS Camera Kit


---

## 点数消耗
* AI 年龄模拟器

| AI 功能 | 消耗点数 |
|  --- | --- |
| 分析 1~4 项皮肤问题 | 4 |
| 分析 5~10 项皮肤问题 | 6 |



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

使用标准的 Bearer 鉴权。把您的 API 密钥放进请求头： `Authorization:Bearer YOUR_API_KEY`。请注意 'Bearer' 与 'YOUR_API_KEY' 之间有一个空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [肌肤拟真](https://docs.perfectcorp.com/_bundle/@l10n/zh-CN/reference/ai_skin_simulation.yaml)

## V1.0

 - [POST /s2s/v2.0/task/skin-simulation](https://docs.perfectcorp.com/zh-cn/reference/ai_skin_simulation/v1.0/paths/~1s2s~1v2.0~1task~1skin-simulation/post.md): 本接口用于发起肌肤拟真流程。您需要提供源文件（URL 或文件 ID），并指定模拟参数（皱纹、光泽等），且至少有一项不能为 0。任务会异步处理，您可以使用本响应返回的 task_id 查询其状态。
 - [GET /s2s/v2.0/task/skin-simulation/{task_id}](https://docs.perfectcorp.com/zh-cn/reference/ai_skin_simulation/v1.0/paths/~1s2s~1v2.0~1task~1skin-simulation~1%7Btask_id%7D/get.md)