人脸识别服务 FRS-华为云

人脸识别服务 FRS-创建人脸库:响应参数

响应参数状态码：200 表5 响应Body参数参数参数类型描述 face_set_info FaceSetInfo object 人脸库信息，详见FaceSetInfo。调用失败时无此字段。表6 FaceSetInfo 参数参数类型描述 face_number Integer 人脸库中已有的人脸特征的数量。 external_fields Object 用户的自定义字段。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 face_set_name String 人脸库名称。 create_date String 创建时间。 face_set_capacity Integer 人脸库最大的容量。创建人脸库时，请求参数如果不设置face_set_capacity参数，默认每个人脸库最大容量为10万个人脸特征。状态码： 400 表7 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参考错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

人脸识别服务 FRS

人脸识别服务 FRS-创建人脸库:功能介绍

功能介绍创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。前提条件：请确保您已开通人脸搜索服务。默认情况下，一个人脸库最大可支持10万个人脸特征，一个用户最多可创建10个人脸库，最多可支持10*10万（100万）个人脸特征。如您的需求超出100万个人脸特征，可通过工单或者服务热线（ 4000-955-988或950808 转1）与我们联系，咨询具体解决方案。

人脸识别服务 FRS

人脸识别服务 FRS-人脸搜索:响应参数

响应参数状态码：200 表4 响应Body参数参数参数类型描述 faces Array of SearchFace objects 查找的人脸集合，详见SearchFace。调用失败时无此字段。表5 SearchFace 参数参数类型描述 bounding_box BoundingBox object 人脸在图像中的位置。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Object 用户添加的额外自定义字段。 external_image_id String 人脸所在的外部图片ID。 face_id String 人脸ID，由系统内部生成的唯一ID。表6 BoundingBox 参数参数类型描述 width Integer 矩形框宽度。 top_left_y Integer 矩形框左上角纵坐标。 top_left_x Integer 矩形框左上角横坐标。 height Integer 矩形框高度。状态码： 400 表7 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参考错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

人脸识别服务 FRS

人脸识别服务 FRS-人脸搜索:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账，当前仅支持按需计费模式。获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。说明：创建企业项目后，在传参时，有以下三类场景。携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。表3 请求Body参数参数名参数类型是否必选说明 image_url String 与image_file、image_base64、face_id四选一图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 与image_url、image_base64、face_id四选一本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 image_base64 String 与image_file、image_url、face_id四选一图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 face_id String 与image_file、image_base64、image_url四选一导入人脸时，系统返回的人脸编号，即人脸ID。 top_n Integer 否返回查询到的最相似的N张人脸，N默认为10，取值范围[0,1000]。 N张人脸按照置信度降序排序，置信度越大越靠前。 threshold Double 否人脸相似度阈值，低于这个阈值则不返回，取值范围[0,1]，一般情况下建议取值0.93，默认为0。 sort JsonArray 否支持字段排序，参考sort语法。 filter String 否过滤条件，参考filter语法。 return_fields JsonArray 否指定返回的自定义字段。

人脸识别服务 FRS

人脸识别服务 FRS-人脸搜索:功能介绍

功能介绍人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。如果图片中包含多个人脸，选取图片中检测到的最大尺寸人脸作为检索的输入。支持传入图片或者faceID进行人脸搜索。前提条件：请确保您已开通人脸识别服务，具体操作方法请参见申请服务。约束限制：只支持识别JPG、PNG、JPEG、BMP格式的图片。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。系统不保存用户图片。图片大小小于8MB，由于过大图片会导致时延较长，并且图片信息量不大，建议小于1MB。图片分辨率小于4096*4096，图片中人脸像素大于80*80，建议120*120以上。为保证识别效果，人脸图片建议要求如下：光照大于200lux、无反光强光阴影现象。人脸无遮挡、整体清晰无拖尾抖动等运动模糊。侧脸不超过30°、俯仰角小于15°、偏转角小于15°、图片中人脸保持竖置正脸。其他的约束限制信息请参见约束与限制章节。建议：由于过大图片对识别算法精度无明显提升，同时会导致时延较长，建议传入图片小于1MB，一般500KB左右足够。 OBS上存储的图片也建议小于1MB。图片中人脸像素建议120*120以上。

人脸识别服务 FRS

人脸识别服务 FRS-删除人脸库:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账，当前仅支持按需计费模式。获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。说明：创建企业项目后，在传参时，有以下三类场景。携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。

人脸识别服务 FRS

