API文档

人脸搜索接口

调用地址：请登入后查看

请求方式：POST

返回类型：Json

 

请求参数（Headers）

Content-Type=application/json

UserAuthKey=您申请的数智客接口平台的AppCode

 

请求参数（Body）

{

    "face_set_name":"szk_face",

    "image_base64":"iVBORw0KG..."

}

 

请求参数说明：

参数	参数类型	是否必填	描述
face_set_name	String	是	创建人脸库接口创建的名称。
image_base64	String	是	图像数据，Base64编码，要求： Base64编码后大小不超过8MB，建议小于1MB。 图片为JPG/JPEG/BMP/PNG格式。

 

请求示例

见demo

 

正常返回示例

{

    "msg": "成功",

    "code": 200,

    "data": {

        "result": [

            {

                "bounding_box": {

                    "width": 124,

                    "top_left_y": 67,

                    "top_left_x": 212,

                    "height": 149

                },

                "similarity": 1.0,

                "external_image_id": "fnwhont6",

                "face_id": "PBBBdDzY"

            }

        ]

    },

    "reqno": "202309111807319748"

}

 

返回参数说明：

列表1 result

参数		参数类型	描述
bounding_box		Object	人脸在图像中的位置。
	width	Integer	矩形框宽度。
	top_left_y	Integer	矩形框左上角纵坐标。
	top_left_x	Integer	矩形框左上角横坐标。
	height	Integer	矩形框高度。
similarity		Double	人脸搜索时用于被检索的相似度。一般相似度大于0.85可以认为是同一个人。
external_image_id		String	人脸所在的外部图片ID。
face_id		String	人脸ID，由系统内部生成的唯一ID。

 

失败返回示例

略

错误参照码

错误参照码