找不到 API ? 点击 反馈吧
- 人脸搜索
- 人脸
- 人体
- 实人认证
- 其他识别
- 其它
SearchFace
人脸搜索SearchFace的语法及示例
服务地址:
华东2(上海)
参数配置
高级配置
输入参数
只看必填
注意事项
DbName数据库名称
ImageUrl图像URL地址
Limit单个人脸列表中搜索人脸结果数量限制
DbNames数据库名称列表
QualityScoreThreshold质量分阈值
MaxFaceNum对输入图像中多少个人脸进行检索比对
文档
调用结果
SDK 示例
CLI示例
相关示例 (1)
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
功能描述
人脸搜索能力可以根据输入图片,在数据库中搜索并返回相似的人脸图片数据。单次搜索最多可支持 10 个人脸数据库的同时搜索(跨库搜索)。该能力根据人脸特征来进行识别,通过把人脸图像特征化,然后比较人脸特征的相似程度。
说明
您可以进入在线咨询获取在线人工帮助。
- 当前能力可在视觉智能开放平台有完整的免费产品体验,您可以单击立即试用对该能力进行更直观试用以及在线购买。
- 阿里云视觉智能开放平台视觉 AI 能力 API 接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
特色优势
- 识别精度高:人脸检测识别等算法精度处于业内领先水平。
- 识别效率高:毫秒级响应,支持实时识别。
接入指引
注意
本能力支持企业或个人认证用户开通。更多实名认证操作信息,请参见实名认证。
如果您是已经在使用的老客户,需要使用海量人脸建库和搜索的能力,请通过钉钉群(23109592)联系我们。
- 创建 AccessKey:请确保您已创建 AccessKey,如果您使用的是子账号 AccessKey,您需要给子账号赋予 AliyunVIAPIFullAccess 权限,具体操作,请参见 RAM 授权。
- 前提条件:
- 已通过创建人脸数据库(CreateFaceDb)接口创建了数据库名称(DbName)。
- 已通过添加人脸样本(AddFaceEntity)接口创建了实体 ID(EntityId)。
- 已通过添加人脸数据(AddFace)接口给数据库(DbName)下的实体 ID(EntityId)添加了人脸图片。
- 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及 SDK 依赖信息,也可以下载完整的工程。
- 开发接入步骤:
- 在 SDK 总览中选择您要接入使用的 SDK 语言。
- 在对应语言的 SDK 文档中找到 AI 类目为人脸人体(facebody)的 SDK 包进行安装。
- 参考文档中提供的示例代码进行适当修改后调用。
-
示例代码:该能力常用语言的示例代码,请参见人脸搜索示例代码。
-
客户端直接调用:该能力常用的客户端调用方式包括以下几种。
输入限制
- 图像格式:JPG、JPEG、PNG。
- 图像大小:不超过 5 MB。
- 图像分辨率:大于 32×32 像素,小于 4096×4096 像素。人脸占比不低于 64×64 像素。
- URL 地址中不能包含中文字符。
- 支持图片中包含最多 10 个人脸,超过部分会被忽略。
说明
当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放。
计费说明
关于人脸搜索 1:N 的计费方式及报价,请参见计费介绍。人脸搜索 1:N 能力中仅本接口(SearchFace)收费,其他接口可免费调用。
说明
下方调试接口为付费接口,如需免费体验调试请前往体验中心。
请求参数
字段名称 | 字段详情 |
---|---|
DbNamestring | 数据库名称。展开详情 示例值:default |
ImageUrlstring | 图像 URL 地址。推荐使用上海地域的 OSS 链接,对于文件在本地或者非上海地域 OSS 链接的情况,请参见文件 URL 处理。 示例值:http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/SearchFace/SearchFace1.png |
Limitinteger<int32> | 单个人脸列表中搜索人脸结果数量限制,取值范围 1~100。 示例值:2正则:^\d+$取值 <= 1000 |
DbNamesstring | 数据库名称列表,以英文逗号(,)分割,可以实现跨库查询,最大支持 10 个数据库。展开详情 示例值:test1,test2,test3字符长度 <= 4096 |
QualityScoreThresholdnumber<float> | 质量分阈值。对人脸图片进行质量分析判断,得到的质量分小于该阈值则表示人脸图片质量不符合要求,比对失败。取值范围[0.0,100.0]。0.0 或空则表示不做质量分判断逻辑。 示例值:50.0 |
MaxFaceNuminteger<int64> | 对输入图像中多少个人脸进行检索比对,控制人脸样本列表个数,取值范围 1~10,默认为 5。 注意
该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。 示例值:5 |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID。 示例值:4159e64a-0fe8-436c-a8de-ee531555db3c |
Dataobject | 返回的结果数据内容。 |
返回说明
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2021-03-02 | 变更返回参数 |