检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
人脸识别上传的人脸图片还可以查询到图片数据吗 人脸识别不存储客户人脸图片，只是根据客户的图片来检测人脸参数，只存储人脸特征。如果需要存储图片数据可参考以下方法： 可以开通华为云OBS，存储人脸图片。 人脸图片可以存储在客户自己的数据库中。 父主题： API使用类
用方法请参见调用API实现人脸检测。 通过软件开发工具包（SDK）调用FRS服务API。 如果您是开发工程师，熟悉代码编写，FRS服务为您提供SDK，方便您快速集成。 该方式需要编写并调试代码，安装配置开发环境。使用方法请参见调用SDK实现人脸检测。
果，帮助用户自动进行人脸的识别、比对以及相似度查询等，打造智能化业务系统，提升业务效率。 API文档 API概览 申请服务 人脸检测 人脸对比 活体检测 人脸搜索 人脸库资源管理 人脸资源管理 02 购买 人脸识别服务的计费方式简单、灵活，您既可以选择按实际使用时长计费。也可以选择更经济的按包周期计费方式。
准备数据 数据要求 受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通；如您需要使用国际站账号开通香港、曼谷区域API，请联系客服获取开通支持。
概述 欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人脸识别
myhuaweicloud.com HTTPS 人脸检测，人脸比对，人脸搜索，静默活体检测，动作活体检测 华东-上海一 cn-east-3 face.cn-east-3.myhuaweicloud.com HTTPS 人脸检测，人脸比对，人脸搜索 华南-广州 cn-south-1
提升业务效率。 当前人脸识别提供了以下子服务： 人脸检测 人脸比对 人脸搜索 活体检测 人脸检测 人脸检测是在图像中准确识别出人脸的位置和大小。用户通过该服务，可以同时识别出图片中包含的不同倾角正脸及侧脸。 图1 人脸检测示意图 人脸比对 通过对人脸区域的特征进行对比，该服务可
说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。 活体检测 动作活体检测 通过判断
当前人脸识别服务中，如果传入的图片中包含多个人脸，则只能选取最大的一个人脸进行识别。但是可以使用如下方法，实现一张图片中多张人脸的识别（比对/搜索）： 调用人脸检测接口，可以得到多张人脸在图片中的像素位置。 通过获取到的人脸位置信息，从原图中将人脸图片截出，可以参考多人脸识别Demo。 再调用人脸识别接口，实现多人脸的比对/搜索。
frs:faceDetect:subscribe 订阅人脸检测服务 √ × frs:faceDetect:unsubscribe 取消订阅人脸检测服务 √ × frs:faceDetect:getSubscribeUserList 查询订阅人脸检测的用户列表 √ √ frs:faceDetect:subscribeAllUsers
/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秒。
人脸识别是否可使用证件类照片 如何处理未经授权的情况 为什么会出现识别错误的情况 为什么人脸识别通过率低 为什么会请求响应过慢 人脸检测接口可以免费调多少次 如何关闭已申请的服务 调用静默活体检测API，为什么在服务管理页面看不到调用量 人脸识别服务是否支持私有化部署 人脸识别服务是否支持手机端（安卓和IOS）
如何获取图片的base64编码 本节以Python为例，介绍如何将本地图片，转换为base64编码。您也可以使用在线的图片转base64工具。 使用时，需要将代码的d:\demo.jpg替换为实际图片路径。 import base64 with open("d:\demo.jpg"
build(); endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用人脸检测接口 DetectFaceByBase64 为例 const request = new frs.DetectFaceByBase64Request();
请参考人脸搜素请求参数章节，检查排序字段是否定义。 活体检测错误 （错误码区间：701～800） 400 FRS.0701 视频解析错误。 请检查视频是否有损坏。 400 FRS.0702 不支持的动作。 请参考动作活体检测的请求参数，检查输入的动作是否存在。 400 FRS.0703
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
