开发者社区 问答 正文

人脸比对API调用说明



URL说明

协议URL方法参数
HTTPS<host>/face/verifyPOSTJSON字符串

<host> 参见Api调试页面的:请求地址


输入参数


请求参数,以json格式放置于Https Body内
参数类型必选说明举例
typeint0: 通过url识别,参数image_url不为空;1: 通过图片content识别,参数content不为空0
image_url_1string输入图片1的URLhttp://a.com/a.jpg
content_1String输入图片1的内容,base64编码
image_url_2string输入图片2的URLhttp://a.com/a.jpg
content_2String输入图片2的内容,base64编码


返回结果

参数类型说明举例
errnoint0为成功,非0为失败,详细说明参加错误码0
err_msgstring处理失败时的说明invalid image url.
request_idstringrequest_id 请求id信息xx-xx
confidencefloat两张图片中最大人脸属于同一个人的置信度:0-100,如某张图片中没有人脸,返回置信度为085.0
thresholdsfloat数组误识率在10e-3,10e-4,10e-5时对应的置信度分类阈值[60.03, 67.05, 75.45]
rectAint数组图片1最大人脸矩形框(left, top, width, height),如图片中没有人脸,返回矩形框数值均为0[100, 199, 80, 90]
rectBint数组图片2最大人脸矩形框(left, top, width, height),如图片中没有人脸,返回矩形框数值均为0[110, 299, 180, 190]


错误码说明


参见 错误码

展开
收起
nicenelly 2017-10-25 14:20:14 2177 分享 版权
阿里云 AI 助理回答

您提到的内容似乎是关于一个API接口的使用说明,特别是用于图像中的人脸识别和验证的功能。这个API允许用户通过两种方式上传图片进行处理:一是直接提供图片的URL(image_url),二是将图片内容进行Base64编码后作为字符串上传(content)。用户需要在JSON格式的请求体中指定图片类型(type)以及相应的图片数据。

输入参数说明:

  • type: 必选参数,表示图片的输入方式。取值为0时,通过image_url字段提供图片链接;取值为1时,通过content字段提供Base64编码的图片内容。

  • image_url_1, image_url_2: 可选参数,当type为0时使用,分别代表第一张和第二张图片的URL地址。

  • content_1, content_2: 可选参数,当type为1时使用,分别代表第一张和第二张图片经过Base64编码的内容。

返回结果说明:

  • errno: 表示操作状态,0表示成功,非0值表示失败,并且可以通过错误码进一步了解失败原因。

  • err_msg: 当请求失败时,提供具体的错误信息。

  • request_id: 每个请求的唯一标识,可用于追踪或日志记录。

  • confidence: 评估两张图片中最大人脸属于同一个人的置信度,范围是0到100。如果某张图片未检测到人脸,则返回0。

  • thresholds: 数组形式,展示了误识率在不同水平(如10e-3, 10e-4, 10e-5)下对应的置信度阈值,用于区分是否认为是同一人。

  • rectA, rectB: 分别为两张图片中检测到的最大人脸的矩形框坐标信息,包括左上角坐标(left, top)和宽度、高度(width, height)。如果未检测到人脸,则所有数值均为0。

错误码说明:

错误码的具体含义通常会在API文档的另一部分详细列出,它帮助开发者理解请求失败的具体原因,比如网络问题、参数错误、权限不足等。根据您的描述,具体错误码的解释需要参考API调试页面或相关文档提供的“错误码”部分。

如果您在使用阿里云的产品,例如人脸比对服务,遇到具体问题或需要更详细的说明,请直接查阅阿里云官方文档或联系客服获取技术支持。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答