tencentcloud-sdk-tiia 3.0.410 → 3.0.411

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a684bbefc318fd9d4351f77a334a0734e982bed6
-  data.tar.gz: e3ad07bb79d6f4f80d276a96c398eb95bbf4dff7
+  metadata.gz: 697795e34f56917d398fb5506b97ec093c22dde8
+  data.tar.gz: 93d42658039d421262a232b992d81bdce46d69ef
 SHA512:
-  metadata.gz: 9b0bbde9ab731d9c4a5be2cc08595f69a79864b73118aab023ffd054b30e334ed62591b361e072e636a21ddedbf23609e6bb545eb79f709258d0888c0080ad1c
-  data.tar.gz: fae9e85ac6e9aed34d959db45e38a39f63808d7a6d377bfe60ddd2fcbb267efe62d2c1e5b8b59cb617b35dc9b45771614e5559ea3aae97840d4517e73c186f53
+  metadata.gz: 0fc6b533268720a54dc8e4cab94071edec90b4a71a2ce2c9991c2c04e9ab643f671814c9b70d5a66c67be5751909b33999bcb918abe43923626e080c95abece2
+  data.tar.gz: 47ae2ee372533fe3c6c1f025f4aba5d1d7109f2452816d72c99fb56ee70254377bfd2f7f723edead3a70eecaef2467f6c088c67b022385ac1e8340c0cbb4fd32

data/lib/VERSION

@@ -1 +1 @@
-3.0.410
+3.0.411

data/lib/v20190529/client.rb

@@ -55,13 +55,13 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 用于创建一个空的图片库，如果图片库已存在则返回错误。不同类型图库对应不同的图像搜索服务，根据输入参数GroupType区分。
+        # 本接口用于创建一个空的图片库，图片库主要用于存储在创建图片时提取的图片特征数据，如果图片库已存在则返回错误。不同的图片库类型对应不同的图像搜索服务类型，根据输入参数GroupType区分。
 
-        # | 服务类型 | GroupType参数值 |功能描述 |
-        # |  :------  | :----- |:-----------------  |
-        # | 相同图像搜索<img width=30/>    | 4 |在自建图库中搜索相同原图，可支持裁剪、翻转、调色、加水印后的图片搜索，适用于图片版权保护、原图查询等场景。|
-        # | 商品图像搜索<img width=30/>   | 5 |在自建图库中搜索相同或相似的商品图片，适用于商品分类、检索、推荐等电商场景。|
-        # | 相似图像搜索<img width=30/>   | 6 |在自建图片库中搜索与输入图片高度相似的图片，适用于相似图案、logo、纹理等图像元素的搜索。|
+        # | 服务类型 | GroupType入参 |功能描述 |
+        # |  :----------  | :----- |:-----------------  |
+        # | 相同图像搜索<div style="width: 70pt"> | 4 |在自建图片库中搜索相同原图或高相似图，并给出相似度打分，可支持裁剪、翻转、调色、加水印等二次编辑后的图片搜索。适用于图片版权保护、原图查询等场景。|
+        # | 商品图像搜索<div style="width: 70pt"> | 5 |在自建图库中搜索同款商品，并给出相似度打分。对于服饰类商品可支持识别服饰类别、属性等信息。适用于商品分类、检索、推荐等电商场景。|
+        # | 相似图像搜索<div style="width: 70pt"> | 6 |在自建图库中搜索相似的图案、logo、纹理等图像元素或主体，并给出相似度打分。|
 
         # @param request: Request instance for CreateGroup.
         # @type request: :class:`Tencentcloud::tiia::V20190529::CreateGroupRequest`
@@ -85,7 +85,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建图片，并添加对应图片的自定义信息。
+        # 创建图片，并添加对应图片的自定义信息。模型将在创建图片时自动提取图像特征并存储到指定的图片库中。
 
         # @param request: Request instance for CreateImage.
         # @type request: :class:`Tencentcloud::tiia::V20190529::CreateImageRequest`
@@ -534,7 +534,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口用于对一张待识别的商品图片，在指定图片库中检索出最相似的图片列表。
+        # 本接口用于对一张图片，在指定图片库中检索出与之相似的图片列表。
 
         # @param request: Request instance for SearchImage.
         # @type request: :class:`Tencentcloud::tiia::V20190529::SearchImageRequest`

data/lib/v20190529/models.rb

@@ -325,15 +325,15 @@ module TencentCloud
         # @type GroupName: String
         # @param MaxCapacity: 图库可容纳的最大图片数量。
         # @type MaxCapacity: Integer
-        # @param Brief: 简介。
+        # @param Brief: 图库简介。
         # @type Brief: String
         # @param MaxQps: 访问限制默认为10qps，如需扩容请联系[在线客服](https://cloud.tencent.com/online-service)申请。
         # @type MaxQps: Integer
