细粒度图像识别—logo商标识别

接口描述

该请求用于检测和识别图片中的品牌LOGO信息。即对于输入的一张图片(可正常解码,且长宽比适宜),输出图片中LOGO的名称、位置和置信度。
当效果欠佳时,可以建立子库(在控制台创建应用并申请建库)并通过调用logo入口接口完成自定义logo入库,提高识别效果。

logo商标识别

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/image-classify/v2/logo

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式.注意:图片需要base64编码、去掉编码头后再进行urlencode。
custom_lib boolean - 是否只检索用户子库,true则只检索用户子库,false(默认)为检索底库+用户子库

请求代码示例

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
result_num uint32 识别结果数,标识返回结果数目
result array() 返回结果数组,每一项为一个识别出的logo
+location object 位置信息(左起像素位置、上起像素位置、像素宽、像素高)
++left number 坐起像素位置
++top number 上起像素位置
++width number 像素宽
++height number 像素高
+name string 识别的品牌名称
+probability number 分类结果置信度(0--1.0)
+type number type=0为1千种高优商标识别结果;type=1为2万类logo库的结果;其它type为自定义logo库结果

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
  "log_id": 843411868,
  "result_num": 1,
  "result": [
    {
      "type": 0,
      "name": "科颜氏",
      "probability": 0.99998807907104,
      "location": {
        "width": 296,
        "top": 20,
        "height": 128,
        "left": 23
      }
    }
  ]
}

logo商标识别—添加

使用入库接口请先在控制台创建应用并申请建库,建库成功后方可正常使用。

添加logo图片规范

  1. logo商标入库需要待识别商标的紧致包围盒图像,下面是一组示例:

  2. 每种商标不同场景多入库一些图像有助于获得更好的识别效果。如上图中“美素佳儿”图标。

  3. 入库的图像最好是每种商标的最小识别单元。例如入库下面第一个图像的效果不如将下面后三个商标图片入库的效果好。

    入库后识别效果一般:

分别入库后效果更好

不适合入库的图片示例

  1. 尽量不要含有背景,像下面图入库效果肯定不佳,需要裁剪。

  1. 不含logo的图像入库,不会返回该图像,因为算法先回做商标检测,如果没有商标,返回未识别结果,如下图。

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/realtime_search/v1/logo/add

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - 图像数据,base64编码,要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式.注意:图片需要base64编码、去掉编码头后再进行urlencode。
brief string - 检索时带回。此处要传对应的name与code字段,name长度小于100B,code长度小于150B。示例:"{\"name\": \"abc\", \"code\":\"ddd\"}"

请求代码示例

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位
cont_sign string 输入图片签名,可用于删除

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
  "log_id": 972934653,
  "cont_sign": "217113248,419422301"
}

logo商标识别—删除

使用删除接口请先在控制台创建应用并申请建库,建库成功后先调用入库接口完成logo图片入库,删除接口用户在已入库的logo图片中删除图片。

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/rest/2.0/realtime_search/v1/logo/delete

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/x-www-form-urlencoded

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
image string - base64编码后的图片数据(和cont_sign二选一)。要求base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式. 注意:图片需要base64编码、去掉编码头后再进行urlencode。
cont_sign string - 图片签名(和image二选一,image优先级更高)

请求代码示例

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

返回说明

返回参数

字段 是否必选 类型 说明
log_id uint64 唯一的log id,用于问题定位

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 73c4e74c-3101-4a00-bf44-fe246959c05e
Cache-Control: no-cache
Server: BWS
Date: Tue, 18 Oct 2016 02:21:01 GMT
Content-Type: application/json;charset=UTF-8
{
  "log_id": 50488417
}