更新时间:2024-06-14 GMT+08:00
分享

图像类说明

图像类服务类型目前包含通用图像搜索、通用商品搜索、服装商品搜索等。

通用图像搜索

  • 搜索类型
    通用图像搜索目前支持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

    内衣

相关文档