tencentcloud-sdk-vclm 3.0.1159 → 3.0.1177

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e30866d879e09403dbc6ab891870dac46442a185
-  data.tar.gz: 13fbdf499a9b06156cc66b755c3d8d09a6b62497
+  metadata.gz: 915b9bf1baac85dfa23e53888b5882e1bca10a82
+  data.tar.gz: 2b1ea71a86cb2c1a6500d0c0c5472099f9d5496a
 SHA512:
-  metadata.gz: 8469bbcd46aca88a4fbab4c3eeb1c1ba4336dee38a87e0ab8214e0d7a95f005325d6a212c65ff5bc2ae83218564f9f26b72e3f47fa0c6e9bcc3456362ccbe528
-  data.tar.gz: 3c7e4a30719998da9d32561f2100eabe1ad00d3d2c66f5cbb8e204326e0f16037fd5a54cafdbca22163ae3eedd9cb48681850e547b57768ef3c64ddbd9b1e894
+  metadata.gz: 7aab90ac20ece39376943afea122ff16ad7019f403da8ab113ce4b65db941d2a4e38638783290841639c1d9c22c9c44f243ab94b431d664d981d45b3fb4f0bb7
+  data.tar.gz: ff92d40ed297b61804af24c30b40169410307057bae787a3ea7c9c36b98ad5c6f17092b5493d3efef5b260f4b73810afdce86690052d9f6c87f18665262b2e2f

data/lib/VERSION

@@ -1 +1 @@
-3.0.1159
+3.0.1177

data/lib/v20240523/client.rb

