肌肤拟真

接入指南

本指南将带您走完全流程：

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。

• 上传接口

如果您已有公开可访问的图片 URL，这一步可以跳过。

• 调整 AI 年龄模拟器强度 肌肤拟真

每项皮肤问题（例如皱纹、毛孔、泛红）都可以在 0.0 到 1.0 的范围内调整 模拟强度：

• 0.0 → 原本状态 — 不做任何 AI 增强。
• 1.0 → 该项问题最大幅度的自然健康改善，由我们的 AI 模型按写实方式呈现。

不同强度档位能看到的效果：

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

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

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

• 创建任务接口

• 轮询接口

文件规格与错误码

• AI 年龄模拟器规格

相机与拍摄指引

光线条件 环境要明亮、光照均匀。避免强逆光、局部过曝，或脸上有大片阴影。尽量使用自然日光或柔和的室内光。不要使用彩色灯光，包括粉色、蓝色等带色温的光源，它们会让肤色呈现失真。

脸部位置与遮挡 采用正面视角，脸部正对相机。头部转动要小，避免向任一侧过度倾斜或转动。整张脸——包括额头、脸颊、下巴——都要完整可见、无遮挡。不要用头发、口罩、手、镜框、手机等任何部分遮挡面部特征的物体。

表情与姿态 保持自然放松的表情，双眼睁开。嘴巴可以闭合也可以微张，不要绷脸或做夸张姿态。

画面中的脸部大小 脸部宽度需至少占图片宽度的 60%，以确保有足够的细节支撑准确分析。不要拍摄过小、过远或构图不当的对象。

• 支持的格式与尺寸

• 错误码

• 运行环境与依赖

JS Camera Kit

点数消耗

• AI 年龄模拟器