检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
FRS服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于人脸识别的相关声明请参见人脸识别服务声明。 父主题： 数据安全类
使用流程简介 人脸识别通过实时访问和调用API获取人脸处理结果，帮助用户自动进行人脸的识别、比对以及相似度查询等。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 FRS服务需要用户通过调用
本地调用 本章节以人脸检测为例，介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
欢迎使用人脸识别服务（Face Recognition Service，简称FRS），该服务能够在图像中快速检测人脸、分析人脸关键点信息、获取人脸属性、实现人脸的比对和检索。 人脸识别服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人脸识别服务API之前，请确保已经充分了解
认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
到期与欠费 保留期 包年包月资源包到期后，将自动转为按需计费。转按需后如果账号欠费，会根据“客户等级”定义不同的保留期时长，保留期内资源处理和费用详见“保留期”。保留期满仍未续订或充值，数据将被删除且无法恢复。 欠费说明 您的账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下所示：
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对
终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint）
自定义字段总个数不能超过10个，key的长度范围为[1,36]，可以由数字、字母、下划线和中划线组成。 String类型的value长度范围为[1,256]，可以由数字、字母、下划线和中划线组成。 字段重复定义会被覆盖。 不支持数值类型添加后缀的输入方式，如1.0f，100L，1
区域与可用区 什么是区域和可用区域
步骤1：开通服务 登录人脸识别服务控制台。 控制台左上角默认显示服务部署在“华北-北京四”区域，请您根据业务需要选择对应区域，详细区域说明请参见什么是区域和可用区域。 单击左侧“委托授权”，完成OBS授权。 图1 服务授权 选择需要使用的API，进行开通。 本示例中需开通人脸检测API（V2）。
myhuaweicloud.com”。 将请求样例中的“{project_id}”进行替换。项目ID的获取方法请参见获取项目ID。 检查URI中的区域信息是否和调用服务配置的区域是否对应。 URL请参考构造请求章节。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud
脸识别服务期间，调用节点需与开通服务节点保持一致。 子用户缺少某个特定权限 当创建的子用户缺少某个特定权限时，执行开通操作时，会报错误原因和缺少的权限。例如，下图报缺少frs:faceDetect:subscribe（开通人脸检测的权限）。 出现此类报错，子用户可联系主账户开通相
获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。选中“Headers”配置项，添加“KEY”为“X-Auth-Token”，“VALUE”为获取的Token值，详细的接口认证鉴权请参见认证鉴权。
侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。 支持人脸图片旋转角检测，返回人脸图片顺时针旋转角度，值为0°、90°、180°和270°。 建议： 由于过大图片对识别算法精度无明显提升，同时会导致时延较长，建议传入图片小于1MB，一般500KB左右足够。 OBS上存储的图片也建议小于1MB。
这种购买方式相对于按需付费提供了更大的折扣，对于长期使用者，推荐该方式。 生效规则： 按需套餐包购买后立即生效。 已购买的按需套餐包不支持退订，购买前请确认。 按需套餐和具体的区域绑定，购买的套餐只能在绑定的区域使用，不能在非套餐包购买区域使用，如在非套餐包购买区域使用，将会在所调用的区域产生计费。 调用人脸
步骤1：开通服务 登录人脸识别服务控制台。 控制台左上角默认显示服务部署在“华北-北京四”区域，请您根据业务需要选择对应区域，详细区域说明请参见什么是区域和可用区域。 单击左侧“委托授权”，完成OBS授权。 图1 服务授权 选择需要使用的API，进行开通。 本示例中需开通人脸检测API（V2）。
请参考约束与限制章节，上传支持识别的文件格式。 400 FRS.0017 上传的body体超出允许的范围。 上传的body体超出允许的范围，请检查图片和分辨率的大小是否在允许的范围内。 请参考约束与限制章节，使用符合规定的图片。 500 FRS.0018 服务内部错误。 请联系客服提供支持。
人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。 表1 人脸识别API 类型 API 说明 人脸检测 人脸检测 人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 人脸比对 人脸比对 人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传
样例中需要修改的参数“{endpoint}”、{project_id}，是否按规范进行替换。同时检查url中填写的endpoint区域时否和开通服务区域一致。 参考API使用说明获取正确的请求样例。 # 查询服务状态 https://{endpoint}/v1/{project_id}/subscribe
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
