各位亲爱的用户：
您好！为了给您提供更优质的售后服务，保障您在平台获得更多权益，需要您登录用户中心完成用户认证操作。完成用户认证后，您可在平台顺利购买数据。
若用户未完成用户认证操作，或将影响您的购买体验，望各位用户知悉。
售前咨询：400-623-0183
人脸搜索
标识：faceSearchV1
- 接口地址：
https://way.jd.com/JDAI/faceSearchV1
- 请求方式：
HTTPS GET POST
- 请求示例：
https://way.jd.com/JDAI/faceSearchV1?appkey=您申请的APPKEY
QUERY请求参数
- 公共请求参数
-
名称 类型 必填 示例值 描述 appkey String 是 1 您申请的appkey - 业务请求参数
-
名称 类型 必填 示例值 描述
POST请求参数
| 名称 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| body | String | 是 | { "imageBase64": "iVBORw0K...", "topN": 5, "groupId": "5de9ff3087887242172ce62d" } | 分组 Id，唯一标识；分组不存在时，将自动创建；希望返回前n张脸，每张脸相似度最高的结果；范围为 [1, 10]，默认为5；图像Base64编码值，去掉图片头"data:image/png;base64,"，imgBase64=iVBORw0K...（由于过长，不给出示例） |
返回参数
- 公共返回参数
-
名称 类型 示例值 描述 code string 10000 更多返回参数示例值请参看“错误参照码” charge boolean false 或 true false：不扣费 true：扣费 msg string 查询成功 更多返回参数示例值请参看“错误参照码” result object {...} 数据查询结果
返回示例值
{
"status": 0,
"charge": false,
"remain": 97,
"msg": "查询成功",
"result": {
"code" : 0,
"msg" : "Accept",
"processTimeInMs" : 552,
"timestamp" : 1576729150797,
"faceItems" : [
{
"blurScore" : 0.01,
"boundingBox" : {
"height" : 559.81,
"left" : 375.71,
"top" : 109.00,
"width" : 406.53
},
"isValidPosture" : true,
"posture" : {
"pitch" : -9.99,
"roll" : -1.56,
"yaw" : 13.43
}
},
{
"blurScore" : 0.00,
"boundingBox" : {
"height" : 554.01,
"left" : 849.03,
"top" : 98.94,
"width" : 392.19
},
"isValidPosture" : true,
"posture" : {
"pitch" : -10.72,
"roll" : 0.68,
"yaw" : -1.38
}
}
],
"faceMatches" : [
{
"createTime" : "1576808089949",
"customInfo" : "45464",
"faceId" : "5dfc2e998788724bae434395",
"groupId" : "5df8c5ae87887252653b3cec",
"imgBase64" : "/9j/4AAQSkZJRgAB...",
"score" : 0.96,
"updateTime" : "1576808123367"
}
]
}
}
