检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通；如您需要使用国际站账号开通香港、曼谷区域API，请联系客服获取开通支持。
概述 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人脸识别
/v2/{project_id}/face-sets/{face_set_name}/search 活体检测 动作活体检测 POST /v1/{project_id}/live-detect 活体检测 静默活体检测 POST /v1/{project_id}/live-detect-face 人脸库资源管理
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。 动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。
侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。 动作活体检测 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。
= GetCredential(ak, sk) 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量
人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量 人脸识别服务是否支持私有化部署 人脸识别服务是否支持手机端（安卓和IOS）
当前人脸识别服务中，如果传入的图片中包含多个人脸，则只能选取最大的一个人脸进行识别。但是可以使用如下方法，实现一张图片中多张人脸的识别（比对/搜索）： 调用人脸检测接口，可以得到多张人脸在图片中的像素位置。 通过获取到的人脸位置信息，从原图中将人脸图片截出，可以参考多人脸识别Demo。 再调用人脸识别接口，实现多人脸的比对/搜索。
用方法请参见调用API实现人脸检测。 通过软件开发工具包（SDK）调用FRS服务API。 如果您是开发工程师，熟悉代码编写，FRS服务为您提供SDK，方便您快速集成。 该方式需要编写并调试代码，安装配置开发环境。使用方法请参见调用SDK实现人脸检测。
请参考人脸搜素请求参数章节，检查排序字段是否定义。 活体检测错误 （错误码区间：701～800） 400 FRS.0701 视频解析错误。 请检查视频是否有损坏。 400 FRS.0702 不支持的动作。 请参考动作活体检测的请求参数，检查输入的动作是否存在。 400 FRS.0703
X-Auth-Token值获取方法请参见快速入门。 使用external_image_id（人脸所在的外部图片ID）删除人脸库中的某一人脸特征 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces?external_image_id=imageID
调用失败时的错误信息。 调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 删除指定的人脸库 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet Request Header: Content-Type:
当创建的子用户缺少某个特定权限时，执行开通操作时，会报错误原因和缺少的权限。例如，下图报缺少frs:faceDetect:subscribe（开通人脸检测的权限）。 出现此类报错，子用户可联系主账户开通相应的服务。或者由主账户使用FRS自定义策略，帮助子用户开通权限后，子用户自行开通服务。 父主题：
调用失败时的错误信息。 调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 查询所拥有的全部人脸库信息 GET https://{endpoint}/v2/{project_id}/face-sets Request Header: Content-Type:
调用失败时的错误信息。 调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 查询指定人脸库的信息 GET https://{endpoint}/v2/{project_id}/face-sets/showFaceSet Request Header: Content-Type:
请求示例 X-Auth-Token值获取方法请参见快速入门。 通过预设的filter筛选条件，批量删除人脸库中的多个人脸特征 DELETE https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces/batch Request
默认值：小时。 否 响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于人脸检测接口，返回如下消息体。 { "faces": [ { "bounding_box": { "width":
调用失败时的错误信息。 调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 在人脸库中查询某一人脸特征信息 GET https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces?offset=0&limit=1
调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。 向人脸库中添加人脸，人脸通过图片base64编码传入 POST https://{endpoint}/v2/{project_id}/face-sets/showFaceSet/faces Request Header:
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
