tencentcloud-sdk-aiart 3.0.1001 → 3.0.1003

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d089f4b48316f9ea85392b91a35cecad7a2ac884
-  data.tar.gz: aadd580c00c9d732d78a0e639bc4ada10e72b2ed
+  metadata.gz: e3b44c6839c55188c36252907e48fa77b8249e64
+  data.tar.gz: 61d3dde43986da81f05f6b15c2358346f0d9adc9
 SHA512:
-  metadata.gz: 36128dab1c68c95918de1415cd070ec086f4c99b024106f8aa78a0a823c899d148094591a379983baf5c17aa0f64f2a086f9decdd70b392b561a7db0fa8e117d
-  data.tar.gz: 892b304e56dd2d1d4405b767582784d5750e2e7caec08bbf9132e5a4ece3e05217401c851ef9c2546c5bb27d8ded265f5c84df8e01e19ff68122fe653d7b35c7
+  metadata.gz: de52502193326e55762297c106bbba43d64500d5b9fa56c64f7b073ce56f549e9700641c731ef1ff49cf4ccd8167f778211f50048ca2689731fa4e7c9dc682e2
+  data.tar.gz: 348b2aa20b1b161896c5ec85c995a1fa57747905e760f84f9438080d5a25f076fa2272da25190f6252d2b25f02e8d66658b33f7f7220e7c231e9a62204b169bf

data/lib/VERSION

@@ -1 +1 @@
-3.0.1001
+3.0.1003

data/lib/v20221229/client.rb

@@ -185,6 +185,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
+        # - 提交任务：提交一个美照生成异步任务，获得任务 ID。
+        # - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。
+
+        # AI 美照默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
+
+        # @param request: Request instance for QueryGlamPicJob.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::QueryGlamPicJobRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::QueryGlamPicJobResponse`
+        def QueryGlamPicJob(request)
+          body = send_request('QueryGlamPicJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = QueryGlamPicJobResponse.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
+
         # 表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。
         # - 提交任务：提交一个表情动图生成异步任务，获得任务 ID。
         # - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。
@@ -354,6 +382,34 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # AI 美照接口将根据模板为用户生成精美照片。分为提交任务和查询任务2个接口。
+        # - 提交任务：提交一个美照生成异步任务，获得任务 ID。
+        # - 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得生成图像结果。
+
+        # AI 美照默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后才能开始处理下一个任务。
+
+        # @param request: Request instance for SubmitGlamPicJob.
+        # @type request: :class:`Tencentcloud::aiart::V20221229::SubmitGlamPicJobRequest`
+        # @rtype: :class:`Tencentcloud::aiart::V20221229::SubmitGlamPicJobResponse`
+        def SubmitGlamPicJob(request)
+          body = send_request('SubmitGlamPicJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitGlamPicJobResponse.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
+
         # 表情动图生成接口将静态照片制作成动态的表情包。分为提交任务和查询任务2个接口。
 
         # - 提交任务：提交一个表情动图生成异步任务，获得任务 ID。

data/lib/v20221229/models.rb

@@ -96,6 +96,29 @@ module TencentCloud
         end
       end
 
+      # 融合信息
+      class FaceInfo < TencentCloud::Common::AbstractModel
+        # @param ImageUrls: 用户图 URL 列表
+        # @type ImageUrls: Array
+        # @param TemplateFaceRect: 模版图人脸坐标。
+        # @type TemplateFaceRect: :class:`Tencentcloud::Aiart.v20221229.models.Rect`
+
+        attr_accessor :ImageUrls, :TemplateFaceRect
+
+        def initialize(imageurls=nil, templatefacerect=nil)
+          @ImageUrls = imageurls
+          @TemplateFaceRect = templatefacerect
+        end
+
+        def deserialize(params)
+          @ImageUrls = params['ImageUrls']
+          unless params['TemplateFaceRect'].nil?
+            @TemplateFaceRect = Rect.new
+            @TemplateFaceRect.deserialize(params['TemplateFaceRect'])
+          end
+        end
+      end
+
       # 训练图像质量过滤开关配置。
       # 支持开启或关闭对训练图像分辨率下限、脸部区域大小、脸部遮挡、脸部角度的过滤，默认开启以上过滤。
       # 如果训练图像内包含多人脸或无人脸、和 Base 人像不为同一人也将被过滤，不可关闭该过滤条件。
@@ -595,6 +618,63 @@ module TencentCloud
         end
       end
 
+      # QueryGlamPicJob请求参数结构体
+      class QueryGlamPicJobRequest < TencentCloud::Common::AbstractModel
+        # @param JobId: 任务ID。
+        # @type JobId: String
+
+        attr_accessor :JobId
+
+        def initialize(jobid=nil)
+          @JobId = jobid
+        end
+
+        def deserialize(params)
+          @JobId = params['JobId']
+        end
+      end
+
+      # QueryGlamPicJob返回参数结构体
+      class QueryGlamPicJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobStatusCode: 当前任务状态码：
+        # 1：等待中、2：运行中、4：处理失败、5：处理完成。
+        # @type JobStatusCode: String
+        # @param JobStatusMsg: 当前任务状态：排队中、处理中、处理失败或者处理完成。
+        # @type JobStatusMsg: String
+        # @param JobErrorCode: 任务处理失败错误码。
+        # @type JobErrorCode: String
+        # @param JobErrorMsg: 任务处理失败错误信息。
+        # @type JobErrorMsg: String
+        # @param ResultImage: 生成图 URL 列表，有效期1小时，请及时保存。
+        # @type ResultImage: Array
+        # @param ResultDetails: 结果 detail 数组，Success 代表成功。
+        # @type ResultDetails: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :JobStatusCode, :JobStatusMsg, :JobErrorCode, :JobErrorMsg, :ResultImage, :ResultDetails, :RequestId
+
+        def initialize(jobstatuscode=nil, jobstatusmsg=nil, joberrorcode=nil, joberrormsg=nil, resultimage=nil, resultdetails=nil, requestid=nil)
+          @JobStatusCode = jobstatuscode
+          @JobStatusMsg = jobstatusmsg
+          @JobErrorCode = joberrorcode
+          @JobErrorMsg = joberrormsg
+          @ResultImage = resultimage
+          @ResultDetails = resultdetails
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @JobStatusCode = params['JobStatusCode']
+          @JobStatusMsg = params['JobStatusMsg']
+          @JobErrorCode = params['JobErrorCode']
+          @JobErrorMsg = params['JobErrorMsg']
+          @ResultImage = params['ResultImage']
+          @ResultDetails = params['ResultDetails']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # QueryMemeJob请求参数结构体
       class QueryMemeJobRequest < TencentCloud::Common::AbstractModel
         # @param JobId: 查询表情动图生成任务 ID。
@@ -758,6 +838,34 @@ module TencentCloud
         end
       end
 
+      # 人脸框坐标
+      class Rect < TencentCloud::Common::AbstractModel
+        # @param X: 人脸框左上角横坐标。
+        # @type X: Integer
+        # @param Y: 人脸框左上角纵坐标。
+        # @type Y: Integer
+        # @param Width: 人脸框宽度。
+        # @type Width: Integer
+        # @param Height: 人脸框高度。
+        # @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
+
       # ReplaceBackground请求参数结构体
       class ReplaceBackgroundRequest < TencentCloud::Common::AbstractModel
         # @param ProductUrl: 商品原图 Url。
@@ -1016,6 +1124,96 @@ module TencentCloud
         end
       end
 
+      # SubmitGlamPicJob请求参数结构体
+      class SubmitGlamPicJobRequest < TencentCloud::Common::AbstractModel
+        # @param TemplateUrl: 美照模板图 URL。
+        # 图片限制：模板图中最多出现5张人脸，单边分辨率大于300，转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。
+        # @type TemplateUrl: String
+        # @param FaceInfos: 用户图 URL 列表，以及模板图中需要替换成用户的人脸框信息。
+        # 一张美照中可包含1 ~ 5个用户形象。每个用户需上传1 ~ 6张照片，如果图中存在多个人脸将取最大人脸。
+        # 模板图中的人脸数量需要大于等于用户个数。如果不传每个用户在模板图中的人脸框位置，默认按照模板图人脸框从大到小的顺序进行替换。如需自定义顺序，需要依次上传每个用户在模板图中的人脸框位置。
+        # 图片限制：每张图片转成 Base64 字符串后小于 10MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。建议使用单人、正脸、脸部区域占比较大、脸部清晰无遮挡、无大角度偏转、无夸张表情的用户图。
+        # @type FaceInfos: Array
+        # @param Num: 美照生成数量。
+        # 支持1 ~ 4张，默认生成4张。
+        # @type Num: Integer
+        # @param Style: 美照生成风格。
+        # 仅对单人美照生效，单人可支持选择不同风格。需按照美照生成数量，在数组中逐一填入每张美照的风格名称。如果不传，默认取不重复的随机风格顺序。
+        # 多人美照只支持 balanced 一种风格，该参数不生效。
+        # 可选风格：<ul><li>real：面部相似度更高。</li><li>balanced：平衡面部真实感和美观度。</li><li>textured：脸部皮肤更具真实感。</li><li>beautiful：脸部美观度更高。</li></ul>
+        # @type Style: Array
+        # @param Similarity: 相似度系数，越高越像用户图。
+        # 取值范围[0, 1]，默认为0.6。
+        # @type Similarity: Float
+        # @param Clarity: 超分选项，默认不做超分，可选开启。
+        # x2：2倍超分
+        # x4：4倍超分
+        # @type Clarity: String
+        # @param LogoAdd: 为生成结果图添加标识的开关，默认为1。
+        # 1：添加标识。
+        # 0：不添加标识。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图是 AI 生成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Aiart.v20221229.models.LogoParam`
+
+        attr_accessor :TemplateUrl, :FaceInfos, :Num, :Style, :Similarity, :Clarity, :LogoAdd, :LogoParam
+
+        def initialize(templateurl=nil, faceinfos=nil, num=nil, style=nil, similarity=nil, clarity=nil, logoadd=nil, logoparam=nil)
+          @TemplateUrl = templateurl
+          @FaceInfos = faceinfos
+          @Num = num
+          @Style = style
+          @Similarity = similarity
+          @Clarity = clarity
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @TemplateUrl = params['TemplateUrl']
+          unless params['FaceInfos'].nil?
+            @FaceInfos = []
+            params['FaceInfos'].each do |i|
+              faceinfo_tmp = FaceInfo.new
+              faceinfo_tmp.deserialize(i)
+              @FaceInfos << faceinfo_tmp
+            end
+          end
+          @Num = params['Num']
+          @Style = params['Style']
+          @Similarity = params['Similarity']
+          @Clarity = params['Clarity']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # SubmitGlamPicJob返回参数结构体
+      class SubmitGlamPicJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobId: 任务ID。
+        # @type JobId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :JobId, :RequestId
+
+        def initialize(jobid=nil, requestid=nil)
+          @JobId = jobid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @JobId = params['JobId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # SubmitMemeJob请求参数结构体
       class SubmitMemeJobRequest < TencentCloud::Common::AbstractModel
         # @param Pose: 表情模板。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-aiart
 version: !ruby/object:Gem::Version
-  version: 3.0.1001
+  version: 3.0.1003
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-02-19 00:00:00.000000000 Z
+date: 2025-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common