tencentcloud-sdk-vclm 3.0.1171 → 3.0.1177

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8bbaae5b2672d2773d7e2398dd2fc3d473a2131f
-  data.tar.gz: 0dda2ce51f4e22d53359a97172310f53c048a376
+  metadata.gz: 915b9bf1baac85dfa23e53888b5882e1bca10a82
+  data.tar.gz: 2b1ea71a86cb2c1a6500d0c0c5472099f9d5496a
 SHA512:
-  metadata.gz: e8bfc67e66bb204c11740f54bf9733c18008cd02f432e9efde25edda4323c425ec8052402c48a84d47d3f4714c0eb3008735168dd4c161cdb50a9a8281ded695
-  data.tar.gz: 9b09e2f40ae855ee22272793f669908307e7c0e2f2135f3d17bd3213253493ff9aabd9c202bc1323952c11d8298f1ae1f2029715339e92a701407e85ae1021d9
+  metadata.gz: 7aab90ac20ece39376943afea122ff16ad7019f403da8ab113ce4b65db941d2a4e38638783290841639c1d9c22c9c44f243ab94b431d664d981d45b3fb4f0bb7
+  data.tar.gz: ff92d40ed297b61804af24c30b40169410307057bae787a3ea7c9c36b98ad5c6f17092b5493d3efef5b260f4b73810afdce86690052d9f6c87f18665262b2e2f

data/lib/VERSION

@@ -1 +1 @@
-3.0.1171
+3.0.1177

data/lib/v20240523/client.rb

