URL说明
协议 | URL | 方法 | 参数 |
HTTPS | <host>/face/verify | POST | JSON字符串 |
<host> 参见Api调试页面的:请求地址
请求参数,以json格式放置于Https Body内
参数 | 类型 | 必选 | 说明 | 举例 |
type | int | 是 | 0: 通过url识别,参数image_url不为空;1: 通过图片content识别,参数content不为空 | 0 |
image_url_1 | string | 否 | 输入图片1的URL | http://a.com/a.jpg |
content_1 | String | 否 | 输入图片1的内容,base64编码 | |
image_url_2 | string | 否 | 输入图片2的URL | http://a.com/a.jpg |
content_2 | String | 否 | 输入图片2的内容,base64编码 |
参数 | 类型 | 说明 | 举例 |
errno | int | 0为成功,非0为失败,详细说明参加错误码 | 0 |
err_msg | string | 处理失败时的说明 | invalid image url. |
request_id | string | request_id 请求id信息 | xx-xx |
confidence | float | 两张图片中最大人脸属于同一个人的置信度:0-100,如某张图片中没有人脸,返回置信度为0 | 85.0 |
thresholds | float数组 | 误识率在10e-3,10e-4,10e-5时对应的置信度分类阈值 | [60.03, 67.05, 75.45] |
rectA | int数组 | 图片1最大人脸矩形框(left, top, width, height),如图片中没有人脸,返回矩形框数值均为0 | [100, 199, 80, 90] |
rectB | int数组 | 图片2最大人脸矩形框(left, top, width, height),如图片中没有人脸,返回矩形框数值均为0 | [110, 299, 180, 190] |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
您提到的内容似乎是关于一个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调试页面或相关文档提供的“错误码”部分。
如果您在使用阿里云的产品,例如人脸比对服务,遇到具体问题或需要更详细的说明,请直接查阅阿里云官方文档或联系客服获取技术支持。