-        # @param GroupType: 图库类型，对应不同服务类型，默认为4。1～3为历史版本，不推荐。
-        # 参数值：
-        # 4：在自建图库中搜索相同原图，可支持裁剪、翻转、调色、加水印后的图片搜索，适用于图片版权保护、原图查询等场景。
-        # 5：在自建图库中搜索相同或相似的商品图片，适用于商品分类、检索、推荐等电商场景。
-        # 6：在自建图片库中搜索与输入图片高度相似的图片，适用于相似图案、logo、纹理等图像元素的搜索。
+        # @param GroupType: 图库类型，对应不同的图像搜索服务类型，默认为4。1～3为历史版本，不推荐。
+        # 参数取值：
+        # 4：相同图像搜索。
+        # 5：商品图像搜索。
+        # 6：相似图像搜索。
         # @type GroupType: Integer
 
         attr_accessor :GroupId, :GroupName, :MaxCapacity, :Brief, :MaxQps, :GroupType
@@ -378,43 +378,45 @@ module TencentCloud
         # @param GroupId: 图库ID。
         # @type GroupId: String
         # @param EntityId: 物品ID，最多支持64个字符。
-        # 若EntityId已存在，则对其追加图片。
+        # 一个物品ID可以包含多张图片，若EntityId已存在，则对其追加图片。同一个EntityId，最大支持10张图。
         # @type EntityId: String
         # @param PicName: 图片名称，最多支持64个字符，
-        # 同一个EntityId，最大支持10张图。
+        # PicName唯一确定一张图片，具有唯一性。
         # @type PicName: String
         # @param ImageUrl: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-        # Url、Image必须提供一个，如果都提供，只使用 Url。
-        # 图片分辨率不超过4096\*4096。
-        # 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
-        # 非腾讯云存储的Url速度和稳定性可能受一定影响。
-        # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
-        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
+        # ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。
+        # 图片限制：
+        # • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096\*4096。
+        # • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\*2000，图片长宽比小于10。
+        # 建议：
+        # • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
         # @type ImageUrl: String
-        # @param CustomContent: 用户自定义的内容，最多支持4096个字符，查询时原样带回。
+        # @param CustomContent: 图片自定义备注内容，最多支持4096个字符，查询时原样带回。
         # @type CustomContent: String
         # @param ImageBase64: 图片 base64 数据，base64 编码后大小不可超过5M。
-        # 图片分辨率不超过4096\*4096。
-        # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
-        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
+        # 图片限制：
+        # • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096\*4096。
+        # • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\*2000，图片长宽比小于10。
         # @type ImageBase64: String
         # @param Tags: 图片自定义标签，最多不超过10个，格式为JSON。
         # @type Tags: String
         # @param EnableDetect: 是否需要启用主体识别，默认为**TRUE**。
-        # 1.  为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体创建图片并进行主体识别。主体识别结果可在**Response**中获取。
-        # 2. 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图创建图片。
-        # 注意：服务类型为商品图像搜索时生效。
+        # • 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体创建图片并进行主体识别。主体识别结果可在**Response**中获取。
+        # • 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图创建图片。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # @type EnableDetect: Boolean
         # @param CategoryId: 图像类目ID。
-        # 若设置类目ID，提取对应类目的主体创建图片。
-        # 注意：服务类型为商品图像搜索时生效。
-        # 类目信息：
+        # 若设置类目ID，提取以下类目的主体创建图片。
+        # 类目取值说明：
         # 0：上衣。
         # 1：裙装。
         # 2：下装。
         # 3：包。
         # 4：鞋。
         # 5：配饰。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # @type CategoryId: Integer
         # @param ImageRect: 图像主体区域。
         # 若设置主体区域，提取指定的区域创建图片。
@@ -456,7 +458,7 @@ module TencentCloud
       class CreateImageResponse < TencentCloud::Common::AbstractModel
         # @param Object: 输入图的主体信息。
         # 若启用主体识别且在请求中指定了类目ID或主体区域，以指定的主体为准。若启用主体识别且没有指定，以最大面积主体为准。
-        # 注意：此字段可能返回 null，表示取不到有效值。服务类型为商品图像搜索时生效。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Object: :class:`Tencentcloud::Tiia.v20190529.models.ObjectInfo`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -1938,45 +1940,58 @@ module TencentCloud
       class SearchImageRequest < TencentCloud::Common::AbstractModel
         # @param GroupId: 图库名称。
         # @type GroupId: String
