利物乙人脸餐盘机的人脸检测接口API

成都捷德旗下"利物乙"人脸餐盘机人脸识别接口分为V2和V3两个版本，本文档为V3版本接口的说明文档，请确认您在后台获得的是V3版本接口权限，再阅读本文档。

辨别接口版本的方法是：在云后台进入【应用列表】，点击【应用名称】，在【API列表】中可以看到【请求地址】，若请求地址中带有【v3】标识，则您具有的是v3权限，可以阅读本文档；若请求地址中带有【v2】标识，则您具有的是v2权限，应该去阅读V2文档。 如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

• 在云控制台内提交工单，咨询问题类型请选择人工服务；
• 如有需要讨论的疑问，欢迎进入技术群与其他我们一同交流。

能力介绍

接口能力

• 人脸检测：检测图片中的人脸并标记出位置信息;
• 人脸关键点：展示人脸的核心关键点信息，及150个关键点信息。
• 人脸属性值：展示人脸属性信息，如年龄、性别等。
• 人脸质量信息：返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。

  请求参数

  参数	必选	类型	说明
  image	是	string	图片信息(总数据大小应小于10M)，图片上传方式根据image_type来判断
  image_type	是	string	图片类型  BASE64:图片的base64值，base64编码后的图片数据，编码后的图片大小不超过2M；  URL:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)；  FACE_TOKEN: 人脸图片的唯一标识，调用人脸检测接口时，会为每个人脸图片赋予一个唯一的FACE_TOKEN，同一张图片多次检测得到的FACE_TOKEN是同一个。
  face_field	否	string	包括age,beauty,expression,face_shape,gender,glasses,landmark,landmark150, quality,eye_status,emotion,face_type,mask,spoofing信息  逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度
  max_face_num	否	uint32	最多处理人脸的数目，默认值为1，根据人脸检测排序类型检测图片中排序第一的人脸（默认为人脸面积最大的人脸），最大值120
  face_type	否	string	人脸的类型  LIVE表示生活照：通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等  IDCARD表示身份证芯片照：二代身份证内置芯片中的人像照片  WATERMARK表示带水印证件照：一般为带水印的小图，如公安网小图  CERT表示证件照片：如拍摄的身份证、工卡、护照、学生证等证件图片  默认LIVE
  liveness_control	否	string	活体控制 检测结果中不符合要求的人脸会被过滤 NONE: 不进行控制  LOW:较低的活体要求(高通过率 低攻击拒绝率)  NORMAL: 一般的活体要求(平衡的攻击拒绝率, 通过率)  HIGH: 较高的活体要求(高攻击拒绝率 低通过率)  默认NONE
  face_sort_type	否	int	人脸检测排序类型 0:代表检测出的人脸按照人脸面积从大到小排列 1:代表检测出的人脸按照距离图片中心从近到远排列 默认为0

  说明：face_field参数，默认只返回人脸框、概率和旋转角度，age等更多属性，请在此参数中添加。