检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
应用场景 身份验证 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
制台，开通所需的服务。 开通服务：主账号开通FRS的某个服务时，子账号未开通此服务，则子账号无法调用此服务，需子账号开通此服务后才可调用。 关闭服务：主账号关闭FRS的某个服务时，子账号未关闭此服务，则子账号依然可以调用此服务，并产生相应费用。如果需要暂停此服务，需要对应的子账号也关闭此服务。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
sort语法 json array形式，排序只支持数值类型，字段重复定义会被覆盖。 例1：单个排序字段 "sort":[ { "location": "desc" } ] 例2：多个排序字段 "sort": [
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。 进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。
filter语法 数值类型 数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： {
为什么会请求响应过慢 问题现象 用户发送https请求，需要经过tcp握手以及https证书交换，这个过程如果出现丢包情况，操作系统会进行数据包重传，重传间隔根据系统不同可能会3s或者5s。 解决方案 使用https长连接的方式进行请求，这样不必要每次请求都进行http建连。考虑
自定义字段 数据类型 支持String，Integer，Float，Double，Boolean，Long。 external_image_id，bounding_box，similarity，face_id，create_time，vector，_id，_all，_source为内置字段，自定义字段避免使用。
因权限造成的调用API失败 问题现象 子用户已经开通了人脸识别服务，但是调用时还是提示未订阅。 解决方法 确认调用API所用的区域，与开通服务区域是否一致。 需要核实主账户赋予的权限，并核实开通服务的子账户与调用API时使用的子账户是否相同。 父主题： 权限类
为什么使用人脸识别返回数据为空 问题现象 上传照片中的人像可能存在横置或倒置等情况。 解决方法 尽量选择纯色无干扰背景，保证图片中人像清晰。 上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。 图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
创建用户组与IAM子用户 创建用户组 使用主账号登录IAM服务控制台。 左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。 在“创建用户组”界面，输入“用户组名称”，创建用户组。 返回用户组列表，单击列表中的“授权”。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
人脸识别是否可使用证件类照片 人脸识别服务可以使用证件类照片，提取人脸特征时，非人脸信息不会被提取。受技术与成本多种因素制约，人脸识别服务存在一些约束限制，详细请参见约束与限制。 父主题： 产品咨询类
为什么会出现识别错误的情况 问题原因 底库采集的图片不清晰。 前端抓拍的照片质量不好。 常见的图片质量问题：背光、阴阳脸、角度不正、图片过于模糊。 解决方案 重新录入底库的照片，将质量差的底库照片更换。 改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。
增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”。 单击“购买QPS套餐”对于支持QPS方式调用的接口，调整QPS套餐。 购买时，需注意2个10QPS的套餐不等于一个20QPS的套餐，QPS配额不可通过套餐包数量叠加。
FRS是否支持IAM细粒度划分 FRS服务支持IAM细粒度划分策略，IAM账号与主账号可具备不同的FRS操作权限。 您可以使用IAM的用户管理功能，给员工或应用程序创建IAM用户，可避免分享自己的账号密码。详细创建步骤请参见创建IAM用户。 父主题： 权限类
人脸搜索接口中关于top_n参数如何设置 请求该接口不传“top_n”参数时，默认返回查询到最相似的10张人脸，“top_n”允许设置最大值是1000。 父主题： API使用类
人脸识别所需最低带宽是多少 图片大小和并发都由客户控制，可根据自己业务情况选择宽带大小，人脸识别没有对宽带做最小限制。 父主题： API使用类
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