人脸识别服务 FRS-人脸检测:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。用于获取操作API的权限。获取方法请参见认证鉴权。 Content-Type 是 String 发送的实体的MIME类型，参数值为“application/json”。 Enterprise-Project-Id 否 String 企业项目ID。FRS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账，当前仅支持按需计费模式。获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。说明：创建企业项目后，在传参时，有以下三类场景。携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。表3 请求Body参数参数名是否必选参数类型说明 image_url 与image_file、image_base64三选一 String 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下，可在OBS控制台获取。 https://BucketName.obs.xxxx.com/ObjectName image_file 与image_url、image_base64三选一 File 本地图片文件，要求：图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。 image_base64 与image_file、image_url三选一 String 图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。图片为JPG/JPEG/BMP/PNG格式。 attributes 否 String 是否返回人脸属性，希望获取的属性列表，多个属性间使用逗号（,）隔开。目前支持的属性有： 2：年龄 4：装束（帽子、眼镜） 6：口罩 7：发型 8：胡须 11：图片类型 12：质量 13：表情 21：人脸图片旋转角（顺时针偏转角度），支持0°、90°、180°和270°图片旋转。

人脸识别服务 FRS

人脸识别服务 FRS-人脸检测:响应参数

响应参数状态码：200 表4 响应Body参数参数参数类型描述 faces Array of DetectFace objects 检测到的人脸。调用失败时无此字段。表5 DetectFace 参数参数类型描述 bounding_box BoundingBox object 人脸在图像中的位置。 attributes Attributes object 人脸关键属性，比如头部姿态。表6 BoundingBox 参数参数类型描述 width Integer 人脸图像所在矩形框的宽度。 top_left_y Integer 矩形框左上角纵坐标。 top_left_x Integer 矩形框左上角横坐标。 height Integer 人脸图像所在矩形框的高度。表7 Attributes 参数参数类型描述 dress Dress object 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 dark：戴墨镜 none：未戴眼镜 unknown：未知 hat String 是否戴帽子： yes：戴帽子 none：未戴帽子 unknown：未知 age Integer 年龄。 mask String 是否戴口罩： yes：戴口罩 none：未戴口罩 unknown：未知 beard String 胡须： yes：有胡须 none：无胡须 unknown：未知 phototype String 图片类型： idcard：证件照 monitor：摄像头监控 internet photo：网络图片 quality FaceQuality object 图片中人脸的遮挡度、模糊度、光照强度、姿态角度。 hair String 发型： long：长发 short：短发 unknown：未知 expression expression object 人脸表情，包括中性、高兴、害怕、惊讶、伤心、生气、厌恶。 face_angle Integer 人脸图片旋转角（顺时针偏转角度），支持0°、90°、180°和270°图片旋转。表8 Dress 参数参数类型描述 glass String 是否戴眼镜： yes：戴眼镜 dark：戴墨镜 none：未戴眼镜 unknown：未知 hat String 是否戴帽子： yes：戴帽子 none：未戴帽子 unknown：未知表9 FaceQuality 参数参数类型描述推荐值 total_score Double 人脸质量总分，取值范围[0-1]，分值越大质量越高。大于0.45 blur Double 模糊度，取值范围[0-1]，分值越大模糊问题越严重。小于0.3 pose Double 姿态，取值范围[0-1]，分值越大姿态问题越严重。小于0.3 occlusion Double 遮挡，取值范围[0-1]，分值越大遮挡问题越严重。小于0.3 illumination Double 光照，取值范围[0-1]，分值越大光照问题越严重。小于0.3 表10 expression 参数参数类型描述 type String 人脸表情类型： neutral：中性 happy：高兴 fear：害怕 surprise：惊讶 sad：伤心 angry：生气 disgust：厌恶 unknown：图片质量问题导致未识别 probability Double 表情置信度，取值范围[0-1]。状态码： 400 表11 响应Body参数参数参数类型描述 error_code String 调用失败时的错误码，具体请参考错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

人脸识别服务 FRS

人脸识别服务 FRS-filter语法:数值类型

数值类型数值类型的范围查询，[]包含两端点值，{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "number:[1 TO *]"} 单值。 rowkey:1 值为1 Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "number:10"} 多条件，使用()区分优先级。 rowkey:[1 TO *] && externalImageID:1 (rowkey:[1 TO *] && externalImageID:1) || timestamp:1000 rowkey:[1 TO *] && (externalImageID:1 || timestamp:1000) Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "number:[1 TO 20] && external_image_id:test"} 非，需要在非语句前后加括号。 externalImageID:1 && (!rowkey:2) Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "external_image_id:test && (!number:10)"}

人脸识别服务 FRS

人脸识别服务 FRS-filter语法:字符串类型

字符串类型单值 title:quick Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "id:zhangsan"} 多条件 title:quick && color:brown Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "id:zhangsan && number:30"} 非，使用括号分隔 (!color:brown) Request Body示例： { "image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD...", "filter" : "(!id:zhangsan)"}

