检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint)
如何获取正确的终端节点(Endpoint) 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。 表1 人脸识别服务终端节点 区域名称 区域 终端节点(Endpoint) 协议类型
base64编码 使用本地图片文件时,请检查文件是否为图片,且图片类型满足约束。 使用图片URL地址时,请检查URL是否为OBS地址,且地址为图片文件的路径。 400 FRS.0016 上传的文件格式不支持。 请参考约束与限制章节,上传支持识别的文件格式。 400 FRS.0017
下载人脸识别服务Postman配置文件。 下载地址:FRS-API.postman_collection.json。 导入配置文件。 打开并登录Postman。 单击左上角“File > Import > Import File > Choose Files”导入配置文件。 图1 导入配置文件 配置文件
人脸识别API的请求Body参数中输入数据支持图片的Base64编码、图片文件和图片URL路径,本示例中使用图片文件。 在Postman左侧导航栏中单击“03 face-detect by file”配置文件。 登录我的凭证,获取“华北-北京四”区域的项目ID,替换配置文件URL中的{{project_id}}。
https://iam.myhuaweicloud.com 调用服务对应终端节点下的项目ID没有生成。 在“我的凭证”页面中查看对应终端节点的项目ID,确认系统中没有生成。在FRS控制台将终端节点切换至调用服务所在的终端节点,之后前往“我的凭证”页面,即可查看到已生成对应的项目ID。 json解析报错
获取项目ID的接口为“GET https://{Endpoint}/v3/projects”,其中{Endpoint}为IAM的终端节点,可以从地区和终端节点获取。选中“Headers”配置项,添加“KEY”为“X-Auth-Token”,“VALUE”为获取的Token值,详细的接口认证鉴权请参见认证鉴权。
如果您的应用要求实例之间的网络延时较低,则建议您将资源创建在同一可用区内。 区域和终端节点 当您通过API使用资源时,您必须指定其区域终端节点。有关区域和终端节点的更多信息,请参阅人脸识别服务的地区和终端节点。 父主题: 区域与可用区
HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的
projectId:华为云项目ID,获取方法请参见准备工作。 endpoint:华为云各服务应用区域和各服务的终端节点,详情请查看 地区和终端节点 。 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全。 本示例以 ak 和 sk 保存
通过OBS方式传入图片报错FRS.0022怎么办 问题原因 OBS路径错误。 OBS桶并不是当前用户的桶。 注册服务时,没有将OBS权限授予FRS服务。 解决方案 图片的路径按照“/bucket/image-path”格式,不需要带上域名。 人脸服务只能访问当前账号的OBS桶。
.build(); endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用人脸检测接口 DetectFaceByBase64 为例 const request
image_url String 图片的URL路径,目前仅支持华为云上OBS的URL,且人脸识别服务有权限读取该OBS桶的数据。开通读取权限的操作请参见服务授权。 image_file File 本地图片文件,图片不能超过8MB,建议小于1MB。上传文件时,请求格式为multipart。 image_base64
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 约束限制: 目前支持检测视频文件,或视频的Base64编码,不支持直接检测视频流,需要用户客户端自己获取视频流并保存成文件,然后调用活体检测接口。 视频文件大小不超过8MB,建议客户端压缩到200KB~2MB。 applicatio
使用FRS API或SDK时,数据主要通过以下三种方法传入。 image_url 传入图片的OBS桶路径。图片上传至OBS服务后,生成的图片路径。 image_file 传入本地文件。 image_base64 传入图片的base64编码数据。
URL、Header、Body,进行具体的API调用。 Request URL 格式为:https://IAM地区与终端节点地址/API接口URI 访问网址:地区与终端节点,获取IAM区域与终端节点地址。 图1 IAM区域与终端节点 访问网址:获取用户Token,获取API接口的URI。 以cn-north-1为例,则Request
码示例调试功能。 URI PUT /v2/{project_id}/face-sets/{face_set_name}/faces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参见获取项目ID/账号名/AK/SK。 face_set_name
WithHttpConfig(config) .Build(); endpoint是华为云各服务应用区域和各服务的终端节点,详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用人脸检测接口 DetectFaceByBase64 为例 var req = new
https://{endpoint}/v1/{project_id}/subscribe 将请求样例中的“{endpoint}”进行替换。人脸识别服务的请求地请参考终端节点终端节点章节进行获取。 例如,如果您的服务部署在华北-北京四区域,则该区域的endpoint为“face.cn-north-4.myhuaweicloud