检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。 图2 我的凭证 安装SDK 使用SDK前需要安装华为云Go SDK 库。 # 安装华为云Go库 go get -u github.com/huaweicloud/huaweicloud-sdk-go-v3 #
Python SDK 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
人脸搜索是指在已有的人脸库中，查询与目标人脸相似的一张或者多张人脸。在使用人脸搜索时，需创建人脸库（使用人脸库，也以开通人脸搜索服务为前提）。人脸库创建在华为云对象存储服务（OBS）中，您可以参考API文档“人脸库资源管理”和“人脸资源管理”相关章节，对人脸库和人脸资源进行管理。 开通人脸识别服务是否需要授权
示： 开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。 欠费案例 欠费原因常见于以下场景： 主账号未开通人脸识别服务，但由于子账号具备开通权限，子账号自行开通服务并调用人脸识别服务接口产生扣费。
sword为用户密码。 获取Token时，如果出现账密报错“The username or password is wrong.”，请参见如何处理账密报错。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type:
N格式的识别结果，用户需要通过编码将识别结果对接到业务系统。 关于人脸识别的相关声明请参见人脸识别服务声明。 人脸识别服务等级协议请参见华为云服务等级协议。
ON格式，用户需要通过编程来处理识别结果。使用前，请登录人脸识别服务控制台开通服务。 您可以根据以下方式的介绍选择合适的使用方式： 通过华为云API Explorer在线调用FRS服务API。 如果您是开发初学者，有代码编写基础，对HTTP请求与API调用有一定的了解，想快速体验
只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。
只支持识别JPG、PNG、JPEG、BMP格式的图片。 每个用户可免费使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模与价格。 application/json请求的body中，请使用标准Json格式。 Base64编码中请勿使用回车换行。
如何关闭已申请的服务 FRS服务开通后可以在控制台进行关闭。 您申请的FRS服务默认是按需收费，在不调用服务的时候不会产生扣费。 父主题： 产品咨询类
如何处理未经授权的情况 提交OBS的数据到人脸识别服务进行识别，返回未经授权：The OBS is unauthorized时，您可以通过如下步骤处理： 使用OBS中的数据时，需要授权人脸识别服务能读取OBS数据，检查是否已在人脸识别服务的管理控制台单击过“委托授权”： 如果已经授权，界面将显示为“已授权”。
如何获取图片的base64编码 本节以Python为例，介绍如何将本地图片，转换为base64编码。您也可以使用在线的图片转base64工具。 使用时，需要将代码的d:\demo.jpg替换为实际图片路径。 import base64 with open("d:\demo.jpg"
计费规则：按调用次数计费，按月累计，一个自然月后调用次数清零重新累计。 每个用户可免费使用10个人脸库，每个人脸库容量为10万个人脸特征。如需扩容单个人脸库规模，请联系华为云客服确认扩容规模。 默认并发：动作活体检测1QPS、其它接口10QPS。超出默认并发，会提示FRS.0033，当前请求太多，超出流控限制。
如何获取正确的终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。 人脸识别服务的终端节点如表1所示，请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点（Endpoint） 协议类型
人脸搜索接口中关于top_n参数如何设置 请求该接口不传“top_n”参数时，默认返回查询到最相似的10张人脸，“top_n”允许设置最大值是1000。 父主题： API使用类
如何获取OBS桶内最近图片的地址URL 将对象权限设置为匿名用户读取权限，通过分享对象URL，匿名用户通过分享的链接地址可访问对象数据。 前提条件 已经设置匿名用户对该对象的读取权限。 权限开启方法请参见对匿名用户授予指定对象的公共读权限。 不能对已加密的对象进行共享。 操作步骤
是否必选 说明 image1_url String 与image1_file、image1_base64三选一 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 OBS URL格式如下，可在OBS控制台获取。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
检查访问密钥AK/SK是否获取成功。 检查Token是否填写正确或者已过期。 检查API调用方法是否正确。 参考视频指导 您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 父主题： 错误码类
是否必选 参数类型 说明 image_url 与image_file、image_base64三选一 String 图片的URL路径，目前仅支持华为云上OBS的URL，使用时只需保证FRS有权限读取该OBS桶的数据。开通读取权限的操作请参见申请服务。 image_file 与image_url、image_base64三选一
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
