检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用服务 人脸识别提供了Web化的服务管理平台，即管理控制台，以及基于HTTPS请求的API管理方式。人脸识别以开放API的方式提供给用户，用户需要将人脸识别集成到第三方系统后才可使用。 用户需要先在管理控制台开通人脸识别服务，使用第三方系统调用API即可使用服务，具体流程如下：
查询人脸库当前的状态。 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 人脸资源管理 添加人脸 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。 查询人脸 查询指定人脸库中人脸信息。 更新人脸
准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，Go SDK 支持 go 1.14 及以上版本，可执行 go version 检查当前 Go
ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0405 未定义的自定义字段，无法添加。 请检查添加的自定义字段是否存在，创建自定义字段后再进行添加。 400 FRS.0406 导入的数据类型与定义不匹配。
getCredential(ak, sk); 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量
人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题： 消息对象结构
人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Json 用户添加的额外自定义字段。 父主题： 消息对象结构
获取项目ID/账号名 从控制台获取项目ID/账号名 登录管理控制台。 鼠标移动至用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目ID。 图1 查看项目ID 调用API获取项目ID 项目ID还可以通过调用查询指定条件下的项目信息API获取。
_name} 删除人脸库 DELETE /v2/{project_id}/face-sets/{face_set_name} 人脸资源管理 添加人脸 POST /v2/{project_id}/face-sets/{face_set_name}/faces 查询人脸 GET /v
成。 String类型的value长度范围为[1,256]，可以由数字、字母、下划线和中划线组成。 字段重复定义会被覆盖。 不支持数值类型添加后缀的输入方式，如1.0f，100L，1.0d等。 语法逻辑 "external_fields"以JSON形式定义，名称和类型对应。 Request
AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。
权限管理 权限管理 创建用户组与IAM子用户 为子用户分配权限 用户登录并验证权限 FRS自定义策略
中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token请参考认证鉴权。 添加消息头后的请求如下所示。 POST https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detect
打开用户组列表，找到子用户所在的用户组，单击该用户组的“授权”操作。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。FRS全部系统权限请参见权限管理。 当现有策略不满足时，可使用FRS自定义策略。 子账户被赋予相应权限后，可使用子账户登录FRS控制台，开通所需的服务。 开通服务：主账号
主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。 父主题： 权限管理
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题： API
调用静默活体检测API，为什么在服务管理页面看不到调用量 使用按需计费的调用量，会实时刷新，如果页面没有调用量变化，请刷新页面查看。 使用按QPS配额计费的调用量，暂时未在服务管理页面显示。 父主题： 产品咨询类
如何查看API的使用量 登录人脸识别管理控制台。 在左侧导航栏中选择“云上服务管理”，查看API的使用量。 父主题： API使用类
库，也以开通人脸搜索服务为前提）。人脸库创建在华为云对象存储服务（OBS）中，您可以参考API文档“人脸库资源管理”和“人脸资源管理”相关章节，对人脸库和人脸资源进行管理。 开通人脸识别服务是否需要授权 由于应用可能需要使用对象存储服务（OBS）中的数据，人脸识别服务需要您授权可以操作对象存储服务。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 注册并登录管理控制台。 单击用户名，在下拉列表中单击“我的凭证”。 在“我的凭证”页面的项目列表中查看账号ID。 图1 查看账号ID
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
