面部属性与比例分析

接入指南

• AI 面部属性与比例分析怎么拍照

• 正脸自拍一张

  • 拍一张清楚的照片即可，正对镜头。头发最好自然放下，整张脸都要露出来、不要有遮挡。把头发往后梳、露出额头，视线直视前方，拍出标准的正脸角度。
  • 也可以用 JS Camera Kit 拍照。跟着自动脸部对齐、光线引导和脸部大小检测走，保证照片符合处理要求。

• 如何用 AI 检测肌肤问题

1. 调整源图尺寸
   把图片缩放到支持的尺寸范围，详见 文件规格与错误码

2. 用 File 接口上传文件
   通过 /s2s/v2.0/file 接口上传目标用户图片。

   • 图片要求

     • 详见 文件规格与错误码。

   • 重要：只调用 File 接口并不等于上传了文件。您必须手动把文件上传到 File 接口响应中给出的那个 URL，那个 URL 就是您的上传目标，务必确认文件已成功传过去，再继续往下做。
     调用 AI 接口之前，请确认文件已上传成功。先用 File 接口取到一个上传 URL，把文件上传到该位置。上传完成后，您会在响应中收到一个 file_id，调用与该文件相关的 AI 功能时就用它。

     警告： 请注意，若未把文件上传到 File 接口响应中给出的 URL，调用 AI 接口时会得到 500 Server Error / unknown_internal_error 或 404 Not Found 错误。

3. 执行 AI 面部属性与比例分析任务
   上传完成后，就可以用文件 ID 选择要分析的多项脸部特征，详见 输入与输出。
   随后用文件 ID 调用 POST 'task/face-attr-analysis' 执行任务， 并取得 task_id。

4. 轮询任务状态，直到成功或报错
   用这个 task_id 轮询 GET 'task/face-attr-analysis' 监控任务状态，取得引擎当前的处理进度。引擎完成任务之前，状态会一直是 'running'，这一阶段不消耗点数。

   警告： 请注意，轮询任务状态必须按任务保留期来执行，是强制要求。保留期内没有任何轮询请求，任务就会超时，即使任务已处理成功也一样（您的点数照样会被消耗）。

   警告： 若去查询已超时任务的状态，会收到 InvalidTaskId 错误。因此，执行 AI 任务之后，必须在保留期内持续轮询，直到状态变为 success 或 error。

5. 任务成功后取回结果
   引擎成功处理您的输入文件、生成出图后，任务状态会变为 'success'。您会得到处理后图片的 URL 以及一个 dst_id，可直接串联下一个 AI 任务，不必把结果图重新上传。 只有这种情况才会消耗点数。若引擎处理失败，任务状态会变为 'error'，不消耗点数。
   扣除点数时，系统优先扣除临近到期的点数；到期日相同时，优先扣除最早取得的点数。

• 实际案例：

输入与输出

• 脸部特征：

• 脸部比例：

• 拍摄建议：

警告： 脸部宽度需大于图片宽度的 60%。

文件规格与错误码

• 支持的格式与尺寸

• 错误码

• 运行环境与依赖

JS Camera Kit

点数消耗

• 面部属性与比例分析