AI 面部提升

接入指南

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

AI 面部提升接口的流程：

接口地址： /s2s/v2.0/task/face-lift

需要鉴权： Authorization: Bearer YOUR_API_KEY

流程步骤：

1. 准备图片上传：

• 准备好要上传的自拍照。
• 调用 File 接口 /s2s/v2.0/file 取得上传 URL 与对应的 file_id。
• 用提供的上传 URL 把自拍照上传上去。

2. 多张人脸时的可选预处理：

   • 图中有多于一张人脸时，请先对自拍照做预处理。

3. 设置面部提升特效：

   • 先选好合适的面部提升参数。

4. 发起 AI 任务并取得 Task ID：

   • 把 file_id 连同选好的特效配置，通过 HTTP POST 请求送到 /s2s/v2.0/task/face-lift。
   • 响应会返回一个唯一的任务 ID，用于标识本次调用。

5. 轮询任务状态（持续检查）：

   • 用取得的 task_id 通过 HTTP GET 请求定期轮询任务状态（例如 GET /s2s/v2.0/task/face-lift${task_id}）。
   • 持续留意：
     • Task_status = "success"（处理完成）。
     • Task_status = "error"（视情况排查或重试）。
   • 状态转为 success 后，按流程继续往下走。

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

1. 鉴权

   • 请在请求头中以 Bearer Token 方式带上您的 API 密钥：
     Authorization: Bearer YOUR_API_KEY

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

2. 上传图片

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

   • 上传接口

     POST /s2s/v2.0/file

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

3. 用预处理选定要增强的目标人脸

   • 调用预处理接口 输出以像素坐标表示的检测边界框。请用结果的索引在稍后创建面部提升 AI 任务。

     POST /s2s/v2.0/task/face-lift/pre-process

     {
         "timed": number,
         "result": [
             {
                 "left": number,
                 "top": number,
                 "width": number,
                 "height": number
             }
         ]
     }

4. 创建面部提升 AI 任务并轮询结果

   图片和完整的特效参数备齐后即可创建任务。接口异步处理请求，您需要轮询任务状态，直到状态变为 success 或 error。

   • 创建任务接口

     POST /s2s/v2.0/task/face-lift

   • 轮询接口

     GET /s2s/v2.0/task/face-lift/{task_id}

文件规格与错误码

• AI 面部提升规格

支持的自拍视角 图片不得超过 1920 x 1920；长边为 640 时，图中人脸须清楚可见且尺寸大于 32 x 32 像素；拍摄时翻滚角须在正负 75 度以内、偏航角在正负 90 度以内，以确保人脸检测稳定可靠。

• 支持的格式与尺寸

• 错误码

• 运行环境与依赖

JS Camera Kit

点数消耗