大数据和人工智能34人脸识别50min

人脸识别产品概述产品功能人脸检测人脸查找人脸对比开通服务流程解决方案与客户案例产品概述百度一下基于百度业界领先的智能人脸分析算法，提供人脸检测、人脸识别、关键点定位、属性识别和活体检测等一整套技术方案。人脸识别技术简介人脸识别根据人脸的表现特征自动识别人的身份、属性等。相似人脸检测给定一张照片，和数据库中N个人脸进行对比，找出最相似的一张脸或多张人脸。检测图中的人脸，并为人脸标记出边框。人脸检测FDDB第一人脸检测通过提取人脸的特征，计算两张人脸的相似度，从而判断是否同一个人。人脸识别LFW全球第一人脸验证核心技术提供企业级的人工智能服务，助力人工智能工业化，支持毫秒级的识别响应能力、弹性灵活的高并发承载及99.99%的可靠性保证。基于百度业界领先的深度学习和海量数据训练，人脸检测和人脸识别在最权威的公开测评比赛中排名世界领先。BFR产品优势各类型人脸API覆盖全面，可根据业务需求灵活搭配，提供稳定易用的客户端SDK，适配各类终端接入需求。灵活易用稳定高效算法领先产品优势产品功能百度一下人脸检测检测图中的人脸，并为人脸标记出边框。检测出人脸后，可对人脸进行分析，获得眼、口、鼻轮廓等72个关键点定位准确识别多种人脸属性，如性别，年龄，表情等信息。该技术可适应大角度侧脸，遮挡，模糊，表情变化等各种实际环境功能介绍

功能简介：检测图中的人脸，并为人脸标记出边框。检测出人脸后，可对人脸进行分析，获得眼、口、鼻轮廓等72个关键点定位准确识别多种人脸属性，如性别，年龄，表情等信息。该技术可适应大角度侧脸，遮挡，模糊，表情变化等各种实际环境。技术特色#-*-coding:utf-8-*-#引入人脸识别SDKfromaipimportAipFace#定义常量APP_ID='9880439'API_KEY='xOGGZQLhBRzcpq3gkfXZj0kq'SECRET_KEY='*******************'#初始化AipFace对象aipFace=AipFace(APP_ID,API_KEY,SECRET_KEY)#读取图片defget_file_content(filePath): #以二进制格式打开

withopen(filePath,'rb')asfp: returnfp.read()#调用人脸属性检测接口result=aipFace.detect(get_file_content('face2.jpg'))printresult示例代码：功能演示{'log_id':1297715796,'result_num':1,'result':[

{

'rotation_angle':-3,'yaw':11.102760314941,'location':

{

'width':128,

'top':120,

'height':115,

'left':180

},

'pitch':6.5703091621399,

'roll':-2.726313829422,

'face_probability':0.95331317186356

}]}返回样例：以识别达·芬奇画作《蒙娜丽莎》中人脸为例应用场景功能介绍

功能简介：给定一张照片，与指定人脸库中的N个人脸进行比对，找出最相似的一张脸或多张人脸。根据待识别人脸与现有人脸库中的人脸匹配程度，返回用户信息和匹配度，即1：N人脸检索。可用于用户身份识别、身份验证相关场景。技术特色

功能演示应用场景人脸对比检测图中的人脸，并为人脸标记出边框。检测出人脸后，可对人脸进行分析，获得眼、口、鼻轮廓等72个关键点定位准确识别多种人脸属性，如性别，年龄，表情等信息。该技术可适应大角度侧脸，遮挡，模糊，表情变化等各种实际环境人脸对比功能简介

功能简介：能够快速准确识别各种网络图片中的文字，在复杂字体和复杂背景的情况下仍能保持非常高的识别准确率。技术特色

