tencentcloud-sdk-vclm 3.0.1171 → 3.0.1178

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8bbaae5b2672d2773d7e2398dd2fc3d473a2131f
-  data.tar.gz: 0dda2ce51f4e22d53359a97172310f53c048a376
+  metadata.gz: 928d3d13851812a41b422d1d5eeacba5a212a735
+  data.tar.gz: 224c8a73d95a74d223aab8ff30babb588776f43f
 SHA512:
-  metadata.gz: e8bfc67e66bb204c11740f54bf9733c18008cd02f432e9efde25edda4323c425ec8052402c48a84d47d3f4714c0eb3008735168dd4c161cdb50a9a8281ded695
-  data.tar.gz: 9b09e2f40ae855ee22272793f669908307e7c0e2f2135f3d17bd3213253493ff9aabd9c202bc1323952c11d8298f1ae1f2029715339e92a701407e85ae1021d9
+  metadata.gz: f68faaca0bc85b5388243a843025031fd8763493e21630fa5cd563302f7ac11a15a05b7d7bfbe147021ba3a6da66758486f240b10cded5a86c75d0ec37644ef1
+  data.tar.gz: b8aa4775ab499a49c5d36680a678397850cd0c19338f0798e393b18a9c04a24883caf03b52911f4944eec11a9742d89c9a13a7eb7b140414ae1ba751d9ad4ec2

data/lib/VERSION

@@ -1 +1 @@
-3.0.1171
+3.0.1178

data/lib/v20240523/client.rb

@@ -77,6 +77,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询混元生视频任务
+
+        # @param request: Request instance for DescribeHunyuanToVideoJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::DescribeHunyuanToVideoJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::DescribeHunyuanToVideoJobResponse`
+        def DescribeHunyuanToVideoJob(request)
+          body = send_request('DescribeHunyuanToVideoJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeHunyuanToVideoJobResponse.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.
@@ -174,6 +198,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.
@@ -198,6 +246,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 通过JobId提交请求，获取视频配音频任务的结果信息。
+
+        # @param request: Request instance for DescribeVideoVoiceJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::DescribeVideoVoiceJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::DescribeVideoVoiceJobResponse`
+        def DescribeVideoVoiceJob(request)
+          body = send_request('DescribeVideoVoiceJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeVideoVoiceJobResponse.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
+
         # 用于提交人像驱动任务
         # 支持提交音频和图文来生成对应视频，满足动态交互、内容生产等场景需求。
 
@@ -223,6 +295,32 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # ●混元生视频接口，基于混元大模型，根据输入的文本或图片智能生成视频。
+
+        # ●默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for SubmitHunyuanToVideoJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::SubmitHunyuanToVideoJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::SubmitHunyuanToVideoJobResponse`
+        def SubmitHunyuanToVideoJob(request)
+          body = send_request('SubmitHunyuanToVideoJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitHunyuanToVideoJobResponse.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.
@@ -320,6 +418,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.
@@ -344,6 +466,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 提交视频配音效任务，输入视频后提交请求，会返回一个JobId，用于查询视频配音效的处理进度。
+
+        # @param request: Request instance for SubmitVideoVoiceJob.
+        # @type request: :class:`Tencentcloud::vclm::V20240523::SubmitVideoVoiceJobRequest`
+        # @rtype: :class:`Tencentcloud::vclm::V20240523::SubmitVideoVoiceJobResponse`
+        def SubmitVideoVoiceJob(request)
+          body = send_request('SubmitVideoVoiceJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = SubmitVideoVoiceJobResponse.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
+
 
       end
     end

data/lib/v20240523/models.rb

@@ -130,6 +130,54 @@ module TencentCloud
         end
       end
 
+      # DescribeHunyuanToVideoJob请求参数结构体
+      class DescribeHunyuanToVideoJobRequest < 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
+
+      # DescribeHunyuanToVideoJob返回参数结构体
+      class DescribeHunyuanToVideoJobResponse < 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
+
       # DescribeImageAnimateJob请求参数结构体
       class DescribeImageAnimateJobRequest < TencentCloud::Common::AbstractModel
         # @param JobId: 任务ID。
@@ -338,6 +386,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
@@ -396,6 +492,54 @@ module TencentCloud
         end
       end
 
+      # DescribeVideoVoiceJob请求参数结构体
+      class DescribeVideoVoiceJobRequest < 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
+
+      # DescribeVideoVoiceJob返回参数结构体
+      class DescribeVideoVoiceJobResponse < 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
+
       # 扩展字段。
       class ExtraParam < TencentCloud::Common::AbstractModel
         # @param UserDesignatedUrl: 预签名的上传url，支持把视频直接传到客户指定的地址。
@@ -412,6 +556,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
@@ -572,6 +805,68 @@ module TencentCloud
         end
       end
 
+      # SubmitHunyuanToVideoJob请求参数结构体
+      class SubmitHunyuanToVideoJobRequest < TencentCloud::Common::AbstractModel
+        # @param Prompt: 视频内容的描述，中文正向提示词。最多支持200个 utf-8 字符（首尾空格不计入字符数）。 示例值：一只猫在草原上奔跑，写实风格
+        # @type Prompt: String
+        # @param Image: 输入图片
+        # 上传图url大小不超过 10M，base64不超过8M。
+        # 支持jpg，png，jpeg，webp，bmp，tiff 格式
+        # 单边分辨率不超过5000，不小于50，长宽限制1:4 ~ 4:1
+        # @type Image: :class:`Tencentcloud::Vclm.v20240523.models.Image`
+        # @param Resolution: 目前仅支持720p视频分辨率，默认720p。
+        # @type Resolution: String
+        # @param LogoAdd: 为生成视频添加标识的开关，默认为1，0 需前往 控制台 申请开启显示标识自主完成方可生效。
+        #  1：添加标识； 0：不添加标识； 其他数值：默认按1处理。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 默认在生成视频的右下角添加“ AI 生成”字样，如需替换为其他的标识图片，需前往 控制台 申请开启显示标识自主完成。
+        # @type LogoParam: :class:`Tencentcloud::Vclm.v20240523.models.LogoParam`
+
+        attr_accessor :Prompt, :Image, :Resolution, :LogoAdd, :LogoParam
+
+        def initialize(prompt=nil, image=nil, resolution=nil, logoadd=nil, logoparam=nil)
+          @Prompt = prompt
+          @Image = image
+          @Resolution = resolution
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @Prompt = params['Prompt']
+          unless params['Image'].nil?
+            @Image = Image.new
+            @Image.deserialize(params['Image'])
+          end
+          @Resolution = params['Resolution']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # SubmitHunyuanToVideoJob返回参数结构体
+      class SubmitHunyuanToVideoJobResponse < 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格式；
@@ -883,6 +1178,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。取值说明：
@@ -940,6 +1326,61 @@ module TencentCloud
         end
       end
 
+      # SubmitVideoVoiceJob请求参数结构体
+      class SubmitVideoVoiceJobRequest < TencentCloud::Common::AbstractModel
+        # @param VideoUrl: 输入视频的Url  上传视频时长限制：1-15s 视频格式：MP4，MOV 视频大小：不超过1 GB URL地址中不能包含中文字符。
+        # @type VideoUrl: String
+        # @param Prompt: 描述音效内容的正向提示词。输入上限50个字符。
+        # @type Prompt: String
+        # @param NegativePrompt: 音效内容的原始负向提示词。输入上限50个字符。
+        # @type NegativePrompt: String
+        # @param LogoAdd: 为生成视频添加标识的开关，默认为1。 1：添加标识。 0：不添加标识。 其他数值：默认按1处理。 建议您使用显著标识来提示，该视频是 AI 生成的视频。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。 默认在生成视频的右下角添加“视频由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
+        # @type LogoParam: :class:`Tencentcloud::Vclm.v20240523.models.LogoParam`
+
+        attr_accessor :VideoUrl, :Prompt, :NegativePrompt, :LogoAdd, :LogoParam
+
+        def initialize(videourl=nil, prompt=nil, negativeprompt=nil, logoadd=nil, logoparam=nil)
+          @VideoUrl = videourl
+          @Prompt = prompt
+          @NegativePrompt = negativeprompt
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @VideoUrl = params['VideoUrl']
+          @Prompt = params['Prompt']
+          @NegativePrompt = params['NegativePrompt']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # SubmitVideoVoiceJob返回参数结构体
+      class SubmitVideoVoiceJobResponse < 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
+
     end
   end
 end

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.1178
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-11-20 00:00:00.000000000 Z
+date: 2025-12-08 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/v20240523/client.rb
+- lib/tencentcloud-sdk-vclm.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: