检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
newBuilder() 网络代理（可选） // 使用代理服务器（可选） client.withProxyAgent("http://username:password@proxy.huaweicloud.com:8080") SSL配置（可选） // 配置跳过服务端证书验证（可选） process.env
开通服务 开通服务 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 图1 开通FRS服务 【可选】进行OBS委托授权。 调用API进行人脸的比对、检测时，可以从本地、obs、图片base64编码中读取数据。仅当您
配置文件导入成功后，将显示在Postman左侧导航栏中。 图2 配置文件 本配置文件中服务所属区域为“华北-北京四”，如果您在开通服务时，选择了其他区域，在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域，服务部署的区域具体请参见终端节点。 在Postman左侧导航栏中单击“get-token”配置文件。
Go SDK 本章节介绍人脸识别服务Go SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，Go SDK
的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 部署的服务 华北-北京四 cn-north-4
申请服务 在使用服务之前，您需要先登录人脸识别管理控制台开通服务，服务开通一次即可，后续使用时无需再开通。 在使用人脸识别服务时需要对OBS的数据进行操作，因此需要先同意服务授权：在开通服务界面，单击右上角“服务授权”，完成OBS授权操作。 获取请求认证 调用人脸识别的API有
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万
关闭服务 FRS服务开通后，如不使用，可登录控制台进行关闭。 如果您是主账户，也可以控制子用户的服务开通、关闭状态。 图1 关闭服务 图2 控制子用户的开通、关闭
AK/SK。 image_url String 图片的URL路径，目前仅支持华为云上OBS的URL，且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件，图片不能超过8MB，建议小于1MB。上传文件时，请求格式为multipart。
K（该SDK支持Python3及以上版本）。 # 安装核心库 pip install huaweicloudsdkcore # 安装FRS服务库 pip install huaweicloudsdkfrs 检查SDK是否已正确安装。 在PyCharm中选择“File > Settings
终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型 部署的服务 华北-北京四 cn-north-4 face
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。
约束与限制 受技术与成本多种因素制约，人脸识别服务存在一些约束限制。其中系统级约束限制，是所有子服务的约束。除系统级约束限制外，各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为1
与其他云服务的关系 统一身份认证服务 人脸识别使用统一身份认证（Identity and Access Management，简称IAM）服务实现认证和鉴权功能。 对象存储服务 人脸识别支持从对象存储服务（Object Storage Service，简称OBS）读取人脸图片。 云审计服务
申请服务 在调用API之前，必须先申请开通服务，下面是申请服务的相关步骤。 申请服务前，必须先注册云账号，并完成实名认证。 申请步骤 登录人脸识别管理控制台。 根据业务需求，选择服务部署区域，开通所需服务（例如：人脸检测），单击右侧的“开通服务”。 香港、曼谷区域API也可以使用
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。
创建企业项目后，在传参时，有以下三类场景。 携带正确的ID，正常使用FRS服务，账单归到企业ID对应的企业项目中。 携带错误的ID，正常使用FRS服务，账单的企业项目会被分类为“未归集”。 不携带ID，正常使用FRS服务，账单的企业项目会被分类为“default”。 表3 请求Body参数
如下图所示，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。获取Token之后，您就可以使用Token认证调用FRS服务API。 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333
共有三种方式可以基于已构建好的请求消息发起请求。 cURL cURL是一个命令行工具，用来执行各种URL操作和信息传输。cURL充当的是HTTP客户端，可以发送HTTP请求给服务端，并接收响应消息。cURL适用于接口调试。 编码 通过编码调用接口，组装请求消息，并发送处理请求消息。 REST客户端 Mozilla、
携带正确的ID，正常使用FRS服务，账单的企业项目会被分类到企业ID对应的企业项目中。 携带格式正确但不存在的ID，正常使用FRS服务，账单的企业项目会显示对应不存在的企业项目ID。 不携带ID或格式错误ID（包含特殊字符等），正常使用FRS服务，账单的企业项目会被分类到"default"中。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
