Eyekey人脸识别Api文档.pdfVIP

目 录 更新日志 EyeKey简介 人脸识别API导读 本文档使用 看云 构建 - 2 - 更新日志 更新日志 版本号 备注 参与人 2014-11-07 增加facegather接口,统一整理错误编码,删除session相关内容 蒲剑锋 2014-11-12 删除种族,微笑等检测内容 蒲剑锋、江武明 2014-12-02 修改接口命名 蒲剑锋、王志博 2014-12-04 修改接口check_mark检测点描述,增加5点检测 蒲剑锋、江武明 2014-12-21 修改checking接口返回参数 蒲剑锋、王志博、王颂毓 2015-02-04 补充所有的接口请求示例和返回示例 蒲剑锋 2015-04-03 增加异步调用接口/check_prepare, /check_notice, /check_asyn ，人脸检测/checking中增 加多人脸检测支持 蒲剑锋 2015-04-15 修改异步调用接口多图片上传功能 蒲剑锋 2015-07-21 增加检测人脸是否存在接口 蒲剑锋 2015-07-22 更新people、crowd、info接口调用示例地址 蒲剑锋 2015-07-22 修改checking返回接口中人脸中心点坐标center为人脸矩形框左上角Left_coner坐标 蒲剑锋 1. 接口概述 名词解释 ： app_id ： 是app唯一的id ，区分数据所有权 ，区分服务类型、级别的唯一标识。 app_key ： AES的加密密钥 enc_type ： 加密类型 （aes=明文 ， aes=AES加密 ） rnd_once ： 随机数 ，每次请求随机生成 timestamp ： 时间戳 1. 接口调用规则 应用在请求EyeKey提供的API服务时在传递参数enc_type来约定是否需要加解密 ， aes= “” 表示参数明文传递 ； aes= “AES” 表示参数加密传递 ； 2.1 接口标识说明 依赖EyeKey提供的API开发应用会在申请创建应用时由系统生成唯一的app_id和app_key ，app_id作为应 用的唯一标识 ；app_key作为应用访问接口时AES加密的密钥 ，应用可在web管理界面重新设置 app_key ，重新设置后原有的app_key立即失效 ，新的app_key立即启用 ； 开发调试版不用加密信息 ，明文信息调试即可。 1. 接口说明 本文档使用 看云 构建 - 3 - 更新日志 人脸接口主要提供人脸检测、人脸认证、识别等功能 ， 并支持第三方应用创建人脸 （face ）、人 （people ）、人群 （crowd ）、人脸集合 （facegather ）。方便第三方应用实现1 1和1 ：N应用场景。 人脸 （face ）： 在EYEKEY里每个人脸图片被标记为一个face ，有唯一的face_id ； 人 （people ）： 在EYEKEY中可以创建people ，并为people添加人脸 （face ）；开发版每人可添加30张 人脸 ，上线版每人可添加50张人脸 ；开发版应用允许创建100个people ，上线版无人数限制 ； 人群 （crowd ）： 在EYEKEY中可以创建crowd ，并为crowd添加人 （people ）；开发版应用允许创建5 个crowd ，上线版无限制 ；开发版crowd中允许添加100个people ，上线版无人数限制 ； 人脸集合 （facegather ）：在EYEKEY中可以创建facegather ，并为facegather添加face ，添加的face可 以不属于同一个人 ；开发版应用允许创建5个facegather ，上线版无限制 ；开发版应用允许在facegather 中添加100个face ，上线版允许在facegather中添加500个face ； 3.1 探测人脸 Detect 3.1.1 / detect 说明 检测图片中是否存在人脸 ，返回检测到图片中人脸个数 ，超过100张人脸的图片统一返回值为100 ，如果 图片中没有检测到人脸 ，返回0 ； 参数 是否必须 参数名 参数说明 必须 app_id App调用EyeKey API的唯一标识