一.证件照环境检测.docxVIP

一．证件照环境检测 基本信息： 请求类型:?HTTP/HTTPS 接口地址:?/api/env_pic 请求方式:?POST 数据类型:?JSON 响应类型:?JSON 接口状态:?启用 接口描述： 证件照环境检测，此接口多用于调用制作照片的接口之前，用于预检测 调用此接口不会增加已调用次数 官网上对应的app_key应用类型必须为证件照环境检测 请求参数： 本接口环境检测采用设定阈值的方式，通过参数传过来的阈值，与算法检测出来的各项对应值比较，得到通过与否的结果（共7个检测项）。设定的阈值越大检测越不严格，越容易通过；阈值越小检测越严格，越不容易通过。 比如facepose检测项用户传过来阈值为20，检测结果为30，则该检测项不通过，如果想要放宽facepose此检测项的要求，可以调整阈值，将上传的阈值改为40，则此检测项即为通过（用户看不到算法检测出来的各项对应值）。 用户可以根据自己需求不断调整传送的阈值，建议阈值依次顺序为40,40,35,20，50,50,60 参数名称 是否必须 类型 描述 file true string 图片的base64数据 app_key true string 已申请的app_key facepose true string/ number 人脸是正对镜头(姿态) 阈值 eyegaze true string/ number 视线是否正常 阈值 eyeskew true string/ number 眼睛是否歪斜(双眼连线不水平) 阈值 shoulderskew true string/ number 肩膀是否水平正对镜头 阈值 darkillum true string/ number 照片光照是否昏暗 阈值 unbalanceillum true string/ number 人脸是否为阴阳脸 阈值 bfsimilarity true string/ number 衣服和背景颜色是否相似 阈值 响应数据： 参数名称 数据类型 示例值 描述 code number 200 状态码 msg number SUCCESS 接口调用信息 total_result number 1 检测结果汇总，各检测项中有一项未通过则为0，全部通过则为1 result object 各个参数的检查结果：1代表通过，0代表未通过 facepose number 1 人脸是正对镜头(姿态) eyegaze number 1 视线是否正常 eyeskew number 1 眼睛是否歪斜(双眼连线不水平) shoulderskew number 1 肩膀是否水平正对镜头 darkillum number 1 照片光照是否昏暗 unbalanceillum number 1 人脸是否为阴阳脸 bfsimilarity number 1 衣服和背景颜色是否相似 例子： Python 请求演示： import requestsimport urllibimport jsonurl = /api/env_picwith open(test.jpg, rb) as f: pic = f.read()headers = {Content-Type: application/json}data = { app_key: 改为已申请的对应类型的app_key, file: base64.b64encode(pic).decode(), facepose: 40, # 下列项可以改为需要的阈值 eyegaze: 40, eyeskew: 35, shoulderskew: 20, darkillum: 50, unbalanceillum: 50, bfsimilarity: 60,}data_json = json.dumps(data)response = requests.post( url=url, headers=headers, data=data_json)print(response.text) 返回数据： { code: 200, msg: SUCCESS, result: { bfsimilarity: 1, darkillum: 1, eyegaze: 1, eyeskew: 1, facepose: 1, shoulderskew: 1, unbalanceillum: 1 }, total_result: 1 } 状态码： 状态码 描述 解决方案 200 请求成功 40