检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
import com.huaweicloud.sdk.frs.v2.region.FrsRegion; import com.huaweicloud.sdk.frs.v2.*; import com.huaweicloud.sdk.frs.v2.model.*; 配置认证信息 配置AK
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
API 人脸检测 人脸比对 活体检测 人脸搜索 人脸库资源管理 人脸资源管理
（错误码区间：401～500） 400 FRS.0401 找不到对应类型的值，无法删除。 请参考人脸资源管理接口说明。 400 FRS.0402 输入的字段不存在。 请参考人脸资源管理接口说明。 400 FRS.0403 Face ID不存在。 请检查输入的Face ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
统一身份认证服务 人脸识别使用统一身份认证（Identity and Access Management，简称IAM）服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务（Object Storage Service，简称OBS）读取人脸图片。 云审计服务 人脸识别使用云审计服务（Cloud
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
授权区域。 如表1所示，包括了FRS的所有系统角色。 表1 FRS系统策略 策略名称 描述 策略类型 依赖关系 FRS FullAccess 所有权限 系统策略 无 FRS ReadOnlyAccess 只读访问权限 系统策略 无 表2列出了FRS常用操作与系统策略的授权关系，您可以参照该表选择合适的系统策略。
因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 NotFound 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 MethodNotAllowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not
HuaweiCloud\SDK\Core\Exceptions\ServiceResponseException; use HuaweiCloud\SDK\Frs\V2\FrsClient; 配置客户端连接参数 默认配置 // 使用默认配置 $config = HttpConfig::getDefaultConfig();
/v2/{project_id}/face-sets/{face_set_name}/faces?offset=xxx&limit=xxx 或者 GET /v2/{project_id}/face-sets/{face_set_name}/faces?face_id={face_id} 表1 路径参数
它接口10QPS。当默认QPS无法满足您的业务需求时，可修改QPS配额，具体计费价格请参见人脸识别价格详情，增加QPS配额方法请参见QPS限流时如何增加QPS配额。 生效规则： 套餐包购买后大约5分钟内生效。 调用人脸识别API需在QPS套餐包生效期内调用。 已购买QPS套餐包支持退订，支持变更QPS配额。
计费说明 计费说明 到期与欠费
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。 单击左上角“File
WarningList 功能介绍 视频活体检测警告信息。 参数说明 表1 结构格式说明 名称 类型 说明 warningCode Integer 警告ID。 warningMsg String 警告消息。 表2 错误提示 warningCode warningMsg 1 人脸没有朝向前方。
"face_id": "JLa9hYLl" } ] } 状态码：400 失败响应样例 { "error_code": "FRS.0404", "error_msg": "Detect no face, can not add it to face set
申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用中国站账号进行开通；如您需要使用国际站账号开通香港、曼谷区域API，请联系客服获取开通支持。 图1 开通服务 由于应用可能需要使
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
