检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Go SDK 本章节介绍人脸识别服务Go SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境,Go SDK
用服务所在的终端节点,之后前往“我的凭证”页面,即可查看到已生成对应的项目ID。 json解析报错 图5 json parse error 服务端返回的数据格式不符合json格式,导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则,和sd
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。
Python SDK 本章节介绍人脸识别服务Python SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境,支持Python3及以上版本。
创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用FRS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用FRS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。
获取Token Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题: 使用前必读
突请求的更新操作不能被完成。 410 Gone 客户端请求的资源已经不存在。 返回该状态码,表明请求的资源已被永久删除。 411 Length Required 服务器无法处理客户端发送的不带Content-Length的请求信息。 412 Precondition Failed
证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术,帮助客户精准营销。
附录 状态码 错误码 获取项目ID/账号名/AK/SK
由于应用可能需要使用对象存储服务(OBS)中的数据,人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”,完成OBS授权,已授权过的服务,该页面提示“已授权”。 OBS授权时,如果提示委托已达上限,则需要您登录到统一身份认证服务,对委托进行删除或创建新的委托。 服务状态显示“已开通”时,即可调用服务的API。
使用FRS服务需要的权限 使用FRS服务无需权限配置,在管理控制台开通服务后即可使用。 使用FRS服务时,如果您需要使用华为云对象存储服务(OBS)中的数据,请开通对象存储服务OBS授权,可在控制台进行开通。 FRS服务支持IAM细粒度划分策略。 父主题: 权限类
参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明 名称 类型 说明 action
调用SDK实现人脸检测 人脸识别服务软件开发工具包(FRS SDK)是对人脸识别服务提供的REST API进行的封装,以简化用户的开发工作。 本章节以人脸检测API为例,介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装SDK
扣费时调用次数会先在套餐包内进行抵扣,抵扣完后的剩余调用量默认转回按需计费方式,具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣,对于长期使用者,推荐该方式。 生效规则: 按需套餐包购买后立即生效。 已购买的按需套餐包不支持退订,购买前请确认。 按需套餐和具体的区域绑定,购买的套餐只能
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。
action_time 否 String 该参数为动作时间数组拼接的字符串,数组的长度和actions的数量一致,每一项代表了对应次序动作的起始时间和结束时间,单位为距视频开始的毫秒数。 nod_threshold 否 double 该参数为点头动作幅度的判断门限,取值范围:[1,90],默认为10,单位为度。该值设置越大
如何获取正确的终端节点(Endpoint) 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint) 协议类型
携带正确的ID,正常使用FRS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用FRS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。 响应参数 状态码:200