@@ -53,6 +53,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过JobId提交请求，获取人像驱动任务的结果信息。
+
+        # @param request: Request instance for DescribeHumanActorJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::DescribeHumanActorJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::DescribeHumanActorJobResponse`
+        def DescribeHumanActorJob(request)
+          body = send_request('DescribeHumanActorJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeHumanActorJobResponse.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 DescribeImageAnimateJob.
@@ -150,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.
@@ -174,6 +222,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 用于提交人像驱动任务
+        # 支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。
+
+        # @param request: Request instance for SubmitHumanActorJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::SubmitHumanActorJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::SubmitHumanActorJobResponse`
+        def SubmitHumanActorJob(request)
+          body = send_request('SubmitHumanActorJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitHumanActorJobResponse.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 SubmitImageAnimateJob.
@@ -271,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

@@ -82,6 +82,54 @@ module TencentCloud
         end
       end
 
+      # DescribeHumanActorJob请求参数结构体
+      class DescribeHumanActorJobRequest < 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
+
+      # DescribeHumanActorJob返回参数结构体
+      class DescribeHumanActorJobResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 任务状态。  WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功
+        # @type Status: String
+        # @param ResultVideoUrl: 结果视频URL。有效期 24 小时。
+        # @type ResultVideoUrl: String
+        # @param ErrorCode: 任务执行错误码。当任务状态不为 FAIL 时，该值为""。
+        # @type ErrorCode: String
+        # @param ErrorMessage: 任务执行错误信息。当任务状态不为 FAIL 时，该值为""。
+        # @type ErrorMessage: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ResultVideoUrl, :ErrorCode, :ErrorMessage, :RequestId
+
+        def initialize(status=nil, resultvideourl=nil, errorcode=nil, errormessage=nil, requestid=nil)
+          @Status = status
+          @ResultVideoUrl = resultvideourl
+          @ErrorCode = errorcode
+          @ErrorMessage = errormessage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ResultVideoUrl = params['ResultVideoUrl']
+          @ErrorCode = params['ErrorCode']
+          @ErrorMessage = params['ErrorMessage']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeImageAnimateJob请求参数结构体
       class DescribeImageAnimateJobRequest < TencentCloud::Common::AbstractModel
         # @param JobId: 任务ID。
@@ -290,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
@@ -348,6 +444,111 @@ module TencentCloud
         end
       end
 
+      # 扩展字段。
+      class ExtraParam < TencentCloud::Common::AbstractModel
+        # @param UserDesignatedUrl: 预签名的上传url，支持把视频直接传到客户指定的地址。
+        # @type UserDesignatedUrl: String
+
+        attr_accessor :UserDesignatedUrl
+
+        def initialize(userdesignatedurl=nil)
+          @UserDesignatedUrl = userdesignatedurl
+        end
+
+        def deserialize(params)
+          @UserDesignatedUrl = params['UserDesignatedUrl']
+        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
@@ -423,6 +624,91 @@ module TencentCloud
         end
       end
 
+      # SubmitHumanActorJob请求参数结构体
+      class SubmitHumanActorJobRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: 文本提示词，不能超过5000字符。
+        # 提示词支持全局和局部控制：
+
+        # - 全局控制：正常输入提示词即可
+        # - 局部控制：可用双井号进行特定时间的提示词约束，例如： "画面中的人物正在对着镜头讲话，偶尔做些手势匹配说话的内容。镜头保持固定。#3#画面中的人物正在对着镜头讲话，同时做出单手做向左方引导的手势。镜头保持固定。"（意思是第三秒的时候让人物做出左方引导手势）
+        #  -- 局部控制时间建议整数，最大可读小数点后两位。
+        # @type Prompt: String
+        # @param AudioUrl: 传入音频URL地址，音频要求：
+        # - 音频时长：2秒 - 60秒
+        # - 音频格式：mp3、wav
+        # - 音频大小：10M以内
+        # @type AudioUrl: String
+        # @param ImageUrl: 传入图片URL地址，图片要求：
+        # - 图片格式：jpg、jpeg、png、bmp、webp
+        # - 图片分辨率：192～4096
+        # - 图片大小：不超过10M
+        # - 图片宽高比：图片【宽：高】在1:4到4:1范围内
+        # - 图片内容：避免上传无人脸、无宠物脸或脸部过小、不完整、不清晰、偏转角度过大、嘴部被遮挡的图片。
+        # @type ImageUrl: String
+        # @param ImageBase64: 传入图片Base64编码，编码后请求体大小不超过10M。
+        # 图片Base64编码与URL地址必传其一，如果都传以ImageUrl为准。
+        # @type ImageBase64: String
+        # @param Resolution: 生成视频分辨率
+        # 枚举值：720p，1080p
+        # 默认1080p
+        # @type Resolution: String
+        # @param FrameRate: 生成视频帧数，单位fps。
+        # 枚举值：25，50
+        # 默认50帧
+        # @type FrameRate: Integer
+        # @param LogoAdd: 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Vclm.v20240523.models.LogoParam`
+
+        attr_accessor :Prompt, :AudioUrl, :ImageUrl, :ImageBase64, :Resolution, :FrameRate, :LogoAdd, :LogoParam
+
+        def initialize(prompt=nil, audiourl=nil, imageurl=nil, imagebase64=nil, resolution=nil, framerate=nil, logoadd=nil, logoparam=nil)
+          @Prompt = prompt
+          @AudioUrl = audiourl
+          @ImageUrl = imageurl
+          @ImageBase64 = imagebase64
+          @Resolution = resolution
+          @FrameRate = framerate
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          @AudioUrl = params['AudioUrl']
+          @ImageUrl = params['ImageUrl']
+          @ImageBase64 = params['ImageBase64']
+          @Resolution = params['Resolution']
+          @FrameRate = params['FrameRate']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # SubmitHumanActorJob返回参数结构体
+      class SubmitHumanActorJobResponse < 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
+
       # SubmitImageAnimateJob请求参数结构体
       class SubmitImageAnimateJobRequest < TencentCloud::Common::AbstractModel
         # @param ImageUrl: 图片格式：支持PNG、JPG、JPEG、BMP、WEBP格式；
@@ -657,34 +943,37 @@ module TencentCloud
       class SubmitTemplateToVideoJobRequest < TencentCloud::Common::AbstractModel
         # @param Template: 特效模板名称。请在 [视频特效模板列表](https://cloud.tencent.com/document/product/1616/119194)  中选择想要生成的特效对应的 template 名称。
         # @type Template: String
-        # @param Images: 参考图像，最多输入2张图。
+        # @param Images: 参考图像，不同特效输入图片的数量详见： [视频特效模板-图片要求说明](https://cloud.tencent.com/document/product/1616/119194)
         # - 支持传入图片Base64编码或图片URL（确保可访问）
         # - 图片格式：支持png、jpg、jpeg、webp、bmp、tiff
-        # - 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300\*300px，不大于4096\*4096，图片宽高比应在1:4 ~ 4:1之间
+        # - 图片文件：大小不能超过10MB（base64后），图片分辨率不小于300*300px，不大于4096*4096，图片宽高比应在1:4 ~ 4:1之间
         # @type Images: Array
-        # @param LogoAdd: 为生成视频添加标识的开关，默认为1。
-        # 1：添加标识。
-        # 0：不添加标识。
+        # @param LogoAdd: 为生成视频添加标识的开关，默认为1。传0 需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成后方可生效。
+        # 1：添加标识；
+        # 0：不添加标识；
         # 其他数值：默认按1处理。
         # 建议您使用显著标识来提示，该视频是 AI 生成的视频。
         # @type LogoAdd: Integer
         # @param LogoParam: 标识内容设置。
-        # 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # 默认在生成视频的右下角添加“ AI 生成”或“视频由 AI 生成”字样，如需替换为其他的标识图片，需前往  [控制台](https://console.cloud.tencent.com/vtc/setting) 申请开启显式标识自主完成。
         # @type LogoParam: :class:`Tencentcloud::Vclm.v20240523.models.LogoParam`
-        # @param Resolution: 视频输出分辨率，默认值：360p  - 枚举值：  720p  360p。
+        # @param Resolution: 视频输出分辨率，默认值：360p 。不同特效支持的清晰度及消耗积分数详见：[视频特效模板-单次调用消耗积分数列](https://cloud.tencent.com/document/product/1616/119194 )
         # @type Resolution: String
         # @param BGM: 是否为生成的视频添加背景音乐。默认：false，  传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM。
         # @type BGM: Boolean
+        # @param ExtraParam: 扩展字段。
+        # @type ExtraParam: :class:`Tencentcloud::Vclm.v20240523.models.ExtraParam`
 
-        attr_accessor :Template, :Images, :LogoAdd, :LogoParam, :Resolution, :BGM
+        attr_accessor :Template, :Images, :LogoAdd, :LogoParam, :Resolution, :BGM, :ExtraParam
 
-        def initialize(template=nil, images=nil, logoadd=nil, logoparam=nil, resolution=nil, bgm=nil)
+        def initialize(template=nil, images=nil, logoadd=nil, logoparam=nil, resolution=nil, bgm=nil, extraparam=nil)
           @Template = template
           @Images = images
           @LogoAdd = logoadd
           @LogoParam = logoparam
           @Resolution = resolution
           @BGM = bgm
+          @ExtraParam = extraparam
         end
 
         def deserialize(params)
@@ -704,6 +993,10 @@ module TencentCloud
           end
           @Resolution = params['Resolution']
           @BGM = params['BGM']
+          unless params['ExtraParam'].nil?
+            @ExtraParam = ExtraParam.new
+            @ExtraParam.deserialize(params['ExtraParam'])
+          end
         end
       end
 
@@ -727,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.1159
+  version: 3.0.1177
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-10-22 00:00:00.000000000 Z
+date: 2025-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,8 +33,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/v20240523/models.rb
 - lib/v20240523/client.rb
+- lib/v20240523/models.rb
 - lib/tencentcloud-sdk-vclm.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby