图像类说明

通用图像搜索

• 搜索类型
  通用图像搜索目前支持IMAGE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。

  • IMAGE: 图像检索。
  • KEYWORD: 关键词检索。
  • TEXT: 文本检索。

• 高级配置

  通用图像搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。

  • 图像关键词配置
  • 语言类型: 自动生成的关键词语言，可选zh/en，默认zh。
  • 最大数量: 关键词返回数量，默认为50，取值范围为[1, 100]。
  • 置信度阈值: 关键词置信度阈值，默认为20，取值范围为[0, 100]。

通用商品搜索

• 搜索类型

  通用商品搜索目前仅支持CATEGORY一种搜索类型。

  • CATEGORY: 类目检索。
• 高级配置

  通用商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。

  • 商品图像配置
    • 添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。
    • 搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。
• 请求高阶参数

  通用商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。

  • CATEGORY

    针对类目检索的搜索类型，服务实例具有如下高阶请求参数：

    • 添加数据API
      • do_det: 是否进行目标检测，默认为true。
      • box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。
      • do_cls: 是否进行对象分类，默认为true。
      • category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。

      {
          "do_det": true,
          "box": "50,100,200,300",
          "do_cls": true,
          "category": 1
      }

    • 搜索API
      • do_det: 是否进行目标检测，默认为true。
      • box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。
      • do_cls: 是否进行对象分类，默认为true。
      • category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。
      • collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。

      {
          "do_det": true,
          "box": "50,100,200,300",
          "do_cls": true,
          "category": 1,
          "collapse_key": "spu_id"
      }

• 响应高阶字段

  通用商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。

  • CATEGORY

    针对类目检索的搜索类型，服务实例具有如下高阶响应字段：

    • 添加数据API
      • image_info: 添加图像数据的相关信息。

      {
          "image_info": {
              "objects": [
                  {
                      "box": "135,489,1117,1341",
                      "category": 1,
                      "category_name": "top"
                  }
              ]
          }
      }

    • 搜索API
      • image_info: 搜索图像的相关信息。

      {
          "image_info": {
              "box": "135,489,1117,1341",
              "category": 1,
              "category_name": "top",
              "objects": [
                  {
                      "category_name": "top",
                      "box": "135,489,1117,1341",
                      "category": 1
                  },
                  {
                      "category_name": "others",
                      "box": "373,99,661,468",
                      "category": 0
                  }
              ]
          }
      }

• 商品类目
  通用商品搜索支持的商品类目详见表1。

  表1 通用商品类目表

  类目ID	英文描述	中文描述
  0	others	其他商品
  1	top	上装
  2	bottom	裤子
  3	skirt	裙装
  4	underwear	内衣
  5	jewelry	珠宝配饰
  6	bags	箱包
  7	shoes	鞋
  8	toy	玩具
  9	furniture	家具
  10	health_beauty	美容与健康
  11	electronics	数码电子产品

服装商品搜索

• 搜索类型

  服装商品搜索目前仅支持CATEGORY一种搜索类型。

  • CATEGORY: 类目检索。
• 高级配置

  服装商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。

  • 商品图像配置
    • 添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。
    • 搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。
• 请求高阶参数

  服装商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。

  • CATEGORY

    针对类目检索的搜索类型，服务实例具有如下高阶请求参数：

    • 添加数据API
      • do_det: 是否进行目标检测，默认为true。
      • box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。
      • do_cls: 是否进行对象分类，默认为true。
      • category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。

      {
          "do_det": true,
          "box": "50,100,200,300",
          "do_cls": true,
          "category": 1
      }

    • 搜索API
      • do_det: 是否进行目标检测，默认为true。
      • box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。
      • do_cls: 是否进行对象分类，默认为true。
      • category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。
      • collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。

      {
          "do_det": true,
          "box": "50,100,200,300",
          "do_cls": true,
          "category": 1,
          "collapse_key": "spu_id"
      }

• 响应高阶字段

  服装商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。

  • CATEGORY

    针对类目检索的搜索类型，服务实例具有如下高阶响应字段：

    • 添加数据API
      • image_info: 添加图像数据的相关信息。

      {
          "image_info": {
              "objects": [
                  {
                      "box": "135,489,1117,1341",
                      "category": 1,
                      "category_name": "top"
                  }
              ]
          }
      }

    • 搜索API
      • image_info: 搜索图像的相关信息。

      {
          "image_info": {
              "box": "135,489,1117,1341",
              "category": 1,
              "category_name": "top",
              "objects": [
                  {
                      "category_name": "top",
                      "box": "135,489,1117,1341",
                      "category": 1
                  },
                  {
                      "category_name": "others",
                      "box": "373,99,661,468",
                      "category": 0
                  }
              ]
          }
      }

• 商品类目
  服装商品搜索支持的商品类目详见表2。

  表2 服装商品类目表

  类目ID	英文描述	中文描述
  0	others	其他商品
  1	top	上装
  2	bottom	裤子
  3	skirt	裙装
  4	underwear	内衣