应用场景 身份验证 使用人脸检测与比对功能,可进行身份核实,适用于机场、海关等人证合一验证场景。 图1 身份验证 电子考勤 人脸检测及比对功能适用于客户企业对员工进行电子考勤。 客流分析 客流分析对于商场具有重要价值。基于人脸识别、搜索技术,帮助客户精准营销。
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。
调用说明 人脸识别服务提供了RESTful API,支持您通过HTTPS请求调用,调用方法请参见如何调用API。 同时人脸识别服务还提供Java语言的SDK供您使用,SDK的使用方法请参见SDK参考。 父主题: 使用前必读
人脸资源管理 添加人脸 查询人脸 更新人脸 删除人脸 批量删除人脸 父主题: API
DELETE 请求服务器删除指定资源,如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候,PATCH可能会去创建一个新的资源。
入门指导 环境准备 开通人脸识别服务:登录人脸识别管理控制台,选择对应的子服务,单击右侧的“开通服务”。 服务开通一次即可,后续使用时无需再开通。 获取人脸识别服务的终端节点(Endpoint),请参见地区和终端节点。 获取并了解人脸识别API,请参见《人脸识别API参考》。
区域与可用区 什么是区域和可用区域
数据安全类 使用FRS服务,是否会保存用户数据
签名SDK只提供签名功能,与服务提供的SDK不同,使用时请注意。 AK/SK获取方式请参考获取AK/SK。 父主题: 如何调用API
request_id-timestamp-hostname(request_id在服务器端生成UUID, timestamp为当前时间戳,hostname为处理当前接口的服务器名称)。 默认值:无。 否 X-ratelimit 此字段携带总计流控请求数。 类型:整型。
sort语法 json array形式,排序只支持数值类型,字段重复定义会被覆盖。 例1:单个排序字段 "sort":[ { "location": "desc" } ] 例2:多个排序字段 "sort": [
授权后,用户就可以基于被授予的权限对云服务进行操作。 FRS部署时通过物理区域划分,为项目级服务。
计费说明 计费项 表1 计费项信息 计费项 计费说明 人脸识别接口调用次数 调用人脸识别的接口收费,提供按调用次数按需计费的方式。 计费模式 按需计费 按照API调用次数计费,按月累计,一个自然月后次数清零重新累计。 详细价格请联系客服获取。 人脸库资源管理下的接口均免费,人脸资源管理下除添加人脸与删除人脸外均免费
filter语法 数值类型 数值类型的范围查询,[]包含两端点值,{}不包含两端点值。 rowkey:[1 TO *] 大于等于1 rowkey:[* TO 1] 小于等于1 rowkey:[1 TO 10] 1到10 单值。 rowkey:1
人脸库资源管理 创建人脸库 查询所有人脸库 查询人脸库 删除人脸库 父主题: API
约束与限制 受技术与成本多种因素制约,人脸识别服务存在一些约束限制。其中系统级约束限制,是所有子服务的约束。除系统级约束限制外,各子服务还有独立的约束条件。 系统级约束限制 只支持识别JPG、PNG、JPEG、BMP格式的图片。
前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 URI GET /v2/{project_id}/face-sets/{face_set_name}/faces?
前提条件: 请确保您已开通人脸识别服务,具体操作方法请参见申请服务。 URI DELETE /v2/{project_id}/face-sets/{face_set_name}/faces?
从服务API的URL中获取。
终端节点 终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询所有服务的终端节点。 人脸识别服务的终端节点如表1所示,请您根据业务需要选择对应区域的终端节点。