本文介绍人脸比对CompareFace的语法及示例。
功能描述
人脸比对1:1基于您输入的两张图片,分别挑选两张图片中的最大人脸进行比较,判断是否为同一人。同时返回这两个人脸的矩形框坐标、比对的置信度,以及不同误识率的置信度阈值。
应用场景
- 金融业务:比对用户身份证照片和现场拍摄的已获授权的真人照片,判断用户信息真实性,可提供快速安全的身份核验流程,适用于互联网远程开户、刷脸支付等金融业务。
- 人脸考勤:无接触式刷脸考勤,疫情防控场景下企业考勤首选,且能有效防止代打卡等作弊行为。
- 公共服务:客户直接刷脸办理业务,通过人脸比对识别身份信息,减少身份证查验、复印存档等环节,提高公共服务窗口办理业务的效率。
- 酒店自助入住:住客刷脸自助办理入住,将现场授权获取的人脸照片,与身份证提取的照片进行1:1比对,确保住客身份的真实性的同时,减少人工核查和服务成本,向住客提供便捷的入住体验。
特色优势
- 高精度识别: 由达摩院提供业内领先的人脸识别算法,算法准确率超过99%。
- 平台服务稳定:提供在高并发,大流量下的毫秒级识别响应和99.999%的可靠性保障。
前提条件
计费说明
关于人脸比对的计费方式及报价,详情请参见计费介绍。
输入限制
- 图像格式:JPEG、JPG、PNG、BMP。
- 图像大小:不超过3M。
- 图像分辨率:大于32×32像素,小于2048×2048像素,人脸占比不低于64×64像素。
- URL地址中不能包含中文字符。
- 可使用URL与Base64编码字符串混合输入。例如:输入ImageURLA和ImageDateB的值,不输入ImageURLB和ImageDateA的值。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CompareFace |
要执行的操作。取值:CompareFace。 |
QualityScoreThreshold | Float | 否 | 97 |
质量分阈值,取值范围[0.0,100.0]。0.0或空则表示不做质量分判断逻辑。 |
ImageURLA | String | 否 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceA1.jpg |
图像A的URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
ImageURLB | String | 否 | https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceB.jpg |
图像B的URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL。 |
ImageDataA | String | 否 | /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgK**** |
图像A的Base64编码字符串。当与URL方式共存时,URL方式优先。 |
ImageDataB | String | 否 | /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ**** |
图像B的Base64编码字符串。当与URL方式共存时,URL方式优先。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Data | Struct |
返回的结果数据内容。 |
|
Confidence | Float | 89.88594055175781 |
两张图片中的最大人脸属于同一个人的置信度,取值范围0~100。如果某张图片中没有人脸,则返回的置信度为0。 |
MessageTips | String | imageB quality score less threshold |
信息提示信息,纯文字描述,目前支持质量分的提示信息。例如,图像B的质量分小于输入参数设置的阈值,则系统会返回 |
QualityScoreA | Float | 97.26718139648438 |
输入图像A的质量分。 |
QualityScoreB | Float | 96.01641845703125 |
输入图像B的质量分。 |
RectAList | List | [105,62,87,110] |
图片A中最大人脸矩形框 |
RectBList | List | [132,58,84,105] |
图片B中最大人脸矩形框 |
Thresholds | List | [61,69,75] |
误识率在1/1000,1/10000,1/100000的情况下分别对应的置信度阈值。例如 |
RequestId | String | C6499918-E932-41B3-96F5-A18F50D262DD |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CompareFace
&ImageURLA=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceA1.jpg
&ImageURLB=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/ceshi/CompareFaceB.jpg
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>C6499918-E932-41B3-96F5-A18F50D262DD</RequestId>
<Data>
<MessageTips>imageB quality score less threshold</MessageTips>
<QualityScoreA>97.26718139648438</QualityScoreA>
<QualityScoreB>96.01641082763672</QualityScoreB>
<Thresholds>61</Thresholds>
<Thresholds>69</Thresholds>
<Thresholds>75</Thresholds>
<Confidence>89.88594055175781</Confidence>
<RectAList>105</RectAList>
<RectAList>62</RectAList>
<RectAList>87</RectAList>
<RectAList>110</RectAList>
<RectBList>132</RectBList>
<RectBList>58</RectBList>
<RectBList>84</RectBList>
<RectBList>105</RectBList>
</Data>
JSON
格式
{
"RequestId": "C6499918-E932-41B3-96F5-A18F50D262DD",
"Data": {
"MessageTips": "imageB quality score less threshold",
"QualityScoreA": 97.26718139648438,
"QualityScoreB": 96.01641082763672,
"Thresholds": [
61,
69,
75
],
"Confidence": 89.88594055175781,
"RectAList": [
105,
62,
87,
110
],
"RectBList": [
132,
58,
84,
105
]
}
}
错误码
关于人脸比对1:1的错误码,详情请参见常见错误码。
SDK参考
阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。
安全声明
- 请确保上传的图片或文件来源符合相应的法律法规。
- 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。
在文档使用中是否遇到以下问题
更多建议
匿名提交