检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
有哪些途径可以使用人脸识别的API 共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具,用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端,可以发送HTTP请求给服务端,并接收响应消息。cURL适用于接口调试。 编码 通过编码调用接口,组装请求消息,并发送处理请求消息。
(x86)\huaweicloud-sdk-cpp-v3。 开始使用 在开始使用之前,请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以参考安装SDK完成sdk的安装和编译。 详细的SDK介绍,使用异步客户端,配置日志等操作请参见SDK中心、C++ SDK使用指导。
证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术,帮助客户精准营销。
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。
扣费时调用次数会先在套餐包内进行抵扣,抵扣完后的剩余调用量默认转回按需计费方式,具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣,对于长期使用者,推荐该方式。 生效规则: 按需套餐包购买后立即生效。 已购买的按需套餐包不支持退订,购买前请确认。 按需套餐和具体的区域绑定,购买的套餐只能
List [Point] 鼻子轮廓,Point为轮廓坐标值。 mouth_contour List [Point] 嘴巴轮廓,Point为轮廓坐标值。 eyebrow_contour List [Point] 眉毛轮廓,Point为轮廓坐标值。 eyes_contour List [Point]
终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint) 协议类型 部署的服务 华北-北京四
附录 状态码 错误码 获取项目ID/账号名/AK/SK
是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度,取值范围为0到1。置信度越高,表示系统越确定检测对象是一个真实的活体。可结合alive参数进行判断,alive返回true表示为活体。
获取Token Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection
由于应用可能需要使用对象存储服务(OBS)中的数据,人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”,完成OBS授权,已授权过的服务,该页面提示“已授权”。 OBS授权时,如果提示委托已达上限,则需要您登录到统一身份认证服务,对委托进行删除或创建新的委托。 服务状态显示“已开通”时,即可调用服务的API。
参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明 名称 类型 说明 action
error 服务端返回的数据格式不符合json格式,导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则,和sdk定义的数据结构不一致,导致反序列化失败。 sdk json 数据解析问题。 建议排查服务端返回的数据是否和服务SDK设计的结构、字段一致。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。
携带正确的ID,正常使用FRS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用FRS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。 响应参数 状态码:200
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
action_time 否 String 该参数为动作时间数组拼接的字符串,数组的长度和actions的数量一致,每一项代表了对应次序动作的起始时间和结束时间,单位为距视频开始的毫秒数。 nod_threshold 否 double 该参数为点头动作幅度的判断门限,取值范围:[1,90],默认为10,单位为度。该值设置越大
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候,PATCH可能会去创建一个新的资源。 人脸检测API的URI部分,您可以看到其请求方法为“POST”,则其请求为: POST https://face