检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本章节介绍人脸识别服务Python SDK,您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通,请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境,支持Python3及以上版本。
B,一般500KB左右足够。 OBS上存储的图片也建议小于1MB。 图片中人脸像素建议120*120以上。 数据传入方式 使用FRS API或SDK时,数据主要通过以下三种方法传入。 image_url 传入图片的OBS桶路径。图片上传至OBS服务后,生成的图片路径。 image_file
FRS.0021 无效OBS的url。 请参考请求样例,检查OBS的url是否正确。 400 FRS.0023 OBS上的文件大小超出范围。 请参考约束与限制章节,检查OBS中文件的大小是否符合接口要求 400 FRS.0024 OBS上的文件不存在。 请检查OBS上的文件是否存在。
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时,集成开发环境CloudIDE,可完成代码的构建、调试、运行。 本章节以人脸检测为例,介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云,并完成实名认证,
本地调用 本章节以人脸检测为例,介绍如何使用FRS Python SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析,输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。
在使用服务之前,您需要先登录人脸识别管理控制台开通服务,服务开通一次即可,后续使用时无需再开通。 在使用人脸识别服务时需要对OBS的数据进行操作,因此需要先同意服务授权:在开通服务界面,单击右上角“服务授权”,完成OBS授权操作。 获取请求认证 调用人脸识别的API有如下两种认证方式,请任选其中一种进行认证鉴权,鉴权详情请参见《认证鉴权》。
项目ID,获取方法请参见获取项目ID/账号名/AK/SK。 image_url String 图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件,图片不能超过8MB,建议
创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用FRS服务,账单归到企业ID对应的企业项目中。 携带错误的ID,正常使用FRS服务,账单的企业项目会被分类为“未归集”。 不携带ID,正常使用FRS服务,账单的企业项目会被分类为“default”。 表3 请求Body参数
三选一 图片的URL路径,目前仅支持华为云上OBS的URL,使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下,可在OBS控制台获取。 https://BucketName.obs.xxxx.com/ObjectName image1_file
携带正确的ID,正常使用FRS服务,账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID,正常使用FRS服务,账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID(包含特殊字符等),正常使用FRS服务,账单的企业项目会被分类到"default"中。
请求调用人脸识别服务API。 如果您是开发工程师,熟悉代码编写,熟悉HTTP请求与API调用,您可以通过postman调用、调试API。使用方法请参见调用API实现人脸检测。 通过软件开发工具包(SDK)调用FRS服务API。 如果您是开发工程师,熟悉代码编写,FRS服务为您提供SDK,方便您快速集成。
计费说明 计费说明 到期与欠费
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
调用API或SDK 在线调试 本地调用
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题: API
消息对象结构 AllParam DetectFace Landmark Attributes FaceQuality FaceExpression FaceSetFace SearchFace FaceSetInfo BoundingBox VideoDetectResult LivelessDetectResult
String 图片的URL路径,目前仅支持华为云上OBS的URL,使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下,可在OBS控制台获取。 https://BucketName.obs.xxxx.com/ObjectName image_file
获取项目ID/账号名/AK/SK 获取项目ID/账号名 获取账号ID 获取AK/SK 父主题: 附录
创建企业项目后,在传参时,有以下三类场景。 携带正确的ID,正常使用FRS服务,账单归到企业ID对应的企业项目中。 携带错误的ID,正常使用FRS服务,账单的企业项目会被分类为“未归集”。 不携带ID,正常使用FRS服务,账单的企业项目会被分类为“default”。 表3 请求Body参数