人脸识别服务 FRS

人脸识别服务 FRS-FaceSetInfo:参数说明

参数说明表1 结构格式说明表名称类型说明 face_set_name String 人脸库名称。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 create_date String 创建时间。 face_set_capacity Integer 人脸库最大的容量。 face_number Integer 人脸库当中的人脸数量。 external_fields Json 用户的自定义字段。

人脸识别服务 FRS

人脸识别服务 FRS-SearchFace:参数说明

参数说明表1 结构格式说明表名称类型说明 bounding_box BoundingBox object 人脸在图像中的位置。 BoundingBox结构见BoundingBox。 face_id String 人脸ID，由系统内部生成的唯一ID。 external_image_id String 人脸所在的外部图片ID。 similarity Double 人脸搜索时用于被检索的相似度。 external_fields Json 用户添加的额外自定义字段。

人脸识别服务 FRS

人脸识别服务 FRS-API概览

API概览人脸识别服务所提供的API，均符合RESTful API设计规范，如表1所示。表1 人脸识别API 类型 API 说明人脸检测人脸检测人脸检测是对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。人脸比对人脸比对人脸比对是将两个人脸进行比对，来判断是否为同一个人，返回比对置信度。如果传入的图片中包含多个人脸，选取最大的人脸进行比对。活体检测动作活体检测通过判断视频中的人物动作与传入动作列表是否一致来识别视频中人物是否为活体。如果有多张人脸出现，则选取最大的人脸进行判定。静默活体检测基于人脸图片中可能存在的畸变、摩尔纹、反光、倒影、边框等信息，判断图片中的人脸是否来自于真人活体，有效抵御纸质翻拍照、电子翻拍照以及视频翻拍等各种攻击方式。静默活体检测支持单张图片，不支持多人脸图片。人脸搜索人脸搜索人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸，并返回相应的置信度。人脸库资源管理创建人脸库创建用于存储人脸特征的人脸库。您最多可以创建10个人脸库，每个人脸库最大容量为10万个人脸特征。如有更大规格的需求请联系客服。查询所有人脸库查询当前用户所有人脸库的状态信息。查询人脸库查询人脸库当前的状态。删除人脸库删除人脸库以及其中所有的人脸。人脸库数据为用户隐私数据，该数据无备份，删除时请谨慎操作。人脸资源管理添加人脸添加人脸到人脸库中，检测到传入的单张图片中存在多少张人脸，则增加多少张人脸到人脸库当中。查询人脸查询指定人脸库中人脸信息。更新人脸根据人脸ID（face_id）更新单张人脸信息。删除人脸根据指定字段删除人脸库中人脸。批量删除人脸自定义筛选条件，批量删除人脸库中的符合指定条件的多张人脸。

人脸识别服务 FRS

人脸识别服务 FRS-Attributes:参数说明

参数说明表1 结构格式说明表名称类型说明 age Integer 年龄。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 none：未戴眼镜 unknown：未知 hat String 是否戴帽子： yes：戴帽子 none：未戴帽子 unknown：未知 mask String 是否戴口罩： yes：戴口罩 none：未戴口罩 unknown：未知 hair String 发型： long：长发 short：短发 unknown：未知 beard String 胡须： yes：有胡须 none：无胡须 unknown：未知 phototype String 图片类型： idcard：证件照 monitor：摄像头监控 internet photo：网络图片 smile String 笑脸。 quality FaceQuality 图片中人脸的遮挡度、模糊度、光照强度、姿态角度。 expression FaceExpression 人脸表情，包括中性、高兴、害怕、惊讶、伤心、生气、厌恶。 face_angle Integer 人脸图片旋转角（顺时针偏转角度），支持0°、90°、180°和270°图片旋转。 dress List of strings 包含glass和hat两个属性结果。 glass String 是否戴眼镜： yes：戴眼镜 dark：戴墨镜 none：未戴眼镜 unknown：未知 hat String 是否戴帽子： yes：戴帽子 none：未戴帽子 unknown：未知 headpose List of doubles 人脸轮廓坐标值。 pitch_angle Double 围绕X轴旋转，俯仰角，范围[-180,180]。 roll_angle Double 围绕Z轴旋转，翻滚角，范围[-180,180]。 yaw_angle Double 围绕Y轴旋转，偏航角，范围[-180,180]。

人脸识别服务 FRS

人脸识别服务 FRS-认证鉴权:AK/SK认证

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 AK/SK获取方式请参考获取AK/SK。

人脸识别服务 FRS

云服务器内容精选

人脸识别服务 FRS

7*24

备案

专业服务

退订

建议反馈

售前咨询热线