tencentcloud-sdk-tiia 1.0.325 → 1.0.326

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 78f6934141156a9cd2e57c01111d2f8fe98ee567
-  data.tar.gz: 4dabd8036b97f93b60de0814ba469902fcd64041
+  metadata.gz: d755a0f157386c1252edd8732d05fa44c7b86860
+  data.tar.gz: ae688f77368f6dac5e665a11146738eb793616bc
 SHA512:
-  metadata.gz: 9f5d3bf7746fa2009a3ba644fa69c34a9f3cd3d16c08f4acb8965f6cf1bd5d57b2bebb495c0f1d0b3e9844c37427eda08158433573c4c111ed4f8d4b29f48fdc
-  data.tar.gz: edeed74bd9b34aa62b1ca78b1a9bd986fa78d92a8bb1fd47f3cc6410ae2c16a672ef1f9668005667905eaa7ff8a8805e2e1aafd8763a8db554d5a225391549a4
+  metadata.gz: 79ea3b7fc8cb2e76516b1de5100a0032df37aef6a4fa677297db251de414e7587a9157c89c55bccabad6473ee3a8205331d2adc57521a523f4a89b0a24035bf9
+  data.tar.gz: 0397d54c998bfba650f9c344baaed8f49d64bf050adbc15228aa8152751fe6c2307dd62d44efef513cae9056ff44b4554a7cb006b87f324127aaad233cf78133

data/lib/VERSION

@@ -1 +1 @@
-1.0.325
+1.0.326

data/lib/v20190529/models.rb

@@ -89,6 +89,49 @@ module TencentCloud
         end
       end
 
+      # 属性
+      class Attribute < TencentCloud::Common::AbstractModel
+        # @param Type: 属性
+        # @type Type: String
+        # @param Details: 属性详情
+        # @type Details: String
+
+        attr_accessor :Type, :Details
+        
+        def initialize(type=nil, details=nil)
+          @Type = type
+          @Details = details
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          @Details = params['Details']
+        end
+      end
+
+      # 图像主体区域。
+      class Box < TencentCloud::Common::AbstractModel
+        # @param Rect: 图像主体区域。
+        # @type Rect: :class:`Tencentcloud::Tiia.v20190529.models.ImageRect`
+        # @param Score: 置信度。
+        # @type Score: Float
+
+        attr_accessor :Rect, :Score
+        
+        def initialize(rect=nil, score=nil)
+          @Rect = rect
+          @Score = score
+        end
+
+        def deserialize(params)
+          unless params['Rect'].nil?
+            @Rect = ImageRect.new
+            @Rect.deserialize(params['Rect'])
+          end
+          @Score = params['Score']
+        end
+      end
+
       # 车牌信息
       class CarPlateContent < TencentCloud::Common::AbstractModel
         # @param Plate: 车牌信息。
@@ -183,6 +226,30 @@ module TencentCloud
         end
       end
 
+      # 整张图颜色信息。
+      class ColorInfo < TencentCloud::Common::AbstractModel
+        # @param Color: RGB颜色值（16进制），例如：291A18。
+        # @type Color: String
+        # @param Percentage: 当前颜色标签所占比例。
+        # @type Percentage: Float
+        # @param Label: 颜色标签。蜜柚色，米驼色等。
+        # @type Label: String
+
+        attr_accessor :Color, :Percentage, :Label
+        
+        def initialize(color=nil, percentage=nil, label=nil)
+          @Color = color
+          @Percentage = percentage
+          @Label = label
+        end
+
+        def deserialize(params)
+          @Color = params['Color']
+          @Percentage = params['Percentage']
+          @Label = params['Label']
+        end
+      end
+
       # 汽车坐标信息
       class Coord < TencentCloud::Common::AbstractModel
         # @param X: 横坐标x
@@ -215,7 +282,7 @@ module TencentCloud
         # @type Brief: String
         # @param MaxQps: 访问限制默认为10qps，如需扩容请联系[在线客服](https://cloud.tencent.com/online-service)申请。
         # @type MaxQps: Integer
