tencentcloud-sdk-aiart 3.0.856 → 3.0.858

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b5a4dd9bebb7004e19c9e5e7add7f66c46e93e3e
-  data.tar.gz: 52aaa5a71f62afbab72d2184af02e514dabaa1af
+  metadata.gz: 6670a2fe582f4524a45ef981be772178f7e7ebd5
+  data.tar.gz: c4d1dd4df4b2841d9d8f83b2e6024f60f2565acf
 SHA512:
-  metadata.gz: f691902c253ae0de4d21c97bccd39b7805de3a6937e81d55e0a5b40c1f34a936db80d084fc0c43aab1f1c7d720b619a8b37053e13819041149e12c71c0fc65a9
-  data.tar.gz: c569cb44064fe0ebfe90ed6f9b4e8848cf1f716553afc704c619b11ab03b9071092d126e151aae927d9cd22331abc1803da31977df411a90ceb0e1e44f3a3dd8
+  metadata.gz: 35b8f24326c840f473fd0cebfb83a3199cceb5f340ebbe17ab2ea26cf0bc9b7115334981d09e0faf3c72eb707f5deebaf5d5ca1b10266a4e87753987367f0b96
+  data.tar.gz: 03cf3a73686b39d75468f4c2e419719dc315398153ecf9c9e1e142e15f681534dc3d5d439887f556b160ff15928976301c3cb2ece18dac6421ec51424bfe40be

data/lib/VERSION

@@ -1 +1 @@
-3.0.856
+3.0.858

data/lib/v20221229/client.rb

@@ -167,6 +167,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 商品背景生成接口根据指定的背景描述 Prompt，将商品图中的原背景替换为自定义的新背景并保留商品主体形象，实现商品背景的自由生成与更换。
+
+        # 商品背景生成默认提供1个并发任务数，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
+
+        # @param request: Request instance for ReplaceBackground.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::ReplaceBackgroundRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::ReplaceBackgroundResponse`
+        def ReplaceBackground(request)
+          body = send_request('ReplaceBackground', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ReplaceBackgroundResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # AI 写真提供 AI 写真形象照的训练与生成能力，分为上传训练图片、训练模型、生成图片3个环节，需要依次调用对应接口。
         # 每个写真模型自训练完成起1年内有效，有效期内可使用写真模型 ID 生成图片，期满后需要重新训练。
         # 生成图片分为提交任务和查询任务2个接口。

data/lib/v20221229/models.rb

@@ -460,6 +460,88 @@ module TencentCloud
         end
       end
 
+      # ReplaceBackground请求参数结构体
+      class ReplaceBackgroundRequest < TencentCloud::Common::AbstractModel
+        # @param ProductUrl: 商品原图 Url。
+        # 图片限制：单边分辨率小于4000，长宽比在2:5 ~ 5:2之间，转成 Base64 字符串后小于 6MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。
+        # @type ProductUrl: String
+        # @param MaskUrl: 商品 Mask 图 Url，要求背景透明，保留商品主体。
+        # 如果不传，将自动使用内置的商品分割算法得到 Mask。
+        # 支持自定义上传 Mask，如果该参数不为空，则以实际上传的数据为准。
+        # 图片限制：Mask 图必须和商品原图分辨率一致，转成 Base64 字符串后小于 6MB，格式仅支持 png。
+        # @type MaskUrl: String
+        # @param Prompt: 对新背景的文本描述。
+        # 最多支持256个 utf-8 字符，支持中、英文。
+        # @type Prompt: String
+        # @param Resolution: 替换背景后生成的商品图分辨率。
+        # 支持生成单边分辨率大于500且小于4000、长宽比在2:5 ~ 5:2之间的图片，不传默认生成1280:1280。
+        # 建议图片比例为1:1、9:16、16:9，生成效果更佳，使用其他比例的生成效果可能不如建议比例。
+        # @type Resolution: String
+        # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
+        # 1：添加标识。
+        # 0：不添加标识。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图是 AI 生成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
+        # @param RspImgType: 返回图像方式（base64 或 url) ，二选一，默认为 base64。url 有效期为1小时。
+        # 生成图分辨率较大时建议选择 url，使用 base64 可能因图片过大导致返回失败。
+        # @type RspImgType: String
+
+        attr_accessor :ProductUrl, :MaskUrl, :Prompt, :Resolution, :LogoAdd, :LogoParam, :RspImgType
+
+        def initialize(producturl=nil, maskurl=nil, prompt=nil, resolution=nil, logoadd=nil, logoparam=nil, rspimgtype=nil)
+          @ProductUrl = producturl
+          @MaskUrl = maskurl
+          @Prompt = prompt
+          @Resolution = resolution
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+          @RspImgType = rspimgtype
+        end
+
+        def deserialize(params)
+          @ProductUrl = params['ProductUrl']
+          @MaskUrl = params['MaskUrl']
+          @Prompt = params['Prompt']
+          @Resolution = params['Resolution']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+          @RspImgType = params['RspImgType']
+        end
+      end
+
+      # ReplaceBackground返回参数结构体
+      class ReplaceBackgroundResponse < TencentCloud::Common::AbstractModel
+        # @param ResultImage: 根据入参 RspImgType 填入不同，返回不同的内容。
+        # 如果传入 base64 则返回生成图 Base64 编码。
+        # 如果传入 url 则返回的生成图 URL , 有效期1小时，请及时保存。
+        # @type ResultImage: String
+        # @param MaskImage: 如果 MaskUrl 未传，则返回使用内置商品分割算法得到的 Mask 结果。
+        # @type MaskImage: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :ResultImage, :MaskImage, :RequestId
+
+        def initialize(resultimage=nil, maskimage=nil, requestid=nil)
+          @ResultImage = resultimage
+          @MaskImage = maskimage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @ResultImage = params['ResultImage']
+          @MaskImage = params['MaskImage']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 返回结果配置
       class ResultConfig < TencentCloud::Common::AbstractModel
         # @param Resolution: 生成图分辨率

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-aiart
 version: !ruby/object:Gem::Version
-  version: 3.0.856
+  version: 3.0.858
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-07-02 00:00:00.000000000 Z
+date: 2024-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common