检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单
作。 人脸资源管理 添加人脸 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。 查询人脸 查询指定人脸库中人脸信息。 更新人脸 根据人脸ID（face_id）更新单张人脸信息。 删除人脸 根据指定字段删除人脸库中人脸。 批量删除人脸 自定义
附录 状态码 错误码 获取项目ID/账号名/AK/SK
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
Float 对应控制台的界面参数“人脸首次发送时间”。 表示从检测出人脸到发送人脸图之间的计时，单位为s，取值范围[0, 360]，默认值0。 从人脸被检测跟踪开始计时，至该参数所设置的时间结束，算法会选择期间满足发送条件且质量最好的人脸图进行发送。 如果到达所设置的时间，目标都没有出
受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。
详情。 人脸库资源管理下的接口均免费，人脸资源管理下除添加人脸与删除人脸外均免费。 只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费规则：按调用次数计费，按月累计，一个自然月后调用次数清零重新累计。 每个用户可免费使用10个人脸库，每个人脸库容量为10万
应用场景 身份验证 使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
FRS服务使用简介 人脸识别服务（Face Recognition Service，简称FRS），是基于人的脸部特征信息，利用计算机对人脸图像进行处理、分析和理解，用户通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。 服务以开放API（Application
warningMsg 1 人脸没有朝向前方。 2 视频没有超过1秒。 3 视频超过15秒。 4 两个人脸。 5 没有人脸。 6 动作幅度太小。 7 视频质量差或者视频拍摄不是真人。 8 选择不出优选图片。 101 整体人脸质量过低。 102 人脸模糊。 103 人脸姿态太大。 104 人脸有遮挡。
地址，且地址为图片文件的路径。 400 FRS.0016 上传的文件格式不支持。 请参考约束与限制章节，上传支持识别的文件格式。 400 FRS.0017 上传的body体超出允许的范围。 上传的body体超出允许的范围，请检查图片和分辨率的大小是否在允许的范围内。 请参考约束与限制章节，使用符合规定的图片。
如何获取图片的base64编码 人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
Per Second）即每秒钟的请求量。调用人脸识别的接口收费，提供按QPS配额计费的方式，用户可以选择所需的QPS配额，具体计费价格请参见人脸识别价格详情。 系统承诺的QPS是在输入图片分辨率为640*480，200KB左右的图片大小时服务所能承受的规格，超过输入规格系统性能会有下降。如有疑问请及时咨询服务人员。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
将请求样例中的“{endpoint}”进行替换。人脸识别服务的请求地请参考终端节点终端节点章节进行获取。 例如，如果您的服务部署在华北-北京四区域，则该区域的endpoint为“face.cn-north-4.myhuaweicloud.com”。 将请求样例中的“{proje
产品咨询类 如何在含有多张人脸的图片中实现多人脸识别 人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
计费说明 计费说明 到期与欠费
error 服务端返回的数据格式不符合json格式，导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则，和sdk定义的数据结构不一致，导致反序列化失败。 sdk json 数据解析问题。 建议排查服务端返回的数据是否和服务SDK设计的结构、字段一致。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
