根据指定的条件,搜索结构化数据(人体、人脸等)

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SearchObject

系统规定参数。取值:SearchObject。

CorpId String 123

项目 id。

Feature String [-0.04595605,-0.0038912394,-0.012384229]

搜索的目标向量

这个目标向量,可以通过 RecognizeImage 接口返回值的 Feature 字段获得。

当 Feature 和 ImageContent/ImageUrl 同时存在时,以传入的 Feature 特征为搜索条件。

ObjectType String Face

搜索目标类型

可选值:

Face 人脸

Body 人体

Motor 机动车

NonMotor 非机动车

PageNumber Integer 1

当前页码。

PageSize Integer 10

每页请求最大返回结果的数量,最大不超过200。

Vendor String damo

算法提供商,默认为 damo

可选值:yushi & damo

ImageContent String iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAACZUlEQVQ4T42TX2hSURzHf+feq1OnaDFIF42uWougkNSH3XDWxgraQ0RImdQwofcgih5GT7Uoas8xm9UyAgdRjyNClJYs/xEELlY5w2ZlpJtM5/0X95aiqdV5OnDO+dzf7/v7XAT/XggA+E7XhMOmZTKZtqvl2CuZhFeUq7wSIcRLcW61wmKVtTJPJZPJdOODJoDVanXjGEwFXGlcKaGBwJo/POw1cAwLnng8fq8GqQOsVqv96ZmPQZZHcH2e/H7Lo/uGYYSWF8rnmc/jM7m+cSqlEh7a7xgG4/F4WNiLALPZ3COToJXHp5aJ2ws7ixNurbqlNwCgLqYheG4JRryGKs2hrbFYLC/eGxww5/zOzJbJ18bSFVevUkaw7TNDOFyYyuSvHXzXM+rTfwlFEloRMLTftHr/RFaFb6MWN6mIfoyjgfmagidv5CLo2N4yENrdAAgHnmNS9IfgrqMPyNKLl0mVCLANmNlHzgzWRdoKagXSAEsDdTkL0WhUBPgvmcBxiBQBCKCwsfRcc8Sn58KRBC4CDlBmZuZkBpfrbQWV/P8Aoz6SC0WSvwAjNtOPaUdWQ/RRi5tVRH+tgloQofNrLS0cf0gW58JJze8Q9634nZ+0QohXx3qVQgYtC8PEFhpCzIUiCZ0IEOzrkhDvZ08vY5MLO4oTbp263RhqYxz2GtkqzRoFK+vjtlgsZ5+Npe8KIt2YJ/M3Pbr8X0Ry12z8U2U7gfNzs660tFvCAI6aVT48bWAqNAzVLKyb2FiuYGW3lH8rwUGxwfAK4UyKQYnm0Po6jfYI9nX8mdr17XA48EAg0EFNgJ/jCg8gGGphCgAAAABJRU5ErkJggg==

图片 base64数据

base64后的数据不可超过5M。

在 Feature 为空的时候,会根据图片内容内部默认做一遍 RecognizeImage,得到目标列表第一顺序结果的特征向量(FaceList|BodyList.get(0).Feature)后,做搜索。

所以在一张图片包含多个目标的场景(比如合照照片包含多个人脸人体),建议先调用 RecognizeImage 接口,从响应结果列表中,选取符合业务期望的 Feature 进行搜索。

ImageContent、ImageUrl必须提供一个,如果都提供,只优先使用 ImageContent。

ImageUrl String http://www.aliyun.com

图片访问的 url,base64后的数据不可超过5M。

在 Feature 为空的时候,会根据图片内容内部默认做一遍 RecognizeImage,得到目标列表第一顺序结果的特征向量(FaceList|BodyList.get(0).Feature)后,做搜索。

所以在一张图片包含多个目标的场景(比如合照照片包含多个人脸人体),建议先调用 RecognizeImage 接口,从响应结果列表中,选取符合业务期望的 Feature 进行搜索。

ImageContent、ImageUrl必须提供一个,如果都提供,只优先使用 ImageContent。

DeviceList String ["device1","device2"]

设备 id 列表

最多支持 200 个设备 id 列表长度。

格式为 List<String>对象 json 序列化后的格式。

Attributes String { "key1": [1, 2, 3], "key2": [1, 2] }

结构化属性搜索条件,格式为:

{ "key1": 1, 2, 3, "key2": 1, 2 }。最大属性条件长度为 20。

表示搜索 key1的属性在123条件内,且 key2的属性在12条件内的数据。

ShotTimeStart String 2021-01-27T12:00:00Z

拍摄开始时间。如不传,默认查询最近7天的数据。

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

ShotTimeEnd String 2021-01-27T20:00:00Z

拍摄结束时间。如不传,默认查询最近7天的数据。

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

返回数据

名称 类型 示例值 描述
Code String Success

响应 code

Data Struct

返回详情

BodyList Array of BodyList

人体列表

DeviceID String device1

产出该数据的设备 id

LeftTopX Integer 10

目标图在原图上的左上角X轴坐标

LeftTopY Integer 20

目标图在原图上的左上角Y轴坐标

ObjectType String Body

搜索结果目标类型

RightBottomX Integer 30

目标图在原图上的右下角X轴坐标

RightBottomY Integer 40

目标图在原图上的右下角Y轴坐标

Score Float 0.56

相似度

ShotTime String 2021-01-27T12:00:00Z

拍摄时间

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

SourceImageUrl String http:/www.aliyun.com/file1

原图图片 url,该 url 可以直接通过 http 协议访问到

TargetImageUrl String http:/www.aliyun.com/file2

目标图图片 url,该 url 可以直接通过 http 协议访问到

FaceList Array of FaceList

人脸列表

DeviceID String device2

产出该数据的设备 id

LeftTopX Integer 10

目标图在原图上的左上角X轴坐标

LeftTopY Integer 20

目标图在原图上的左上角Y轴坐标

ObjectType String Face

搜索结果的目标类型

RightBottomX Integer 30

目标图在原图上的右下角X轴坐标

RightBottomY Integer 40

目标图在原图上的右下角Y轴坐标

Score Float 0.57

相似度

ShotTime String 2021-01-27T12:00:00Z

拍摄时间

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

SourceImageUrl String http:/www.aliyun.com/file3

原图图片 url,该 url 可以直接通过 http 协议访问到

TargetImageUrl String http:/www.aliyun.com/file4

目标图图片 url,该 url 可以直接通过 http 协议访问到

MotorList Array of MotorList

机动车列表

DeviceID String device3

产出该数据的设备 id

LeftTopX Integer 10

目标图在原图上的左上角X轴坐标

LeftTopY Integer 20

目标图在原图上的左上角Y轴坐标

ObjectType String Motor

搜索结果目标类型

RightBottomX Integer 30

目标图在原图上的右下角X轴坐标

RightBottomY Integer 40

目标图在原图上的右下角Y轴坐标

Score Float 0.59

相似度

ShotTime String 2021-01-27T12:00:00Z

拍摄时间

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

SourceImageUrl String http:/www.aliyun.com/file5

原图图片 url,该 url 可以直接通过 http 协议访问到

TargetImageUrl String http:/www.aliyun.com/file6

目标图图片 url,该 url 可以直接通过 http 协议访问到

NonMotorList Array of NonMotorList

非机动车列表

DeviceID String device4

产出该数据的设备 id

LeftTopX Integer 10

目标图在原图上的左上角X轴坐标

LeftTopY Integer 20

目标图在原图上的左上角Y轴坐标

ObjectType String NonMotor

搜索结果目标类型

RightBottomX Integer 30

目标图在原图上的右下角X轴坐标

RightBottomY Integer 40

目标图在原图上的右下角Y轴坐标

Score Float 0.61

相似度

ShotTime String 2021-01-27T12:00:00Z

拍摄时间

日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-ddTHH:mm:ssZ。例如,2016-05-23T12:00:00Z(为北京时间2016年5月23日20点0分0秒)

SourceImageUrl String http:/www.aliyun.com/file7

原图图片 url,该 url 可以直接通过 http 协议访问到

TargetImageUrl String http:/www.aliyun.com/file8

目标图图片 url,该 url 可以直接通过 http 协议访问到

Message String OK

返回 message

PageSize Long 10

每页数量

RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求 id

Success Boolean true

是否调用成功

Total Integer 100

数据总量

示例

请求示例

http(s)://[Endpoint]/?Action=SearchObject
&CorpId=123
&Feature=[-0.04595605,-0.0038912394,-0.012384229]
&ObjectType=Face
&PageNumber=1
&PageSize=10
&Vendor=damo
&<公共请求参数>

正常返回示例

JSON格式

{
    "RequestId": "46329898-489C-4E63-9BA1-C1DA5C5D0986",
    "PageSize": 10,
    "Message": "OK",
    "Total": 100,
    "Data": {
        "BodyList": [
            {
                "TargetImageUrl": "http:/www.aliyun.com/file2",
                "ObjectType": "Body",
                "Score": 0.56,
                "RightBottomX": 30,
                "RightBottomY": 40,
                "DeviceID": "device1",
                "ShotTime": "2021-01-27T12:00:00Z",
                "SourceImageUrl": "http:/www.aliyun.com/file1",
                "LeftTopY": 20,
                "LeftTopX": 10
            }
        ]
    },
    "Code": "Success",
    "Success": true
}

错误码

HttpCode 错误码 错误信息 描述
401 InvalidCorpIdError The specified CorpId is invalid. 无效的项目码

访问错误中心查看更多错误码。