检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK 本章节介绍人脸识别服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
统计API使用量 FRS控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“云上服务管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
400 表7 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。 请求示例 X-Auth-Token值获取方法请参见快速入门。
URL格式如下，可在OBS控制台获取。 https://BucketName.obs.xxxx.com/ObjectName image_file 与image_url、image_base64三选一 File 本地图片文件，要求： 图片不能超过8MB，建议小于1MB。 上传文件时，请求格式为multipart。
Go SDK 本章节介绍人脸识别服务Go SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人脸识别服务。如未开通，请登录人脸识别管理控制台人脸识别管理控制台开通所需服务。 已具备开发环境，Go SDK
调用API操作APIG.0301怎么办 问题现象 在调用人脸识别接口时，报错“APIG.0301”。 该报错显示认证鉴权失败，Token或AK/SK填写错误导致该报错。 解决方法 调用接口时有两种认证方式。Token认证或AK/SK认证。请参考认证鉴权，获取正确的Token或AK
图1 查看项目ID 调用API获取项目ID 项目ID还可以通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。选中“Hea
程中Token过期导致调用API失败。 重新获取Token，不影响已有Token有效性。如果在Token有效期内进行如下操作，当前Token将立即失效： 删除/停用IAM用户。 修改IAM用户密码、访问密钥。 IAM用户权限发生变化（如账号欠费无法访问云服务、申请公测通过、IAM用户权限被修改等）。
SDK在本地进行开发。 该接口可以对输入图片进行人脸检测和分析，输出人脸在图像中的位置、人脸关键属性。 前提条件 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费、冻结、被注销等异常状态。 已开通人脸检测。 操作步骤 获取并安装FRS Python SDK。 以PyCharm为例，介绍如何安装SDK。
过分享的链接地址可访问对象数据。 前提条件 已经设置匿名用户对该对象的读取权限。 权限开启方法请参见对匿名用户授予指定对象的公共读权限。 不能对已加密的对象进行共享。 操作步骤 在OBS管理控制台左侧导航栏选择“桶列表”。 在桶列表单击待操作的桶，进入“概览”页面。 在左侧导航栏，单击“对象”。
权限类 使用FRS服务需要的权限 FRS是否支持IAM细粒度划分 因权限造成的调用API失败
用详见“保留期”。保留期满仍未续订或充值，数据将被删除且无法恢复。 欠费说明 您的账号欠费后，会导致部分操作受限，建议您尽快续费。具体受限操作如下所示： 开通服务 购买按需套餐包 购买QPS套餐包 按需计费模式的API无法调用 为了避免影响业务正常使用，请您在收到欠费通知后，及时前往华为云控制台费用中心进行充值。
测量对象 成功调用次数 该指标用于统计API的成功调用次数。 单位：次（times）。 ≥ 0 times 人脸识别 失败调用次数 该指标用于统计状态码为5xx的调用API失败的次数。 单位：次（times）。 ≥ 0 times 人脸识别 平均时延 该指标用于统计API的平均时延。 单位：毫秒（ms）。
调用说明 人脸识别服务提供了RESTful API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 同时人脸识别服务还提供多种编程语言的SDK供您使用。 父主题： 使用前必读
SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK 步骤3：获取示例代码 步骤4：调用服务 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 步骤1：开通服务 登录人脸识别服务控制台。 控制台左上角默认显示服务部署在“华北-北京四”区域，请您根据业务需要选择
FRS.0304 未检测到人脸，无法搜索。 请参考约束与限制章节，上传符合规范的人脸图片。 400 FRS.0305 超过最大的人脸库数量，无法创建新的人脸库。 请检查人脸库数量是否超出限制联系客服提供支持。 403 FRS.0306 超过人脸库容量限制，无法增加更多的人脸。 请新增人脸库，重新添加人脸到新的人脸库中。
face_id，create_time，vector，_id，_all，_source为内置字段，自定义字段避免使用。 自定义字段总个数不能超过10个，key的长度范围为[1,36]，可以由数字、字母、下划线和中划线组成。 String类型的value长度范围为[1,256]，可以由数字、字母、下划线和中划线组成。
检查Token是否填写正确或者已过期。 检查API调用方法是否正确。 参考视频指导 您可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 父主题： 错误码类
用户登录并验证权限 使用新创建的IAM账户登录FRS控制台，切换至授权区域，进行验证权限。 进入FRS控制台界面，单击“开通服务”，如果无法开通，提示权限不足（假设主账户只为子用户开通了FRS ReadOnlyAccess只读权限），表示“FRS ReadOnlyAccess”已生效。
构造请求 本节介绍REST API请求的组成，并以调用人脸检测为例说明如何调用API，您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成。 {URI-scheme}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