-        # @param GroupType: 图库类型，对应不同服务类型，默认为1。建议手动调整为4～6，1～3为历史版本，不推荐。
+        # @param GroupType: 图库类型，对应不同服务类型，默认为4。1～3为历史版本，不推荐。
         # 参数值：
         # 4：在自建图库中搜索相同原图，可支持裁剪、翻转、调色、加水印后的图片搜索，适用于图片版权保护、原图查询等场景。
         # 5：在自建图库中搜索相同或相似的商品图片，适用于商品分类、检索、推荐等电商场景。
@@ -271,30 +338,54 @@ module TencentCloud
         # @type PicName: String
         # @param ImageUrl: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
         # Url、Image必须提供一个，如果都提供，只使用 Url。
-        # 图片分辨率不超过4096*4096。
+        # 图片分辨率不超过4096\*4096。
         # 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
         # 非腾讯云存储的Url速度和稳定性可能受一定影响。
         # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
         # @type ImageUrl: String
+        # @param CustomContent: 用户自定义的内容，最多支持4096个字符，查询时原样带回。
+        # @type CustomContent: String
         # @param ImageBase64: 图片 base64 数据，base64 编码后大小不可超过5M。
-        # 图片分辨率不超过4096*4096。
+        # 图片分辨率不超过4096\*4096。
         # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
         # @type ImageBase64: String
-        # @param CustomContent: 用户自定义的内容，最多支持4096个字符，查询时原样带回。
-        # @type CustomContent: String
         # @param Tags: 图片自定义标签，最多不超过10个，格式为JSON。
         # @type Tags: String
+        # @param EnableDetect: 是否需要启用主体识别，默认为**TRUE**。
+        # 1.  为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体创建图片并进行主体识别。主体识别结果可在**Response**中获取。
+        # 2. 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图创建图片。
+        # 注意：服务类型为商品图像搜索时生效。
+        # @type EnableDetect: Boolean
+        # @param CategoryId: 图像类目ID。
+        # 若设置类目ID，提取对应类目的主体创建图片。
+        # 注意：服务类型为商品图像搜索时生效。
+        # 类目信息：
+        # 0：上衣。
+        # 1：裙装。
+        # 2：下装。
+        # 3：包。
+        # 4：鞋。
+        # 5：配饰。
+        # @type CategoryId: Integer
+        # @param ImageRect: 图像主体区域。
+        # 若设置主体区域，提取指定的区域创建图片。
+        # @type ImageRect: :class:`Tencentcloud::Tiia.v20190529.models.Rect`
 
-        attr_accessor :GroupId, :EntityId, :PicName, :ImageUrl, :ImageBase64, :CustomContent, :Tags
+        attr_accessor :GroupId, :EntityId, :PicName, :ImageUrl, :CustomContent, :ImageBase64, :Tags, :EnableDetect, :CategoryId, :ImageRect
         
-        def initialize(groupid=nil, entityid=nil, picname=nil, imageurl=nil, imagebase64=nil, customcontent=nil, tags=nil)
+        def initialize(groupid=nil, entityid=nil, picname=nil, imageurl=nil, customcontent=nil, imagebase64=nil, tags=nil, enabledetect=nil, categoryid=nil, imagerect=nil)
           @GroupId = groupid
           @EntityId = entityid
           @PicName = picname
           @ImageUrl = imageurl
-          @ImageBase64 = imagebase64
           @CustomContent = customcontent
+          @ImageBase64 = imagebase64
           @Tags = tags
+          @EnableDetect = enabledetect
+          @CategoryId = categoryid
+          @ImageRect = imagerect
         end
 
         def deserialize(params)
@@ -302,24 +393,40 @@ module TencentCloud
           @EntityId = params['EntityId']
           @PicName = params['PicName']
           @ImageUrl = params['ImageUrl']
-          @ImageBase64 = params['ImageBase64']
           @CustomContent = params['CustomContent']
+          @ImageBase64 = params['ImageBase64']
           @Tags = params['Tags']
+          @EnableDetect = params['EnableDetect']
+          @CategoryId = params['CategoryId']
+          unless params['ImageRect'].nil?
+            @ImageRect = Rect.new
+            @ImageRect.deserialize(params['ImageRect'])
+          end
         end
       end
 
       # CreateImage返回参数结构体
       class CreateImageResponse < TencentCloud::Common::AbstractModel