{'log_id':

3134331810072516L,

'result_num':

6,'result':[{'score':

76.785530090332,'index_j':'1','index_i':'0‘},{'score':

91.547348022461,

'index_j':'2',

'index_i':'0‘},{'score':

88.126502990723,'index_j':'3',

'index_i':'0‘},{'score':81.103775024414,

'index_j':'2','index_i':'1‘},{'score':

66.167007446289,

'index_j':'3',

'index_i':'1‘},{'score':

82.82315826416,'index_j':'3',

'index_i':'2‘}]}功能演示返回样例：#-*-coding:utf-8-*-#人脸对比fromaipimportAipFace#定义常量APP_ID='9880439'API_KEY='xOGGZQLhBRzcpq3gkfXZj0kq'SECRET_KEY=‘kpZAfIjOkCzV****************'#读取图片def

get_file_content(filePath):

withopen(filePath,'rb')asfp:

returnfp.read()#初始化AipFace对象aipFace=AipFace(APP_ID,API_KEY,SECRET_KEY)#调用人脸两两比对接口result=aipFace.match([get_file_content('ZZY1.jpg'),get_file_content('ZZY2.jpg'),get_file_content('ZZY3.jpg'),get_file_content('ZZY4.jpg'), ])printresult示例代码：以两两对比人脸库中4张图片为例：应用场景

开通服务流程百度一下开通服务流程

0504030200生成签名获取秘钥新建应用注册账号登陆启动开发01成为开发者平台地址：开通服务流程

01使用百度账号完成登录，如您还未持有百度账户，先注册百度账户。点击百度AI开放平台导航右侧的控制台，进入百度云控制台页面并登录；进入到百度云后台。您也可以在官网直接点击免费试用，登录完毕后将自动进入到百度云控制台。

STEP4进入百度云控制台，找到人工智能相关服务面板。STEP1进入百度云欢迎页面，填写企业/个人基本信息，注册完毕，至此成为开发者。注：如之前已经是百度云用户或百度开发者中心用户，此步忽略。

STEP2STEP3成为开发者01开通服务流程

获取AK&SK您可以选择您需要的服务，进入对应服务的控制台中。创建新的应用新建应用02应用类型：必填项，根据您的应用的适用领域，在下拉列表中选取一个类型；应用名称：必填项，用于标识您所创建的应用的名称，支持中英文、数字、下划线及中横线，此名称一经创建完毕，不可修改；应用描述：必填项，对此应用的业务场景进行描述。包名绑定：选填项，如果您需要使用OCR及语音客户端SDK服务（iOS/Android），需要绑定包名信息，以便生成授权License，上图中勾选了「通用文字识别」权限后，即展现此项。

注：人脸识别客户端SDK需要单独申请使用，无需在此配置；应用平台：选填项，选择此应用适用的平台，可多选；接口选择：必填项，每个应用可以勾选业务所需的所有AI服务的接口权限（仅可勾选具备免费试用权限的接口能力），应用权限可跨服务勾选，创建应用完毕，此应用即具备了所勾选服务的调用权限；开通服务流程

01获取AK&SK获取秘钥03在您创建完毕应用后，平台将会分配给您此应用的相关凭证，主要为AppID、APIKey、SecretKey。以上三个信息是您应用实际开发的主要凭证，每个应用之间各不相同，请您妥善保管。下图为示例内容：很棒，你现在已经有一个应用了！开通服务流程

01获取AK&SK生成签名04刚才所创建的应用在调用开放平台API之前，首先需要获取AccessToken（用户身份验证和授权的凭证）。您需要使用创建应用所分配到的AppID、APIKey及SecretKey,温馨提示：AccessToken的有效期为30天（以秒为单位），请您集成时注意在程序中定期请求新的token。加油！密钥已经拿到了，那么如何调用呢？进行AccessToken的生成，方法详见

AccessToken获取，我们为您准备了几种常见语言的请求示例代码。AccessToken生成目前各项服务我们都会开放API、SDK形式的服务在控制台点击「技术文档」中各服务的文档——「人脸识别API」，查看具体调用方法及参数。开通服务流程

启动开发05做的不错，让我们开始使用各项服务吧！百度云同样也提供客户端或服务端SDK，帮忙您快速接入服务。后续也会不断补充拓展，敬请持续关注。请求图片需经过base64编码：图片的base64编码指将一副图片数据编码成一串字符串，使用该字符串代替图像地址。您可以首先得到图片的二进制，然后用Base64格式编码即可。注意：图片的base64编码是不包含图片头的，如（data:image/jpg;base64,）请求格式支持：PNG、JPG、JPEG、BMP、GIF**POST方式调用注意：Content-Type为application/x-www-form-urlencoded，然后通过urlencode格式化请求体。JSON格式接口名称接口能力简要描述人脸检测检测人脸并定位，返回五官关键点，及人脸各属性值人脸比对返回两两比对的人脸相似值人脸识别在人脸库中查找相似的人脸人脸认证识别上传的图片是否为指定用户人脸库设置对人脸库的相关操作，如注册、删除、更新、查找用户信息等人脸识别API 010204请求格式请求限制返回格式接口能力03简介接口名称图片编码后大小限额人脸检测小于2M人脸比对单次传入的两张图片，小于20M人脸识别小于10M人脸认证小于10M人脸库设置小于10M调用方式一请求URL数据格式向API服务地址使用POST发送请求，必须在URL中带上参数：access_token:必须参数，参考“AccessToken获取”。POST中参数按照API接口说明调用即可。获取access_token示例代码说明：方式一鉴权使用的Access_token必须通过APIKey和SecretKey获取。importurllib,urllib2,sysimportssl#client_id为官网获取的AK，client_secret为官网获取的SKhost=‘【官网获取的AK】&client_secret=【官网获取的SK】’request=urllib2.Request(host)request.add_header(‘Content-Type’,‘application/json;charset=UTF-8’)response=urllib2.urlopen(request)content=response.read()if(content):print(content)人脸识别API 调用方式1注意：access_token的有效期为30天，需要每30天进行定期更换；

例如文字识别API，使用HTTPSPOST发送：调用AI服务相关的API接口有两种调用方式，两种不同的调用方式采用相同的接口URL。区别在于请求方式和鉴权方法不一样，请求参数和返回结果一致。请求头域内容在请求的HTTP头域中包含以下信息：人脸识别API 调用方式2host（必填）x-bce-date

（必填）authorization（必填）content-type（必填）content-length（选填）x-bce-request-id（必填）调用方式二作为示例，以下是一个标准的人脸识别的请求头域内容:人脸识别API 调用方式2POST/rest/2.0/face/v1/detectHTTP/1.1accept-encoding:gzip,deflatex-bce-date:2015-03-24T13:02:00Zconnection:keep-aliveaccept:*/*host:x-bce-request-id:73c4e74c-3101-4a00-bf44-fe246959c05econtent-type:application/x-www-form-urlencodedauthorization:bce-auth-v1/46bd9968a6194b4bbdf0341f2286ccce/2015-03-24T13:02:00Z/1800/host;x-bce-date/994014d96b0eb26578e039fa053a4f9003425da4bfedf33f4790882fb4c54903说明：方式二鉴权使用的API认证机制authorization必须通过百度云的AK/SK生成。调用方式二人脸检测接口描述请求说明返回说明检测请求图片中的人脸，返回人脸位置、72个关键点坐标、及人脸相关属性信息。检测响应速度，与图片中人脸数量相关，人脸数量较多时响应时间会有些许延长。五官位置会标记具体坐标；72个关键点坐标也包含具体坐标，但不包含对应位置的详细位置描述。人脸检测接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸检测接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明image是stringbase64编码后的图片数据，图片大小不超过2M。max_face_num否uint32最多处理人脸数目，默认值1face_fields否string包括age,beauty,expression,faceshape,gender,glasses,landmark,race,qualities信息，逗号分隔，默认只返回人脸框、概率和旋转角度。Body中放置请求参数，参数详情如下：说明：face_fields参数，默认只返回人脸框、概率和旋转角度，age等更多属性，请在此参数中添加。人脸检测接口描述请求说明返回说明请求示例请求参数请求代码示例#encoding:utf-8importbase64importurllibimporturllib2fromtokenimportaccess_token'''人脸检测接口''‘

detectUrl=""#参数image：图像base64编码，max_face_num：最多处理人脸数目，默认值1，face_fields：包括age,beauty,expression,faceshape,gender,glasses,landmark,race,qualities信息，逗号分隔，默认只返回人脸框、概率和旋转角度\f=open(r'########本地文件#######','rb')#二进制方式打开图文件img=base64.b64encode(f.read())params={"max_face_num":1,"face_fields":"age,beauty,expression,faceshape,gender,glasses,landmark,race,qualities","image":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'detectUrl=detectUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=detectUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent人脸检测接口描述请求说明返回说明返回参数返回示例参数类型是否必须说明log_iduint64是日志idresult_numuint32是人脸数目resultobject[]是人脸属性对象的集合+agedouble否年龄。face_fields包含age时返回+beautydouble否美丑打分，范围0-100，越大表示越美。face_fields包含beauty时返回+cationbject是人脸在图片中的位置++leftuint32是人脸区域离左边界的距离++topuint32是人脸区域离上边界的距离++widthuint32是人脸区域的宽度++heightuint32是人脸区域的高度+face_probabilitydouble是人脸置信度，范围0-1+rotation_angleint32是人脸框相对于竖直方向的顺时针旋转角，[-180,180]+yawdouble是三维旋转之左右旋转角[-90(左),90(右)]+pitchdouble是三维旋转之俯仰角度[-90(上),90(下)]+rolldouble是平面内旋转角[-180(逆时针),180(顺时针)]人脸检测接口描述请求说明返回说明返回参数返回示例参数类型是否必须说明+expressionuint32否表情，0，不笑；1，微笑；2，大笑。face_fields包含expression时返回+expression_probabilitydouble否表情置信度，范围0~1。face_fields包含expression时返回+faceshapeobject[]否脸型置信度。face_fields包含faceshape时返回++typestring是脸型：square/triangle/oval/heart/round+probabilitydouble是置信度：0~1+genderstring否male、female。face_fields包含gender时返回+gender_probabilitydouble否性别置信度，范围0~1。face_fields包含gender时返回+glassesuint32否是否带眼镜，0-无眼镜，1-普通眼镜，2-墨镜。face_fields包含glasses时返回+glasses_probabilitydouble否眼镜置信度，范围0~1。face_fields包含glasses时返回+landmarkobject[]否4个关键点位置，左眼中心、右眼中心、鼻尖、嘴中心。face_fields包含landmark时返回++xuint32否x坐标++yuint32否y坐标+landmark72object[]否72个特征点位置，示例图。face_fields包含landmark时返回人脸检测接口描述请求说明返回说明返回参数返回示例参数类型是否必须说明++xuint32否x坐标++yuint32否y坐标+racestring否yellow、white、black、arabs。face_fields包含race时返回+race_Probabilitydouble否人种置信度，范围0~1。face_fields包含race时返回+qualitiesobject否人脸质量信息。face_fields包含qualities时返回++occlusionobject是人脸各部分遮挡的概率，[0,1]（待上线）+++left_eyedouble是左眼+++right_eyedouble是右眼+++nosedouble是鼻子+++mouthdouble是嘴+++left_Cheekdouble是左脸颊+++right_cheekdouble是右脸颊+++chindouble是下巴人脸检测接口描述请求说明返回说明返回参数返回示例参数类型是否必须说明++xuint32否x坐标++yuint32否y坐标+racestring否yellow、white、black、arabs。face_fields包含race时返回+race_probabilitydouble否人种置信度，范围0~1。face_fields包含race时返回+qualitiesobject否人脸质量信息。face_fields包含qualities时返回++occlusionobject是人脸各部分遮挡的概率，[0,1]（待上线）+++left_eyedouble是左眼{"result_num":1,"result":[{"location":{ "left":90,"top":92,"width":111,"height":99

},"face_probability":1,"rotation_angle":6,"yaw":11.61234664917,"pitch":-0.30852827429771,"roll":8.8044967651367,"landmark":[ { "x":105,"y":110

}, ...],"landmark72":[ { "x":88,"y":109

}, ...],"gender":"male","gender_probability":0.99358034133911,"glasses":0,"glasses_probability":0.99991309642792,"race":"yellow","race_probability":0.99960690736771,"qualities":{ "occlusion":{ "left_eye":0.000085282314103097, "right_eye":0.00001094374601962, "nose":3.2677664307812e-7, "mouth":2.6582130940866e-10, "left_cheek":8.752236624332e-8, "right_cheek":1.0212766454742e-7, "chin":4.2632994357028e-10

},"blur":4.5613666312237e-41,"illumination":0,"completeness":0,"type":{"human":0.98398965597153,"cartoon":0.016010366380215

}}}],"log_id":2418894422

}人脸检测接口描述请求说明返回说明返回参数返回示例人脸对比接口描述请求说明返回说明该请求用于比对多张图片中的人脸相似度并返回两两比对的得分，可用于判断两张脸是否是同一人的可能性大小。支持对比对的两张图片做在线活体检测人脸对比接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸对比接口描述请求说明返回说明请求示例请求参数请求代码示例参数是否必选类型说明images是stringbase64编码后的2张图片数据，半角逗号分隔，单次请求总共最大20Mext_fields否string返回质量信息，取值固定:

目前支持qualities(质量检测)。(对所有图片都会做改处理)image_liveness否string返回的活体信息，“faceliveness,faceliveness”表示对比对的两张图片都做活体检测；“,faceliveness”表示对第一张图片不做活体检测、第二张图做活体检测；“faceliveness,”表示对第一张图片做活体检测、第二张图不做活体检测Body中放置请求参数，参数详情如下：人脸对比接口描述请求说明返回说明请求示例请求参数请求代码示例#encoding:utf-8importbase64importurllibimporturllib2'''人脸比对接口'''matchUrl=""#二进制方式打开图文件f=open('########本地文件1#######','rb')#参数images：图像base64编码img1=base64.b64encode(f.read())#二进制方式打开图文件f=open('########本地文件2#######','rb')#参数images：图像base64编码img2=base64.b64encode(f.read())#参数images：图像base64编码,多张图片半角逗号分隔params={"images":img1+','+img2}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'matchUrl=matchUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=matchUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent人脸对比接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求唯一标识码，随机数result_num是uint32返回结果数目，即：result数组中元素个数result是array(object)结果数据，index和请求图片index对应。数组元素为每张图片的匹配得分数组，topn。得分[0,100.0]+index_i是uint32比对图片1的index+index_j是uint32比对图片2的index+score是double比对得分ext_info否array（dict）对应参数中的ext_fields+qualities否string质量相关的信息，无特殊需求可以不使用+faceliveness否string活体分数“0,0.9999”（表示第一个图不做活体检测、第二个图片活体分数为0.9999）。活体检测参考分数0.4494，以上则可认为是活体（测试期间）人脸对比接口描述请求说明返回说明返回参数返回示例//请求两张图片{"log_id":73473737,"result_num":1,"result":[{

"index_i":0,"index_j":1,"score":44.3

}]}人脸识别接口描述请求说明返回说明用于计算指定组内用户，与上传图像中人脸的相似度。识别前提为您已经创建了一个人脸库。人脸识别返回值不直接判断是否是同一人，只返回用户信息及相似度分值。推荐可判断为同一人的相似度分值为80，您也可以根据业务需求选择更合适的阈值。人脸识别接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸识别接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明group_id是string用户组id（由数字、字母、下划线组成），长度限制128B，如果需要查询多个用户组id，用逗号分隔image是string图像base64编码，每次仅支持单张图片，图片编码后大小不超过10Mext_fields否string特殊返回信息，多个用逗号分隔，取值固定:目前支持faceliveness(活体检测)，活体检测参考分数0.4494，以上则可认为是活体（测试期间）user_top_num否uint32返回用户top数，默认为1，最多返回5个Body中放置请求参数，参数详情如下：人脸识别接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之识别接口'''identifyUrl=""#二进制方式打开图文件f=open('########本地文件#######','rb')#参数image：图像base64编码img=base64.b64encode(f.read())#参数group_id：用户组id（由数字、字母、下划线组成）images：图像base64编码,多张图片半##角逗号分隔\params={"group_id":"gid", "images":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'identifyUrl=identifyUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=identifyUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸识别接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求唯一标识码，随机数result_num是uint32返回结果数目，即：result数组中元素个数ext_info否array对应参数中的ext_fields+faceliveness否string活体分数，如0.49999。活体检测参考分数0.4494，以上则可认为是活体（测试期间）result是array(object)结果数组+group_id是string对应的这个用户的group_id+uid是string匹配到的用户id+user_info是string注册时的用户信息+scores是array(double)结果数组，数组元素为匹配得分，topn。得分[0,100.0]人脸识别接口描述请求说明返回说明返回参数返回示例{"log_id":73473737,"result_num":1,"result":[ { "group_id":"test1", "uid":"u333333", "user_info":"TestUser", "scores":[

99.3,

83.4

] } ]}人脸认证接口描述请求说明返回说明用于识别上传的图片是否为指定用户，即查找前需要先确定要查找的用户在人脸库中的id。说明：人脸认证与人脸识别的差别在于：人脸识别需要指定一个待查找的人脸库中的组；

而人脸认证需要指定具体的用户id即可，不需要指定具体的人脸库中的组；实际

应用中，人脸认证需要用户或系统先输入id，这增加了验证安全度，但也增加了

复杂度，具体使用哪个接口需要视您的业务场景判断。说明：请求参数中，新增在线活体检测人脸认证接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸认证接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bimage是string图像base64编码，每次仅支持单张图片，图片编码后大小不超过10Mgroup_id是string用逗号分隔，表示从指定的group中查找top_num否uint32返回匹配得分top数，默认为1ext_fields否string特殊返回信息，多个用逗号分隔，取值固定:目前支持faceliveness(活体检测)，活体检测参考分数0.4494，以上则可认为是活体（测试期间）Body中放置请求参数，参数详情如下：人脸认证接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之认证接口'''identifyUrl=""#二进制方式打开图文件f=open('########本地文件#######','rb')#参数image：图像base64编码img=base64.b64encode(f.read())#参数uid：用户id（由数字、字母、下划线组成）images：图像base64编码,多张图片半角逗号#分隔params={“uid":“testuid", "images":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'verifyUrl=verifyUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=verifyUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸认证接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求唯一标识码，随机数result_num是uint32返回结果数目，即：result数组中元素个数ext_info否array对应参数中的ext_fields+faceliveness否string活体分数，如0.49999。活体检测参考分数0.4494，以上则可认为是活体（测试期间）result是array(object)结果数组，数组元素为匹配得分，topn。得分范围[0,100.0]。推荐得分超过80可认为认证成功人脸认证接口描述请求说明返回说明返回参数返回示例{"log_id":73473737,"result_num":2,"result":[

99.3,

83.6

]}人脸注册接口描述请求说明返回说明用于识别上传的图片是否为指定用户，即查找前需要先确定要查找的用户在人脸库中的id。说明：人脸认证与人脸识别的差别在于：人脸识别需要指定一个待查找的人脸库中的组；

而人脸认证需要指定具体的用户id即可，不需要指定具体的人脸库中的组；实际应用中，

人脸认证需要用户或系统先输入id，这增加了验证安全度，但也增加了复杂度，具体使

用哪个接口需要视您的业务场景判断。说明：请求参数中，新增在线活体检测人脸注册接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸注册接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bimage是string图像base64编码，每次仅支持单张图片，图片编码后大小不超过10Mgroup_id是string用逗号分隔，表示从指定的group中查找top_num否uint32返回匹配得分top数，默认为1ext_fields否string特殊返回信息，多个用逗号分隔，取值固定:目前支持faceliveness(活体检测)，活体检测参考分数0.4494，以上则可认为是活体（测试期间）Body中放置请求参数，参数详情如下：人脸注册接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之认证接口'''identifyUrl=""#二进制方式打开图文件f=open('########本地文件#######','rb')#参数image：图像base64编码img=base64.b64encode(f.read())#参数uid：用户id（由数字、字母、下划线组成）images：图像base64编码,多张图片半角逗号#分隔params={“uid":“testuid", "images":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'addUrl=addUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=addUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸注册接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求唯一标识码，随机数result_num是uint32返回结果数目，即：result数组中元素个数ext_info否array对应参数中的ext_fields+faceliveness否string活体分数，如0.49999。活体检测参考分数0.4494，以上则可认为是活体（测试期间）result是array(object)结果数组，数组元素为匹配得分，topn。得分范围[0,100.0]。推荐得分超过80可认为认证成功人脸注册接口描述请求说明返回说明返回参数返回示例{"log_id":73473737,"result_num":2,"result":[

99.3,

83.6

]}人脸注册接口描述请求说明返回说明用于从人脸库中新增用户，可以设定多个用户所在组，及组内用户的人脸图片，典型应用场景：构建您的人脸库，如会员人脸注册，已有用户补全人脸信息等。人脸认证与人脸识别的差别在于：人脸识别需要指定一个待查找的人脸库中的组；而人脸认证需要指定具体的用户id即可，不需要指定具体的人脸库中的组；实际应用中，人脸认证需要用户或系统先输入id，这增加了验证安全度，但也增加了复杂度，具体使用哪个接口需要视您的业务场景判断。说明：请求参数中，新增在线活体检测|-人脸库

|-用户组一

|-用户01

|-人脸

|-用户02

|-人脸

|-人脸

.... .... |-用户组二

|-用户组三

|-用户组四

....人脸库、用户组、用户、用户下的人脸层级关系如下所示：人脸注册接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸注册接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bimage是string图像base64编码，每次仅支持单张图片，图片编码后大小不超过10Mgroup_id是string用逗号分隔，表示从指定的group中查找action_type否string参数包含append、replace。如果为“replace”，则每次注册时进行替换replace（新增或更新）操作，默认为append操作user_info是string用户资料，长度限制256BBody中放置请求参数，参数详情如下：人脸注册接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之注册接口'''addUrl=""#二进制方式打开图文件f=open('########本地文件#######','rb')#参数image：图像base64编码img=base64.b64encode(f.read())#参数uid:用户id（由数字、字母、下划线组成），user_info:用户资料,group_id:用户组#id,images:图像base64编码,多张图片半角逗号分隔params={"uid":"testuid", "user_info":"test_userinfo","group_id":"test_groupid", "images":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'addUrl=addUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=addUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸注册接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求唯一标识码，随机数人脸注册接口描述请求说明返回说明返回参数返回示例//注册成功

{ "log_id":73473737,}//注册发生错误

{ "error_code":216616, "log_id":674786177, "error_msg":"imageexist"

}人脸更新接口描述请求说明返回说明用于对人脸库中指定用户，更新其下的人脸图像。针对一个uid执行更新操作，新上传的人脸图像将覆盖此uid原有所有图像。执行更新操作，如果该uid不存在时，会返回错误。如果添加了action_type: replace,则不会报错，并自动注册该uid，操作结果等同注册新用户。人脸更新接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸更新接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bimage是string图像base64编码，每次仅支持单张图片，图片编码后大小不超过10Mgroup_id是string用逗号分隔，表示从指定的group中查找action_type否string目前仅支持replace，uid不存在时，不报错，会自动变为注册操作；未选择该参数时，如果uid不存在会提示错误user_info是string用户资料，长度限制256BBody中放置请求参数，参数详情如下：人脸更新接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之窗口更新'''addUrl=""#二进制方式打开图文件f=open('########本地文件#######','rb')#参数image：图像base64编码img=base64.b64encode(f.read())#参数uid:用户id（由数字、字母、下划线组成）,images:图像base64编码,多张图片半角逗号#分隔params={"uid":"testuid", "images":img}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'updateUrl=updateUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=updateUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸更新接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求标识码，随机数，唯一人脸更新接口描述请求说明返回说明返回参数返回示例//更新成功

{"log_id":73473737,}//更新发生错误

{"error_code":216612,"log_id":1137508902,"error_msg":"usernotexist"

}人脸删除接口描述请求说明返回说明用于从人脸库中删除一个用户。删除的内容，包括用户所有图像和身份信息；如果一个uid存在于多个用户组内，将会同时将从各个组中把用户删除如果指定了group_id，则只删除此group下的uid相关信息人脸删除接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded人脸删除接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bgroup_id是string删除指定group_id中的uid信息Body中放置请求参数，参数详情如下：人脸删除接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之删除接口'''deleteUrl=""#参数uid：用户id（由数字、字母、下划线组成），长度限制128Bparams={"uid":"testuid"}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'deleteUrl=deleteUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=deleteUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例人脸删除接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求标识码，随机数，唯一人脸删除接口描述请求说明返回说明返回参数返回示例//删除成功

{ "log_id":73473737,}//删除发生错误

{ "error_code":216612, "log_id":1382953199, "error_msg":"usernotexist"

}用户信息查询接口描述请求说明返回说明用于查询人脸库中某用户的详细信息。用户信息查询接口描述请求说明返回说明请求示例请求参数请求代码示例HTTP方法：POST请求URL：

URL参数：参数值access_token通过APIKey和SecretKey获取的access_token,参考“AccessToken获取”Header：参数值Content-Typeapplication/x-www-form-urlencoded用户信息查询接口描述请求说明返回说明请求示例请求参数请求代码示例URL参数：参数是否必选类型说明uid是string用户id（由数字、字母、下划线组成），长度限制128Bgroup_id是string选择指定group_id则只查找group列表下的uid内容，如果不指定则查找所有group下对应uid的信息Body中放置请求参数，参数详情如下：用户信息查询接口描述请求说明返回说明#encoding:utf-8importbase64importurllibimporturllib2'''人脸查找之用户信息查询接口'''userInfoUrl=""params={"uid":"testuid"}params=urllib.urlencode(params)access_token='#####调用鉴权接口获取的token#####'userInfoUrl=userInfoUrl+"?access_token="+access_tokenrequest=urllib2.Request(url=userInfoUrl,data=params)request.add_header('Content-Type','application/x-www-form-urlencoded')response=urllib2.urlopen(request)content=response.read()ifcontent:printcontent请求示例请求参数请求代码示例用户信息查询接口描述请求说明返回说明返回参数返回示例字段是否必选类型说明log_id是uint64请求标识码，随机数，唯一result是array(double)结果数组+uid是string匹配到的用户id+user_info是string注册时的用户信息+groups是array(str