检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
NET SDK 本章节介绍.NET SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已具备开发环境,.NET SDK 适用于.NET Standard 2.0 及其以上版本;C# 4.0 及其以上版本。
Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账,当前仅支持按需计费模式。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。
String 项目ID,获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库,每个人脸库容量为10万
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库,每个人脸库容量为1
Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 获取并安装FRS Python SDK。 以PyCharm为例,介绍如何安装SDK。
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账,当前仅支持按需计费模式。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。
filter语法 数值类型 数值类型的范围查询,[]包含两端点值,{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例: {
SDK的详细步骤如下所示: 步骤1:开通服务 步骤2:安装SDK 步骤3:获取示例代码 步骤4:调用服务 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 步骤1:开通服务 登录人脸识别服务控制台。 控制台左上角默认显示服务部署在“华北-北京四”区
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账,当前仅支持按需计费模式。 获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。
Attributes 功能介绍 人脸属性结构。 参数说明 表1 结构格式说明表 名称 类型 说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜: yes:戴眼镜 none:未戴眼镜
自定义字段 数据类型 支持String,Integer,Float,Double,Boolean,Long。 external_image_id,bounding_box,similarity,face_id,create_time,vector,_id,_all,_source为内置字段,自定义字段避免使用。
DetectFace 功能介绍 人脸检测以及人脸比对返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 landmark Landmark
SearchFace 功能介绍 人脸搜索返回的人脸结构。 参数说明 表1 结构格式说明表 名称 类型 说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID,由系统内部生成的唯一ID。
BoundingBox 功能介绍 人脸在图像中的位置,坐标系的原点(0,0)在左上角。 参数说明 表1 结构格式说明表 名称 类型 说明 top_left_x Integer 矩形框左上角横坐标。 top_left_y Integer 矩形框左上角纵坐标。 width Integer
FaceQuality 功能介绍 人脸质量结构。 参数说明 表1 结构格式说明表 名称 类型 说明 total_score Double 人脸质量总分,取值范围[0-1],分值越大质量越高。 blur Double 模糊度,取值范围[0-1],分值越大模糊问题越严重。 pose Double
N张人脸图片;通过删除人脸接口从人脸集中删除用户不需要的人脸特征;通过删除人脸集接口删除用户创建的人脸集。 人脸搜索可用于企业、住宅的安全管理等多种场景,但由于翻拍照片和本人照片人脸搜索服务无法感知,不可用于防翻拍场景。 图3 人脸搜索示意图 活体检测 动作活体检测 动作活体检测
VideoDetectResult 功能介绍 视频活体检测结果结构体。 参数说明 表1 结构格式说明表 名称 类型 说明 alive Boolean 是否是活体。 picture String 检测出最大人脸的图片base64。 actions List 动作列表。详细参数请参见表