faceSearch:人脸搜索
功能详情
传入一张人脸图片,系统在人脸库中进行搜索,并给出相似度最高的人脸信息。
请求地址
https://openapi.lechange.cn/openapi/faceSearch
传入参数说明
参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 | |
---|---|---|---|---|---|---|
token | String | 是 | 开发者在账号对接模块获取的Token | |||
faceToken | String | 是 | 通过人脸检测接口返回 | 人脸图片唯一标示 | ||
operation | repositoryToken | String | 是 | 通过人脸库创建接口返回 | 人脸库唯一标识 | |
threshold | Double | 是 | [0,1] | 识别阈值 | ||
matchType | String | 是 | 0:全库搜索,1:识别一次即终止搜索 | 匹配类型 | ||
topNum | Integer | 否 | 当matchTyp为0时有效且必传,取值范围为[1,5] | 最相似人脸的个数 |
样例输入
{
"system":{
"ver":"1.0",
"appId":"lcd08b4b07ce224508",
"sign":"b7e5bbcc6cc07941725d9ad318883d8e",
"time":1599013514,
"nonce":"fbf19fc6-17a1-4f73-a967-75eadbc805a2"
},
"id":"98a7a257-c4e4-4db3-a2d3-d97a3836b87c",
"params":{
"token":"At_12345678901234567890123456789012",
"faceToken":"c3aks9du8s3as90iydx8lg6j",
"operation":{
"repositoryToken":"a3esa78x3cc6cc05d9ad318883d8e",
"threshold":0.75,
"matchType":"1",
"topNum":1
}
}
}
返回data字段说明
字段名 | 字段类型 | 字段说明 | |
---|---|---|---|
results | faceToken | String | 人脸图片唯一标示 |
url | String | 与之相似的图片url | |
score | Double | 匹配得分, 取值范围为[0,100] |
样例输出
{
"result":{
"msg":"操作成功。",
"code":"0",
"data":{
"results": [
{
"faceToken": "a3esa78x3cc6cc05d9ad318883d8e",
"url": "https://www.google.com/face.jpg",
"score": 99.99
}
]
}
},
"id":"98a7a257-c4e4-4db3-a2d3-d97a3836b87c"
}