正在生成
详细信息:
检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
人脸的识别、比对以及相似度查询等。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力,熟悉Java、Python、iOS、Android、Node.js编程语言。 FRS服务需要用户通过调用API接口,识别图片中的人脸信息,然后返回JSON格式的识别结果,用户需要通过编码将识别结果对接到业务系统。
关闭服务 FRS服务开通后,如不使用,可登录控制台进行关闭。 如果您是主账户,也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
申请服务 在调用API之前,必须先申请开通服务,下面是申请服务的相关步骤。 申请服务前,必须先注册云账号,并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求,选择服务部署区域,开通所需服务(例如:人脸检测),单击右侧的“开通服务”。 香港、曼谷区域API也可以使用
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证(Identity and Access Management,简称IAM)服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务(Object Storage Service,简称OBS)读取人脸图片。 云审计服务
使用FRS服务,是否会保存用户数据 FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念,我们基于安全、合规、隐私、韧性、透明,为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明,可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
计费说明 计费说明 到期与欠费
API概览 人脸识别服务所提供的API,均符合RESTful API设计规范,如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
准备数据 数据要求 受技术与成本多种因素制约,FRS服务存在一些约束限制。 以人脸检测API为例,输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中,请使用标准Json格式。
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
携带正确的ID,正常使用FRS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用FRS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。
AllUsers 为所有子用户订阅人脸搜索服务 √ × frs:faceSearch:unsubscribeAllUsers 为所有子用户取消订阅人脸搜索服务 √ × frs:faceCompare:subscribe 订阅人脸比对服务 √ × frs:faceCompare:unsubscribe
脸识别服务接口产生扣费。 按需计费转为套餐包时,若套餐包还未生效,此时调用此服务,将按照按需计费模式计费。 用户调用额超出购买套餐配额。 用户购买QPS套餐包,超出并发后,调用按需接口。 用户购买服务套餐的区域与实际调用的区域不一致。 用户购买的服务与调用服务不一致。 父主题: 计费说明
请求发送以后,您会收到响应,包含:状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求消息头,响应同样也有消息头,如“Content-type”。
MIIaBgYJKoZIhvcNAQcC… 请求消息体 请求消息体通常以结构化格式发出,与请求消息头中Content-type对应,传递除请求消息头之外的内容。若请求消息体中参数支持中文,则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同,也并不是每个接口都需要有请求消息体(或者说消息体为空),GET
parse error 服务端返回的数据格式不符合json格式,导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则,和sdk定义的数据结构不一致,导致反序列化失败。 sdk json 数据解析问题。 建议排查服务端返回的数据是否和服务SDK设计的结构、字段一致。
SDK 本章节介绍人脸识别服务Python SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境,支持Python3及以上版本。
Go SDK 本章节介绍人脸识别服务Go SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境,Go SDK
OUD_SDK_SK。 图3 Windows环境新建环境变量 初始化客户端 指定云服务region方式(推荐) // 初始化指定云服务的客户端 {Service}Client ,以初始化FRS服务的 FrsClient 为例 var client = FrsClient.NewBuilder()