人脸比对

服务简介 :

本服务提供对上传的两张图片内人脸的特征分析比对, 返回相似度分数. 可用于判断两张脸是否是同一人的可能性大小。。

应用场景 :

人证合一验证,用户认证等,可与现有的人脸库进行比对验证。



接口地址 : http://www.tudatech.com:7080/wztimgsvr/faceapi/compare

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 :POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imageid1 string body 上传图片文件1唯一ID; 例子1001
imageid2 string body 上传图片文件1唯一ID; 例子1002
imagetype string body 上传图片类型方式
URL 用图片URL方式上传;
FILE 用本地图片文件方式上传
FILE (即本地图片文件方式上传)
fmt string body 返回结果格式: json或xml json

参数名 类型 必填 参数位置 描述 默认值
imagefile1 file 当imagetype为FILE时, 此为必填 body 图片文件
imagefile2 file 当imagetype为FILE时, 此为必填 body 图片文件


详细使用教程



接口地址 : http://www.tudatech.com:7080/wztimgsvr/faceapi/compare

图片格式要求: JPG格式,图像长及宽约300 – 1200 像素图片

请求方法 : POST

请求参数(body) :

参数名 类型 必填 参数位置 描述 默认值
apikey string body API密钥
imagetype string body 上传图片类型方式
URL 用图片URL方式上传;
FILE 用本地图片文件方式上传
FILE (即本地图片文件方式上传)
imgurl1 string 当imagetype为URL时, 此为必填 body 图片地址URL1
imgurl2 string 当imagetype为URL时, 此为必填 body 图片地址URL2

其他非必填参数与POST请求方法相同



JSON返回示例 :

{"class":"face.api.VseCompareResult","facelist":[{"class":"face.api.VseFaceImage","imageId":"","maxVseFaceBox":{"bottom":158,"class":"face.api.VseFaceBox","left":19,"right":123,"top":54}},{"class":"face.api.VseFaceImage","imageId":"","maxVseFaceBox":{"bottom":192,"class":"face.api.VseFaceBox","left":158,"right":261,"top":89}}],"score":0.856504195586777}

错误码参照:


限制类错误:
API_CODE_ERROR_exceeded_access_total 用户总调用量超限
API_CODE_ERROR_exceeded_access_frequency 用户调用频度超限
API_CODE_ERROR_exceeded_access_frequency_min 服务每分钟调用量超限
API_CODE_ERROR_exceeded_access_frequency_hr 服务每小时调用量超限
API_CODE_ERROR_exceeded_access_frequency_day 用户日调用量超限
API_CODE_ERROR_exceeded_access_frequency_month 服务每月调用量超限
API_CODE_ERROR_two_API_calls_time_too_close 两次调用时间太近

调用方法错误:
API_CODE_ERROR_invalid_apikey Apikey错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgName 图片名错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_imgUrl 图片URL错误
IMAGE_INDEX_ITEM_CODE_ERROR_INVALID_LANG 语言参数错误(中文zh 或英语en)
IMAGE_INDEX_CODE_ERROR_IMAGE_SIZE_TOO_BIG 图片太大(最好在400 – 800PIX JPG 图片)