服务简介 :
本服务提供对上传的两张图片内人脸的特征分析比对, 返回相似度分数. 可用于判断两张脸是否是同一人的可能性大小。。
应用场景 :
人证合一验证,用户认证等,可与现有的人脸库进行比对验证。
接口地址 : 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请求方法相同
{"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 图片) |