Class: TencentCloud::Tiia::V20190529::SearchImageRequest

Inherits:
Common::AbstractModel
  • Object
show all
Defined in:
lib/v20190529/models.rb

Overview

SearchImage请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(groupid = nil, imageurl = nil, imagebase64 = nil, limit = nil, offset = nil, matchthreshold = nil, filter = nil, imagerect = nil, enabledetect = nil, categoryid = nil) ⇒ SearchImageRequest

Returns a new instance of SearchImageRequest.



1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
 
# File 'lib/v20190529/models.rb', line 1913

def initialize(groupid=nil, imageurl=nil, imagebase64=nil, limit=nil, offset=nil, matchthreshold=nil, filter=nil, imagerect=nil, enabledetect=nil, categoryid=nil)
  @GroupId = groupid
  @ImageUrl = imageurl
  @ImageBase64 = imagebase64
  @Limit = limit
  @Offset = offset
  @MatchThreshold = matchthreshold
  @Filter = filter
  @ImageRect = imagerect
  @EnableDetect = enabledetect
  @CategoryId = categoryid
end

Instance Attribute Details

#CategoryId ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def CategoryId
  @CategoryId
end

#EnableDetect ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def EnableDetect
  @EnableDetect
end

#Filter ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def Filter
  @Filter
end

#GroupId ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def GroupId
  @GroupId
end

#ImageBase64 ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def ImageBase64
  @ImageBase64
end

#ImageRect ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def ImageRect
  @ImageRect
end

#ImageUrl ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def ImageUrl
  @ImageUrl
end

#Limit ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def Limit
  @Limit
end

#MatchThreshold ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def MatchThreshold
  @MatchThreshold
end

#Offset ⇒ Object

ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 建议： • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。 ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。 图片限制： • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。 • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096*4096。 • 如果在商品图像搜索中开启主体识别，分辨率不超过2000*2000，图片长宽比小于10。 按照相似度分数由高到低排序。 服务类型为图案花纹搜索时Limit = 1，最多只能返回1个结果。 只有图片相似度分数超过匹配阈值的结果才会返回。 当MatchThreshold为0（默认值）时，各服务类型将按照以下默认的匹配阈值进行结果过滤： • 通用图像搜索1.0版：50。 • 商品图像搜索2.0升级版：45。 • 商品图像搜索1.0版：28。 • 图案花纹搜索1.0版：56。 建议： 可以手动调整MatchThreshold值来控制输出结果的范围。如果发现无检索结果，可能是因为图片相似度较低导致检索结果被匹配阈值过滤，建议调整为较低的阈值后再次尝试检索。 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。 最大支持64字符。 若设置主体区域，提取指定的区域进行检索。 • 为TRUE时，启用主体识别，返回主体信息。若没有指定ImageRect，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在Response中获取。 • 为FALSE时，不启用主体识别，不返回主体信息。若没有指定ImageRect，以整张图检索图片。 注意：仅服务类型为商品图像搜索时才生效。 若设置类目ID，提取以下类目的主体进行检索。 类目取值说明： 0：上衣。 1：裙装。 2：下装。 3：包。 4：鞋。 5：配饰。 注意：仅服务类型为商品图像搜索时才生效。

Parameters:

  • GroupId: —

    图库名称。

  • ImageUrl: —

    图片的 Url 。

  • ImageBase64: —

    图片 base64 数据。

  • Limit: —

    返回结果的数量，默认值为10，最大值为100。

  • Offset: —

    返回结果的起始序号，默认值为0。

  • MatchThreshold: —

    匹配阈值。

  • Filter: —

    标签过滤条件。

  • ImageRect: —

    图像主体区域。

  • EnableDetect: —

    是否需要启用主体识别，默认为TRUE 。

  • CategoryId: —

    图像类目ID。



1911
1912
1913
 
# File 'lib/v20190529/models.rb', line 1911

def Offset
  @Offset
end

Instance Method Details

#deserialize(params) ⇒ Object 



1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
 
# File 'lib/v20190529/models.rb', line 1926

def deserialize(params)
  @GroupId = params['GroupId']
  @ImageUrl = params['ImageUrl']
  @ImageBase64 = params['ImageBase64']
  @Limit = params['Limit']
  @Offset = params['Offset']
  @MatchThreshold = params['MatchThreshold']
  @Filter = params['Filter']
  unless params['ImageRect'].nil?
    @ImageRect = ImageRect.new
    @ImageRect.deserialize(params['ImageRect'])
  end
  @EnableDetect = params['EnableDetect']
  @CategoryId = params['CategoryId']
end