检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
添加人脸 功能介绍 添加人脸到人脸库中。将单张图片中的人脸添加至人脸库中,支持添加最大人脸或所有人脸。 前提条件: 请确保您已开通人脸搜索服务。 约束限制: 只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中,请使用标准Json格式。
成。 String类型的value长度范围为[1,256],可以由数字、字母、下划线和中划线组成。 字段重复定义会被覆盖。 不支持数值类型添加后缀的输入方式,如1.0f,100L,1.0d等。 语法逻辑 "external_fields"以JSON形式定义,名称和类型对应。 Request
catch(ex => { console.log("exception:" + JSON.stringify(ex)); }); 添加人脸 const request = new frs.AddFacesByBase64Request(); const body = new
build cd build cmake -DCMAKE_POSITION_INDEPENDENT_CODE=ON .. // 用以生成动态库 make sudo make install 编译安装 git clone https://github.com/huaweiclou
创建IAM用户,并加入用户组 在IAM控制台中创建用户。 在用户组列表中,单击新建用户组右侧的“用户组管理”。 在“可选用户”列表中选择需要添加的用户至用户组。 父主题: 权限管理
中专门说明。 X-Auth-Token:用户Token,可选,当使用Token方式认证时,必须填充该字段。用户Token请参考认证鉴权。 添加消息头后的请求如下所示。 POST https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detect
FRS自定义策略 如果系统预置的权限,不满足您的授权要求,可以创建自定义策略。自定义策略中可以添加的授权项(Action)请参见权限管理。 目前华为云支持以下两种方式创建自定义策略: 可视化视图创建自定义策略:无需了解策略语法,按可视化视图导航栏选择云服务、操作、资源、条件等策略内容,可自动生成策略。
人脸在图像中的位置。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Object 用户添加的额外自定义字段。 external_image_id String 人脸所在的外部图片ID。 face_id String 人脸ID,由系统内部生成的唯一ID。
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题: API
https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。选中“Headers”配置项,添加“KEY”为“X-Auth-Token”,“VALUE”为获取的Token值,详细的接口认证鉴权请参见认证鉴权。 响应示例如下,例如人脸识
图2 人脸比对示意图 人脸搜索 人脸搜索给用户提供了人脸集操作相关的API。用户可以通过创建人脸集合接口创建属于用户的人脸集;通过添加人脸接口向人脸集中添加图片;通过查询人脸搜索接口,返回与输入人脸相似度最高的N张人脸图片;通过删除人脸接口从人脸集中删除用户不需要的人脸特征;通过删除人脸集接口删除用户创建的人脸集。
AK/SK签名认证方式仅支持消息体大小12MB以内,12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。 AK(Access Key ID):访问密钥ID。与私有访问密钥关联的唯一标识符;访问密钥ID和私有访问密钥一起使用,对请求进行加密签名。
人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Json 用户添加的额外自定义字段。 父主题: 消息对象结构
人脸ID,由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 external_fields Json 用户添加的额外字段。 父主题: 消息对象结构
促销活动期间,每个用户每月前2000次免费(动作活体检测、静默活体检测不免费),具体计费价格请参见人脸识别价格详情。 人脸库资源管理下的接口均免费,人脸资源管理下除添加人脸与删除人脸外均免费。 只有调用成功才会计算调用次数,未用完的免费调用次数不流转到下一个月。 计费规则:按调用次数计费,按月累计,一个自然月后调用次数清零重新累计。
object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 external_fields Object 用户添加的额外字段。 external_image_id String 人脸所在的外部图片ID。 face_id String 人脸ID,由系统内部生成的唯一ID。
查询人脸库当前的状态。 删除人脸库 删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据,该数据无备份,删除时请谨慎操作。 人脸资源管理 添加人脸 添加人脸到人脸库中,检测到传入的单张图片中存在多少张人脸,则增加多少张人脸到人脸库当中。 查询人脸 查询指定人脸库中人脸信息。 更新人脸
ID是否存在。 400 FRS.0404 未检测到人脸,无法添加。 请参考约束与限制章节,上传符合规范的人脸图片。 400 FRS.0405 未定义的自定义字段,无法添加。 请检查添加的自定义字段是否存在,创建自定义字段后再进行添加。 400 FRS.0406 导入的数据类型与定义不匹配。
name} 删除人脸库 DELETE /v2/{project_id}/face-sets/{face_set_name} 人脸资源管理 添加人脸 POST /v2/{project_id}/face-sets/{face_set_name}/faces 查询人脸 GET /v2