人脸检测 接口描述 用于检测输入图像中的人脸,输出人脸数量、人脸位置坐标、人脸98个关键点信息、人脸角度信息、人脸质量信息等。 请求方法 POST 接口要求 图片大小限制:图片单张大小小于7MB; 图片格式限制:图片格式支持jpg/jpeg/png/bmp格式。 URI /v1/aiop/api/2f6hqix09mv4/face/PERSON/person/detectFaceFromBase64 请求参数 1.请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ContentType 是 String json格式 application/json appkey 是 String 平台应用appkey 562b89493b1a4XXXXXXXXX ctyuneoprequestid 是 String 用户请求 id,由用户构造,用户可以通过 uuid 等方法自行生成唯一字符串,用于日志请求追踪。 详见文档:Python3调用示例 33dfa732b27b464fb15a21ed6845afd5 eopdate 是 String 请求时间,由用户构造,形如 yyyymmddTHHMMSSZ。 详见文档:Python3调用示例 20211221T163014Z host 是 String 终端节点域名,固定字段 aiglobal.ctapi.ctyun.cn version 是 String 固定值,v3 EopAuthorization 是 String 由天翼云官网 accessKey 和 securityKey 经签名后生成,参与签名生成的字段包括天翼云官网 accessKey 、securityKey、平台应用的appkey(非必须),用户请求id(非必须),请求时间,终端节点域名(非必须)以及请求体内容。 签名逻辑详见文档:认证鉴权和Python3调用示例 2.请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 Action 是 String 服务名称,固定值DetectFace DetectFace ImageData 是 String 图⽚的 base64 编码 FaceThresh 否 Float ⼈脸分数阈值。 取值范围 [0,1],默认值为 0.5。 检测分数低于该阈值的⼈脸会被过滤 (不返回结果),建议使⽤默认值。 0.5 NeedFaceAngle 否 Bool 是否返回⼈脸⻆度信息。 默认为 False,不返回⼈脸⻆度。 若该值设为 True,则返回⼈脸⻆度。 NeedFaceQuality 否 Bool 是否返回人脸质量信息。默认为 False,不返回⼈脸质量信息。 若该值设为 True,则返回⼈脸质量信息。 NeedMoreLandmark 否 Bool 是否返回98个关键点信息。默认为 False,不返回98个关键点信息。 若该值设为 True,则返回98个关键点信息。