@@ -174,6 +174,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询视频人脸融合任务
+
+        # @param request: Request instance for DescribeVideoFaceFusionJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::DescribeVideoFaceFusionJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::DescribeVideoFaceFusionJobResponse`
+        def DescribeVideoFaceFusionJob(request)
+          body = send_request('DescribeVideoFaceFusionJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeVideoFaceFusionJobResponse.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
+
         # 用于查询视频风格化任务。视频风格化支持将输入视频生成特定风格的视频。生成后的视频画面风格多样、流畅自然，能够满足社交娱乐、互动营销、视频素材制作等场景的需求。
 
         # @param request: Request instance for DescribeVideoStylizationJob.
@@ -320,6 +344,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 提交视频人脸融合任务
+
+        # @param request: Request instance for SubmitVideoFaceFusionJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::SubmitVideoFaceFusionJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::SubmitVideoFaceFusionJobResponse`
+        def SubmitVideoFaceFusionJob(request)
+          body = send_request('SubmitVideoFaceFusionJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitVideoFaceFusionJobResponse.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
+
         # 用于提交视频风格化任务。支持将输入视频生成特定风格的视频。生成后的视频画面风格多样、流畅自然，能够满足社交娱乐、互动营销、视频素材制作等场景的需求。
 
         # @param request: Request instance for SubmitVideoStylizationJob.

data/lib/v20240523/models.rb

@@ -338,6 +338,54 @@ module TencentCloud
         end
       end
 
+      # DescribeVideoFaceFusionJob请求参数结构体
+      class DescribeVideoFaceFusionJobRequest < 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
+
+      # DescribeVideoFaceFusionJob返回参数结构体
+      class DescribeVideoFaceFusionJobResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        # @type Status: String
+        # @param ErrorCode: 任务执行错误码。当任务状态不为 FAIL 时，该值为""。
+        # @type ErrorCode: String
+        # @param ErrorMessage: 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。
+        # @type ErrorMessage: String
+        # @param ResultVideoUrl: 结果视频 URL。有效期 24 小时。
+        # @type ResultVideoUrl: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ErrorCode, :ErrorMessage, :ResultVideoUrl, :RequestId
+
+        def initialize(status=nil, errorcode=nil, errormessage=nil, resultvideourl=nil, requestid=nil)
+          @Status = status
+          @ErrorCode = errorcode
+          @ErrorMessage = errormessage
+          @ResultVideoUrl = resultvideourl
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ErrorCode = params['ErrorCode']
+          @ErrorMessage = params['ErrorMessage']
+          @ResultVideoUrl = params['ResultVideoUrl']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeVideoStylizationJob请求参数结构体
       class DescribeVideoStylizationJobRequest < TencentCloud::Common::AbstractModel
         # @param JobId: 任务ID
@@ -412,6 +460,95 @@ module TencentCloud
         end
       end
 
+      # 人脸图片和待被融合的素材模板图的人脸位置信息。
+      class FaceMergeInfo < TencentCloud::Common::AbstractModel
+        # @param MergeFaceImage: 融合图片
+        # @type MergeFaceImage: :class:`Tencentcloud::Vclm.v20240523.models.Image`
+        # @param MergeFaceRect: 上传的图片人脸位置信息（人脸框）
+        # Width、Height >= 30。
+        # @type MergeFaceRect: :class:`Tencentcloud::Vclm.v20240523.models.FaceRect`
+        # @param TemplateFaceID: 素材人脸ID，不填默认取上传图片中最大人脸。
+        # @type TemplateFaceID: String
+
+        attr_accessor :MergeFaceImage, :MergeFaceRect, :TemplateFaceID
+
+        def initialize(mergefaceimage=nil, mergefacerect=nil, templatefaceid=nil)
+          @MergeFaceImage = mergefaceimage
+          @MergeFaceRect = mergefacerect
+          @TemplateFaceID = templatefaceid
+        end
+
+        def deserialize(params)
+          unless params['MergeFaceImage'].nil?
+            @MergeFaceImage = Image.new
+            @MergeFaceImage.deserialize(params['MergeFaceImage'])
+          end
+          unless params['MergeFaceRect'].nil?
+            @MergeFaceRect = FaceRect.new
+            @MergeFaceRect.deserialize(params['MergeFaceRect'])
+          end
+          @TemplateFaceID = params['TemplateFaceID']
+        end
+      end
+
+      # 人脸框信息。
+      class FaceRect < 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
+
+      # 模板信息
+      class FaceTemplateInfo < TencentCloud::Common::AbstractModel
+        # @param TemplateFaceID: 角色ID。需要与MergeInfos中的TemplateFaceID依次对应。需要填数字，建议填"0"、"1"，依次累加。
+        # @type TemplateFaceID: String
+        # @param TemplateFaceImage: 视频模板中要替换的人脸图片
+        # @type TemplateFaceImage: :class:`Tencentcloud::Vclm.v20240523.models.Image`
+        # @param TemplateFaceRect: 视频模板中要替换的人脸图片的人脸框。不填默认取要替换的人脸图片中最大人脸。
+        # @type TemplateFaceRect: :class:`Tencentcloud::Vclm.v20240523.models.FaceRect`
+
+        attr_accessor :TemplateFaceID, :TemplateFaceImage, :TemplateFaceRect
+
+        def initialize(templatefaceid=nil, templatefaceimage=nil, templatefacerect=nil)
+          @TemplateFaceID = templatefaceid
+          @TemplateFaceImage = templatefaceimage
+          @TemplateFaceRect = templatefacerect
+        end
+
+        def deserialize(params)
+          @TemplateFaceID = params['TemplateFaceID']
+          unless params['TemplateFaceImage'].nil?
+            @TemplateFaceImage = Image.new
+            @TemplateFaceImage.deserialize(params['TemplateFaceImage'])
+          end
+          unless params['TemplateFaceRect'].nil?
+            @TemplateFaceRect = FaceRect.new
+            @TemplateFaceRect.deserialize(params['TemplateFaceRect'])
+          end
+        end
+      end
+
       # 图片
       class Image < TencentCloud::Common::AbstractModel
         # @param Base64: 图片Base64
@@ -883,6 +1020,97 @@ module TencentCloud
         end
       end
 
+      # SubmitVideoFaceFusionJob请求参数结构体
+      class SubmitVideoFaceFusionJobRequest < TencentCloud::Common::AbstractModel
+        # @param VideoUrl: 视频素材下载地址。用户自定义模版视频下载地址，使用前需要先调用视频审核接口进行内容审核。视频限制：分辨率≤4k，fps≤25，视频大小≤1G，时长≤20 秒，支持格式mp4。
+
+        # 输入视频建议：
+        # 姿态：人脸相对镜头水平方向角度转动不超过 90°,垂直方向角度转动不超过 20°。遮挡：脸部遮挡面积不超过 50%，不要完全遮挡五官，不要有半透明遮挡（强光，玻璃，透明眼镜等）、以及细碎离散的脸部遮挡（如飘落的花瓣）。妆容及光照：避免浓妆、复杂妆容，避免复杂光照、闪烁，这些属性无法完全恢复，并对稳定性有影响。针对特殊表情和微表情，针对局部肌肉控制下的微表情，以及过于夸张的特殊表情等不保证表情效果完全恢复。
+        # @type VideoUrl: String
+        # @param TemplateInfos: 视频素材模板的人脸位置信息。
+        # 目前最多支持融合视频素材中的 6 张人脸
+        # 输入图片要求：
+        # 1、用户图限制大小不超过 10MB
+        # 2、图片最大分辨率不超过 4k，建议最小为 128，  人脸框最小为 68
+        # 3、支持格式 jpg，png
+        # 4、如果用户图中未指定人脸且有多张人脸，  默认融合最大人脸
+        # 输入图片建议：  包含上述视频中出现的人物的单人照，并且正面、清晰、无遮挡
+        # @type TemplateInfos: Array
+        # @param MergeInfos: 用户人脸图片位置信息。
+        # 输入图片要求：
+        # 1、用户图限制大小不超过 10MB
+        # 2、图片最大分辨率不超过 4k，建议最小为 128，人脸框最小为 68
+        # 3、支持格式 jpg，png
+        # 4、如果未指定人脸且用户图中有多张人脸，
+        # 默认融合最大人脸
+        # 输入图建议：
+        # 正脸无遮挡
+        # @type MergeInfos: Array
+        # @param LogoAdd: 为生成视频添加标识的开关，默认为1。
+        # 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示，该视频是 AI 生成的视频。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 视频水印Logo参数标识内容设置。
+        # 默认在融合结果图右下角添加“AI生成”类似字样，您可根据自身需要替换为其他的Logo图片。
+        # 输入建议：输入水印图片宽高需小于视频宽高
+        # @type LogoParam: :class:`Tencentcloud::Vclm.v20240523.models.LogoParam`
+
+        attr_accessor :VideoUrl, :TemplateInfos, :MergeInfos, :LogoAdd, :LogoParam
+
+        def initialize(videourl=nil, templateinfos=nil, mergeinfos=nil, logoadd=nil, logoparam=nil)
+          @VideoUrl = videourl
+          @TemplateInfos = templateinfos
+          @MergeInfos = mergeinfos
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @VideoUrl = params['VideoUrl']
+          unless params['TemplateInfos'].nil?
+            @TemplateInfos = []
+            params['TemplateInfos'].each do |i|
+              facetemplateinfo_tmp = FaceTemplateInfo.new
+              facetemplateinfo_tmp.deserialize(i)
+              @TemplateInfos << facetemplateinfo_tmp
+            end
+          end
+          unless params['MergeInfos'].nil?
+            @MergeInfos = []
+            params['MergeInfos'].each do |i|
+              facemergeinfo_tmp = FaceMergeInfo.new
+              facemergeinfo_tmp.deserialize(i)
+              @MergeInfos << facemergeinfo_tmp
+            end
+          end
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # SubmitVideoFaceFusionJob返回参数结构体
+      class SubmitVideoFaceFusionJobResponse < TencentCloud::Common::AbstractModel
+        # @param JobId: 视频人脸融合任务的job id（job有效期24小时）
+        # @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
+
       # SubmitVideoStylizationJob请求参数结构体
       class SubmitVideoStylizationJobRequest < TencentCloud::Common::AbstractModel
         # @param StyleId: 风格ID。取值说明：

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-vclm
 version: !ruby/object:Gem::Version
-  version: 3.0.1171
+  version: 3.0.1177
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-20 00:00:00.000000000 Z
+date: 2025-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,9 +33,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/tencentcloud-sdk-vclm.rb
 - lib/v20240523/client.rb
 - lib/v20240523/models.rb
+- lib/tencentcloud-sdk-vclm.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: