检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比
您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 图1 检查区域信息 APIG.0101 在调用人脸识别接口时，报错“APIG.0101”，“The API does not exist or has not
为什么使用人脸识别返回数据为空 问题现象 上传照片中的人像可能存在横置或倒置等情况。 解决方法 尽量选择纯色无干扰背景，保证图片中人像清晰。 上传的人脸图片要求：侧脸不超过30°，抬头低头不超过15°。 图片中人脸需要保持竖置正脸，如果人像是横置或倒置，可以选择旋转至竖置正脸后重试。
准备数据 数据要求 受技术与成本多种因素制约，FRS服务存在一些约束限制。 以人脸检测API为例，输入数据存在以下约束。其他API的的使用约束请参见API参考。 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
检查账号权限，是否欠费，被冻结等。 401 APIG.0307 Token需要更新 Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。
单位：次（times）。 ≥ 0 times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位：次（times）。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位：毫秒（ms）。 ≥ 0 ms 人脸识别 人脸数量 该指标用于统计人脸库的人脸数量。
如何获取图片的base64编码 人脸搜索接口中关于top_n参数如何设置 为什么使用人脸识别返回数据为空 人脸识别所需最低带宽是多少 如何获取OBS桶内最近图片的地址URL 人脸识别上传的人脸图片还可以查询到图片数据吗 人脸搜索是否需要使用OBS服务 如何查看API的使用量
人脸检测接口可以免费调多少次 人脸识别服务中除动作活体检测以外的其他服务每月前2000次有效调用次数是免费的。 父主题： 产品咨询类
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 表1
Interface，应用程序编程接口）的方式提供人脸识别能力，用户调用API接口需要具备一定的编程开发能力，人脸识别后返回的结果为JSON格式，用户需要通过编程来处理识别结果。使用前，请登录人脸识别服务控制台开通服务。 您可以根据以下方式的介绍选择合适的使用方式： 通过华为云API Explorer在线调用FRS服务API。
套餐包提供了更大的折扣，对于长期使用者，推荐该方式。 QPS计费（用于调整并发） QPS（Queries Per Second）即API接口每秒钟完成的请求量。FRS服务默认动作活体检测1QPS、其它接口10QPS。如需更大并发，可购买QPS套餐。 详细说明请参见计费说明。 促销活动期间，每个用户每月前20
base64.b64encode(image_file.read()).decode() print(encoded_string) 父主题： API使用类
为什么会出现识别错误的情况 问题原因 底库采集的图片不清晰。 前端抓拍的照片质量不好。 常见的图片质量问题：背光、阴阳脸、角度不正、图片过于模糊。 解决方案 重新录入底库的照片，将质量差的底库照片更换。 改善前端抓拍条件，调节光照，避免背光情况。运动模糊，去掉模糊照片，调节摄像头参数。
Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json。
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国
建议： 由于过大图片对识别算法精度无明显提升，同时会导致时延较长，建议传入图片小于1MB，一般500KB左右足够。 OBS上存储的图片也建议小于1MB。 图片中人脸像素建议120*120以上。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explore
为什么人脸识别通过率低 问题现象 人脸识别出现通过率低，前端需要抓拍多张才能找到阈值（0.93）以上的结果。 问题原因 底库照片质量不好。 前端抓拍条件很差。 前端抓拍到的人脸姿态跟底库照片的姿态相差较多，或者底库照片与抓拍的人像相差太多。 解决方案 重新录入底库的照片，将质量差的底库照片更换。
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
其他的约束限制信息请参见约束与限制章节。 建议： 由于过大图片对识别算法精度无明显提升，同时会导致时延较长，建议传入图片小于1MB，一般500KB左右足够。 OBS上存储的图片也建议小于1MB。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