+        # @param Object: 输入图的主体信息。
+        # 若启用主体识别且在请求中指定了类目ID或主体区域，以指定的主体为准。若启用主体识别且没有指定，以最大面积主体为准。
+        # 注意：此字段可能返回 null，表示取不到有效值。服务类型为商品图像搜索时生效。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Object: :class:`Tencentcloud::Tiia.v20190529.models.ObjectInfo`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :RequestId
+        attr_accessor :Object, :RequestId
         
-        def initialize(requestid=nil)
+        def initialize(object=nil, requestid=nil)
+          @Object = object
           @RequestId = requestid
         end
 
         def deserialize(params)
+          unless params['Object'].nil?
+            @Object = ObjectInfo.new
+            @Object.deserialize(params['Object'])
+          end
           @RequestId = params['RequestId']
         end
       end
@@ -1422,6 +1529,51 @@ module TencentCloud
         end
       end
 
+      # 图像的主体信息。
+      class ObjectInfo < TencentCloud::Common::AbstractModel
+        # @param Box: 图像主体区域。
+        # @type Box: :class:`Tencentcloud::Tiia.v20190529.models.Box`
+        # @param CategoryId: 主体类别ID。
+        # @type CategoryId: Integer
+        # @param Colors: 整张图颜色信息。
+        # @type Colors: Array
+        # @param Attributes: 属性信息。
+        # @type Attributes: Array
+
+        attr_accessor :Box, :CategoryId, :Colors, :Attributes
+        
+        def initialize(box=nil, categoryid=nil, colors=nil, attributes=nil)
+          @Box = box
+          @CategoryId = categoryid
+          @Colors = colors
+          @Attributes = attributes
+        end
+
+        def deserialize(params)
+          unless params['Box'].nil?
+            @Box = Box.new
+            @Box.deserialize(params['Box'])
+          end
+          @CategoryId = params['CategoryId']
+          unless params['Colors'].nil?
+            @Colors = []
+            params['Colors'].each do |i|
+              colorinfo_tmp = ColorInfo.new
+              colorinfo_tmp.deserialize(i)
+              @Colors << colorinfo_tmp
+            end
+          end
+          unless params['Attributes'].nil?
+            @Attributes = []
+            params['Attributes'].each do |i|
+              attribute_tmp = Attribute.new
+              attribute_tmp.deserialize(i)
+              @Attributes << attribute_tmp
+            end
+          end
+        end
+      end
+
       # 检测到的单个商品结构体
       class Product < TencentCloud::Common::AbstractModel
         # @param Name: 图片中商品的三级分类识别结果，选取所有三级分类中的置信度最大者
@@ -1661,6 +1813,34 @@ module TencentCloud
         end
       end
 
+      # 具体坐标，可用来判断边界
+      class Rect < TencentCloud::Common::AbstractModel
+        # @param X: x轴坐标
+        # @type X: Integer
+        # @param Y: y轴坐标
+        # @type Y: Integer
+        # @param Width: (x,y)坐标距离长度
+        # @type Width: Integer
+        # @param Height: (x,y)坐标距离高度
+        # @type Height: Integer
+
+        attr_accessor :X, :Y, :Width, :Height
+        
+        def initialize(x=nil, y=nil, width=nil, height=nil)
+          @X = x
+          @Y = y
+          @Width = width
+          @Height = height
+        end
+
+        def deserialize(params)
+          @X = params['X']
+          @Y = params['Y']
+          @Width = params['Width']
+          @Height = params['Height']
+        end
+      end
+
       # 检测到的图片中的商品位置和品类预测。
       # 当图片中存在多个商品时，输出多组坐标，按照__显著性__排序（综合考虑面积、是否在中心、检测算法置信度）。
       # 最多可以输出__3组__检测结果。
@@ -1695,53 +1875,76 @@ module TencentCloud
       class SearchImageRequest < TencentCloud::Common::AbstractModel
         # @param GroupId: 图库名称。
         # @type GroupId: String
-        # @param ImageUrl: 图片的 Url 。对应图片 base64 编码后大小不可超过2M。
-        # 图片分辨率不超过1920*1080。
+        # @param ImageUrl: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
+        # 图片分辨率不超4096\*4096。
         # Url、Image必须提供一个，如果都提供，只使用 Url。
         # 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
         # 非腾讯云存储的Url速度和稳定性可能受一定影响。
         # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
         # @type ImageUrl: String
-        # @param ImageBase64: 图片 base64 数据，base64 编码后大小不可超过2M。
-        # 图片分辨率不超过1920*1080。
+        # @param ImageBase64: 图片 base64 数据，base64 编码后大小不可超过5M。
+        # 图片分辨率不超过4096\*4096。
         # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
         # @type ImageBase64: String
-        # @param MatchThreshold: 出参Score中，只有超过MatchThreshold值的结果才会返回。默认为0
-        # @type MatchThreshold: Integer
-        # @param Offset: 起始序号，默认值为0。
-        # @type Offset: Integer
         # @param Limit: 返回数量，默认值为10，最大值为100。
         # @type Limit: Integer
+        # @param Offset: 起始序号，默认值为0。
+        # @type Offset: Integer
+        # @param MatchThreshold: 出参Score中，只有超过**MatchThreshold**值的结果才会返回。默认为0
+        # @type MatchThreshold: Integer
         # @param Filter: 针对入库时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。
         # @type Filter: String
         # @param ImageRect: 图像主体区域。
+        # 若设置主体区域，提取指定的区域进行检索。
         # @type ImageRect: :class:`Tencentcloud::Tiia.v20190529.models.ImageRect`
-
-        attr_accessor :GroupId, :ImageUrl, :ImageBase64, :MatchThreshold, :Offset, :Limit, :Filter, :ImageRect
+        # @param EnableDetect: 是否需要启用主体识别，默认为**TRUE** 。
+        # 1. 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在**Response中**获取。
+        # 2. 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图检索图片。
+        # 注意：服务类型为商品图像搜索时生效。
+        # @type EnableDetect: Boolean
+        # @param CategoryId: 图像类目ID。
+        # 若设置类目ID，提取对应类目的主体进行检索。
+        # 注意：服务类型为商品图像搜索时生效。
+        # 类目信息：
+        # 0：上衣。
+        # 1：裙装。
+        # 2：下装。
+        # 3：包。
+        # 4：鞋。
+        # 5：配饰。
+        # @type CategoryId: Integer
+
+        attr_accessor :GroupId, :ImageUrl, :ImageBase64, :Limit, :Offset, :MatchThreshold, :Filter, :ImageRect, :EnableDetect, :CategoryId
         
-        def initialize(groupid=nil, imageurl=nil, imagebase64=nil, matchthreshold=nil, offset=nil, limit=nil, filter=nil, imagerect=nil)
+        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
-          @MatchThreshold = matchthreshold
-          @Offset = offset
           @Limit = limit
+          @Offset = offset
+          @MatchThreshold = matchthreshold
           @Filter = filter
           @ImageRect = imagerect
+          @EnableDetect = enabledetect
+          @CategoryId = categoryid
         end
 
         def deserialize(params)
           @GroupId = params['GroupId']
           @ImageUrl = params['ImageUrl']
           @ImageBase64 = params['ImageBase64']
-          @MatchThreshold = params['MatchThreshold']
-          @Offset = params['Offset']
           @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
       end
 
@@ -1752,14 +1955,20 @@ module TencentCloud
         # @param ImageInfos: 图片信息。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ImageInfos: Array
+        # @param Object: 输入图的主体信息。
+        # 若启用主体识别且在请求中指定了类目ID或主体区域，以指定的主体为准。若启用主体识别且没有指定，以最大面积主体为准。
+        # 注意：此字段可能返回 null，表示取不到有效值。服务类型为商品图像搜索时生效。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Object: :class:`Tencentcloud::Tiia.v20190529.models.ObjectInfo`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :Count, :ImageInfos, :RequestId
+        attr_accessor :Count, :ImageInfos, :Object, :RequestId
         
-        def initialize(count=nil, imageinfos=nil, requestid=nil)
+        def initialize(count=nil, imageinfos=nil, object=nil, requestid=nil)
           @Count = count
           @ImageInfos = imageinfos
+          @Object = object
           @RequestId = requestid
         end
 
@@ -1773,6 +1982,10 @@ module TencentCloud
               @ImageInfos << imageinfo_tmp
             end
           end
+          unless params['Object'].nil?
+            @Object = ObjectInfo.new
+            @Object.deserialize(params['Object'])
+          end
           @RequestId = params['RequestId']
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-tiia
 version: !ruby/object:Gem::Version
-  version: 1.0.325
+  version: 1.0.326
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-01 00:00:00.000000000 Z
+date: 2022-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common