检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用SDK实现人脸检测 人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。 本章节以人脸检测API为例，介绍如何使用FRS Python SDK。 使用FRS SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK
由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。单击左侧“委托授权”，完成OBS授权，已授权过的服务，该页面提示“已授权”。 OBS授权时，如果提示委托已达上限，则需要您登录到统一身份认证服务，对委托进行删除或创建新的委托。 服务状态显示“已开通”时，即可调用服务的API。
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 表3 请求Body参数 参数名 参数类型
以帮助您安全的控制华为云资源的访问。 如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用FRS服务的其它功能。 通过IAM，您可以在华为云账号中给员工创建IAM用户，并授权控制他们对华为云资源的访问范围。例如，您的员工中有负责
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。
QPS限流时如何增加QPS配额 问题现象 调用人脸识别API时，报错“FRS.0033”。 该报错表示您当前请求数太多，超过流控限制。 解决方法 建议控制请求策略或者进行重试。 增加QPS配额。 请参考人脸识别价格详情，按照您的需求增加QPS配额。 变更QPS规格。 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”。
扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式，具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣，对于长期使用者，推荐该方式。 生效规则： 按需套餐包购买后立即生效。 已购买的按需套餐包不支持退订，购买前请确认。 按需套餐和具体的区域绑定，购买的套餐只能
获取Token Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。 下载并安装Postman。 Postman建议使用7.24.0版本。 下载人脸识别服务Postman配置文件。 下载地址：FRS-API.postman_collection
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表 字段要素说明。 表2 actions字段要素说明 名称 类型 说明 action
终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 部署的服务 华北-北京四
请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 人脸检测API的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://face
action_time 否 String 该参数为动作时间数组拼接的字符串，数组的长度和actions的数量一致，每一项代表了对应次序动作的起始时间和结束时间，单位为距视频开始的毫秒数。 nod_threshold 否 double 该参数为点头动作幅度的判断门限,取值范围:[1,90],默认为10,单位为度。该值设置越大
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
附录 状态码 错误码 获取项目ID/账号名/AK/SK
户等级”定义不同的保留期时长，保留期内资源处理和费用详见“保留期”。保留期满仍未续订或充值，数据将被删除且无法恢复。 欠费说明 您的账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下所示： 开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为
是否是活体。 picture String 检测出最大人脸的图片base64字符串。 confidence Double 系统对检测对象是否为活体的判定置信程度，取值范围为0到1。置信度越高，表示系统越确定检测对象是一个真实的活体。可结合alive参数进行判断，alive返回true表示为活体。
创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