-        # @param ImageUrl: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-        # 图片分辨率不超4096\*4096。
-        # Url、Image必须提供一个，如果都提供，只使用 Url。
-        # 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
-        # 非腾讯云存储的Url速度和稳定性可能受一定影响。
-        # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
-        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
+        # @param ImageUrl: 图片的 Url 。
+        # ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。
+        # 图片限制：
+        # • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # • 图片大小：对应图片 base64 编码后大小不可超过5M。图片分辨率不超过4096\*4096。
+        # • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\*2000，图片长宽比小于10。
+        # 建议：
+        # • 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
         # @type ImageUrl: String
-        # @param ImageBase64: 图片 base64 数据，base64 编码后大小不可超过5M。
-        # 图片分辨率不超过4096\*4096。
-        # 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
-        # 注意：开启主体识别分辨率不超过2000\*2000，图片长宽比小于10（长/短 < 10）。
+        # @param ImageBase64: 图片 base64 数据。
+        # ImageUrl和ImageBase64必须提供一个，如果都提供，只使用ImageUrl。
+        # 图片限制：
+        # • 图片格式：支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # • 图片大小：base64 编码后大小不可超过5M。图片分辨率不超过4096\*4096。
+        # • 如果在商品图像搜索中开启主体识别，分辨率不超过2000\*2000，图片长宽比小于10。
         # @type ImageBase64: String
-        # @param Limit: 返回数量，默认值为10，最大值为100。
+        # @param Limit: 返回结果的数量，默认值为10，最大值为100。
+        # 按照相似度分数由高到低排序。
+        # **<font color=#1E90FF>注意：服务类型为相似图像搜索时返回数量限制为1，即返回top1的结果。</font>**
         # @type Limit: Integer
-        # @param Offset: 起始序号，默认值为0。
+        # @param Offset: 返回结果的起始序号，默认值为0。
         # @type Offset: Integer
-        # @param MatchThreshold: 出参Score中，只有超过**MatchThreshold**值的结果才会返回。默认为0
+        # @param MatchThreshold: 匹配阈值。
+        # 只有图片相似度分数超过MatchThreshold值的结果才会返回。
+        # 默认值：
+        # • 相同图像搜索：50。
+        # • 商品图像搜索：28。
+        # • 相似图像搜索：56。
+        # 建议：
+        # 可以手动调整MatchThreshold值来控制输出结果的范围。入股发现无检索结果，建议调整为较低的阈值。
         # @type MatchThreshold: Integer
-        # @param Filter: 针对入库时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。
+        # @param Filter: 标签过滤条件。
+        # 针对创建图片时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。
         # @type Filter: String
         # @param ImageRect: 图像主体区域。
         # 若设置主体区域，提取指定的区域进行检索。
         # @type ImageRect: :class:`Tencentcloud::Tiia.v20190529.models.ImageRect`
         # @param EnableDetect: 是否需要启用主体识别，默认为**TRUE** 。
-        # 1. 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在**Response中**获取。
-        # 2. 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图检索图片。
-        # 注意：服务类型为商品图像搜索时生效。
+        # • 为**TRUE**时，启用主体识别，返回主体信息。若没有指定**ImageRect**，自动提取最大面积主体进行检索并进行主体识别。主体识别结果可在**Response中**获取。
+        # • 为**FALSE**时，不启用主体识别，不返回主体信息。若没有指定**ImageRect**，以整张图检索图片。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # @type EnableDetect: Boolean
         # @param CategoryId: 图像类目ID。
-        # 若设置类目ID，提取对应类目的主体进行检索。
-        # 注意：服务类型为商品图像搜索时生效。
-        # 类目信息：
+        # 若设置类目ID，提取以下类目的主体进行检索。
+        # 类目取值说明：
         # 0：上衣。
         # 1：裙装。
         # 2：下装。
         # 3：包。
         # 4：鞋。
         # 5：配饰。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # @type CategoryId: Integer
 
         attr_accessor :GroupId, :ImageUrl, :ImageBase64, :Limit, :Offset, :MatchThreshold, :Filter, :ImageRect, :EnableDetect, :CategoryId
@@ -2020,7 +2035,7 @@ module TencentCloud
         # @type ImageInfos: Array
         # @param Object: 输入图的主体信息。
         # 若启用主体识别且在请求中指定了类目ID或主体区域，以指定的主体为准。若启用主体识别且没有指定，以最大面积主体为准。
-        # 注意：此字段可能返回 null，表示取不到有效值。服务类型为商品图像搜索时生效。
+        # **<font color=#1E90FF>注意：仅服务类型为商品图像搜索时才生效。</font>**
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Object: :class:`Tencentcloud::Tiia.v20190529.models.ObjectInfo`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-tiia
 version: !ruby/object:Gem::Version
-  version: 3.0.410
+  version: 3.0.411
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-09-15 00:00:00.000000000 Z
+date: 2022-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common