检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Postman是网页调试与辅助接口调用的工具，具有界面简洁清晰、操作方便快捷的特性，可以处理用户发送的HTTP请求，例如：GET，PUT、POST，DELETE等，支持用户修改HTTP请求中的参数并返回响应数据。 Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。
使用人脸检测与比对功能，可进行身份核实，适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术，帮助客户精准营销。
在调用人脸识别接口时，报错“FRS.0020”，子服务未开通。 该报错表示您的子服务没有开通。 产生该报错的原因有以下两种： API没有开通，就直接调用，导致报错。 开通的API与实际调用的不一致，导致报错。 解决方法 如未开通服务请登录人脸识别服务控制台选择“开通服务”。 图1 开通服务
终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 部署的服务 华北-北京四
配置认证信息 配置AK、SK、projectId信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 // 终端节点以 FRS 服务北京四的 endpoint 为例 $ak = getenv('HUAWEICLOUD_SDK_AK');
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
附录 状态码 错误码 获取项目ID/账号名/AK/SK
Python SDK 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
人脸搜索接口中关于top_n参数如何设置 请求该接口不传“top_n”参数时，默认返回查询到最相似的10张人脸，“top_n”允许设置最大值是1000。 父主题： API使用类
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 表3 请求Body参数 参数名 参数类型
Access Key（SK）。 图1 获取AK、SK 登录“我的凭证”页面，获取“IAM用户名”、“账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。 本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK
error 服务端返回的数据格式不符合json格式，导致sdk侧解析json数据报错。 服务端返回的json 数据 不符合json反序列化的规则，和sdk定义的数据结构不一致，导致反序列化失败。 sdk json 数据解析问题。 建议排查服务端返回的数据是否和服务SDK设计的结构、字段一致。
重置密码（可选） 主动修改密码 如果您的华为云账号暂未升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中修改自己的密码。 如果您的华为云账号已升级成华为账号，且您记得当前密码，需要主动修改密码，可以在“基本信息”中单击“华为账号信息”右侧的“前往管理”，前往华为账号网
登录后，“X-Auth-Token”和“project_id”参数会自动填充，无需填写。 填写待检测图片数据。 输入数据image_file为本地文件。attributes为希望检测的人脸属性，如胡须、发型、表情等。 单击“调试”按钮，获取识别结果。 父主题： 调用API或SDK
扣费时调用次数会先在套餐包内进行抵扣，抵扣完后的剩余调用量默认转回按需计费方式，具体计费价格请参见人脸识别价格详情。 这种购买方式相对于按需付费提供了更大的折扣，对于长期使用者，推荐该方式。 生效规则： 按需套餐包购买后立即生效。 已购买的按需套餐包不支持退订，购买前请确认。 按需套餐和具体的区域绑定，购买的套餐只能
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
Access Key（SK）。 图1 获取AK、SK 登录“我的凭证”页面，获取“IAM用户名”、“账号名”以及待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。 本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK
打开用户组列表，找到子用户所在的用户组，单击该用户组的“授权”操作。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时，可使用FRS自定义策略。 子账户被赋予相应权限后，可使用子账户登录FRS控制台，开通所需的服务。 开通服务：主
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
