接口描述
检测出图片中多个主体,并给出位置、标签和置信得分。
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v1/multi_object_detect
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 和url二选一 | string | - | 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少64px,最长边最大4096px,长宽比3:1以内,支持jpg/png/bmp格式 。注意:图片的base64编码是不包含图片头的,如(data:image/jpg;base64,)去掉编码头后再进行urlencode。 |
url | 和image二选一 | string | - | 图片完整URL,URL长度不超过1024字节,URL对应的图片base64编码后大小不超过4M,最短边至少64px,最长边最大4096px,长宽比3:1以内,支持jpg/png/bmp格式,当image字段存在时url字段失效。 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
# 图像多主体检测 curl -i -k 'https://aip.baidubce.com/rest/2.0/image-classify
/v1/multi_object_detect?access_token=【调用鉴权接口获取的token】' --data 'image=
【图片Base64编码,需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
result | 否 | object数组 | 返回结果 |
+name | 否 | string | 图片标签 |
+score | 否 | float | 置信度得分 |
+location | 否 | object数组 | 图中目标主体的检测框位置信息 |
++left | 否 | uint32 | 表示定位位置的长方形左上顶点的水平坐标 |
++top | 否 | uint32 | 表示定位位置的长方形左上顶点的垂直坐标 |
++width | 否 | uint32 | 表示定位位置的长方形的宽度,单位px |
++height | 否 | uint32 | 表示定位位置的长方形的高度,单位px |
返回示例
{
"log_id": 4160887777964368179,
"result": [
{
"score": 0.8241143226623535,
"name": "果蔬生鲜",
"location": {
"width": 89,
"top": 113,
"left": 383,
"height": 204
}
},
{
"score": 0.8606756329536438,
"name": "家居家纺",
"location": {
"width": 112,
"top": 105,
"left": 139,
"height": 203
}
},
{
"score": 0.6238403916358948,
"name": "食品饮料",
"location": {
"width": 67,
"top": 125,
"left": 491,
"height": 176
}
},
{
"score": 0.10546552389860153,
"name": "文化娱乐",
"location": {
"width": 48,
"top": 183,
"left": 231,
"height": 95
}
},
{
"score": 0.7283627986907959,
"name": "家居家电",
"location": {
"width": 72,
"top": 89,
"left": 285,
"height": 244
}
}
]
}