检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
添加人脸 功能介绍 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中，支持添加最大人脸或所有人脸。 前提条件： 请确保您已开通人脸搜索服务。 约束限制： 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。
修订记录 发布日期 修改说明 2021-10-21 新版SDK正式发布，旧版SDK停止维护。
成。 String类型的value长度范围为[1,256]，可以由数字、字母、下划线和中划线组成。 字段重复定义会被覆盖。 不支持数值类型添加后缀的输入方式，如1.0f，100L，1.0d等。 语法逻辑 "external_fields"以JSON形式定义，名称和类型对应。 Request
https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。选中“Headers”配置项，添加“KEY”为“X-Auth-Token”，“VALUE”为获取的Token值，详细的接口认证鉴权请参见认证鉴权。 响应示例如下，例如人脸识
ServiceInfo 功能介绍 记录子服务信息。 参数说明 表1 结构格式说明表 名称 类型 说明 subscribe_status Boolean 是否开通该子服务。 create_time String 开通该子服务时间。 父主题： 消息对象结构
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
的获取方法请参见获取项目ID。 检查URI中的区域信息是否和调用服务配置的区域是否对应。 URL请参考构造请求章节。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 父主题： 错误码类
如未开通服务请登录人脸识别服务控制台人脸识别服务控制台选择“开通服务”。 如已经开通服务，请检查调用接口的请求地址是否正确。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 图1 检查区域信息 APIG
人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Json 用户添加的额外自定义字段。 父主题： 消息对象结构
FRS自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。
人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题： 消息对象结构
检查访问密钥AK/SK是否获取成功。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确。 参考视频指导 您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 父主题： 错误码类
创建IAM用户，并加入用户组 在IAM控制台中创建用户。 在用户组列表中，单击新建用户组右侧的“用户组管理”。 在“可选用户”列表中选择需要添加的用户至用户组。 父主题： 权限管理
图2 人脸比对示意图 人脸搜索 人脸搜索给用户提供了人脸集操作相关的API。用户可以通过创建人脸集合接口创建属于用户的人脸集；通过添加人脸接口向人脸集中添加图片；通过查询人脸搜索接口，返回与输入人脸相似度最高的N张人脸图片；通过删除人脸接口从人脸集中删除用户不需要的人脸特征；通过删除人脸集接口删除用户创建的人脸集。
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题： API
促销活动期间，每个用户每月前2000次免费（动作活体检测、静默活体检测不免费），具体计费价格请参见人脸识别价格详情。 人脸库资源管理下的接口均免费，人脸资源管理下除添加人脸与删除人脸外均免费。 只有调用成功才会计算调用次数，未用完的免费调用次数不流转到下一个月。 计费规则：按调用次数计费，按月累计，一个自然月后调用次数清零重新累计。
ct-token”就是需要获取的用户Token。获取Token之后，您就可以使用Token认证调用FRS服务API。 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。 图1 获取用户Token响应消息头
Storage Service，简称OBS）读取人脸图片。 云审计服务 人脸识别使用云审计服务（Cloud Trace Service，以下简称CTS）记录人脸识别相关的操作事件，便于日后的查询、审计和回溯，具体如表1所示。云审计服务的更多信息请参见《云审计服务用户指南》。 表1 云审计服务支持的人脸识别操作列表
ID是否存在。 400 FRS.0404 未检测到人脸，无法添加。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0405 未定义的自定义字段，无法添加。 请检查添加的自定义字段是否存在，创建自定义字段后再进行添加。 400 FRS.0406 导入的数据类型与定义不匹配。
查询人脸库当前的状态。 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。 人脸资源管理 添加人脸 添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。 查询人脸 查询指定人脸库中人脸信息。 更新人脸
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
