tencentcloud-sdk-vod 3.0.1190 → 3.0.1192

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6f097558022685b3cf89e0ba8586f942160464a6
-  data.tar.gz: 432ac1b53db7e1a7eb468b9cb2242c1e38f09bcb
+  metadata.gz: cbb14b51868b9acbb0ef5d0fb16e54f40a4fe73e
+  data.tar.gz: c932d3bb753473c9bbce96e5a41dd2d2e5e0d232
 SHA512:
-  metadata.gz: 14ea16eaf5338364a153baecca6e1755e5ad5f88607f1bd3e1ebe121d49ece427461afef181390d61755f876976d4b9227b6c08906729e814800db5fb9f62b82
-  data.tar.gz: 5384c9556ce728616c92f2c7f27b76f9b63a4e8fee4876ae5833424cf888f321085a99b1e5c833a8a4af3110fa8307be0f40451b47ab69925198c226ac66895d
+  metadata.gz: 719753cd05d0925dffb6f503e4913db8cb5c33a184bfffca82fdb6b81207710a35e40a7f1f53ad9713dbf5272ebd882b8249334afdd2766a49b61bc1c4261a65
+  data.tar.gz: 1c054305ed86775121b73901510edfa723347209f0574ee48ed74c702e24ca190efc4a09db427a47a7884b2a3680d894396272113120455eae565690de5e0f64

data/lib/VERSION

@@ -1 +1 @@
-3.0.1190
+3.0.1192

data/lib/v20180717/client.rb

@@ -792,6 +792,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 该接口用于生成场景化 AIGC 图片。<b>接口处于内测阶段，如需使用请[联系我们](https://cloud.tencent.com/online-service?from=sales_sales&source=PRESALE)，接口调用会产生实际费用。</b>
+
+        # @param request: Request instance for CreateSceneAigcImageTask.
+        # @type request: :class:`Tencentcloud::vod::V20180717::CreateSceneAigcImageTaskRequest`
+        # @rtype: :class:`Tencentcloud::vod::V20180717::CreateSceneAigcImageTaskResponse`
+        def CreateSceneAigcImageTask(request)
+          body = send_request('CreateSceneAigcImageTask', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateSceneAigcImageTaskResponse.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
+
         # 创建用户自定义指定时间点截图模板，数量上限：16。
 
         # @param request: Request instance for CreateSnapshotByTimeOffsetTemplate.

data/lib/v20180717/models.rb

@@ -4045,6 +4045,31 @@ module TencentCloud
         end
       end
 
+      # 场景化 AIGC 生图配置。
+      class AigcImageSceneInfo < TencentCloud::Common::AbstractModel
+        # @param Type: AI生图场景类型，可选值：
+        # - change_clothes：AI换衣。
+        # @type Type: String
+        # @param ChangeClothesConfig: 当 Type 为 change_clothes 时有效，则该项为必填，表示AI 换衣生图配置参数。
+
+        # @type ChangeClothesConfig: :class:`Tencentcloud::Vod.v20180717.models.ChangeClothesConfig`
+
+        attr_accessor :Type, :ChangeClothesConfig
+
+        def initialize(type=nil, changeclothesconfig=nil)
+          @Type = type
+          @ChangeClothesConfig = changeclothesconfig
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          unless params['ChangeClothesConfig'].nil?
+            @ChangeClothesConfig = ChangeClothesConfig.new
+            @ChangeClothesConfig.deserialize(params['ChangeClothesConfig'])
+          end
+        end
+      end
+
       # AIGC 生图任务信息
       class AigcImageTask < TencentCloud::Common::AbstractModel
         # @param TaskId: 任务 ID。
@@ -4538,19 +4563,37 @@ module TencentCloud
         # 1. 推荐使用小于10M的图片；
         # 2. 图片格式的取值为：jpeg，jpg, png。
         # @type Url: String
+        # @param ReferenceType: 参考类型，GV模型适用。
+        # 注意：
 
-        attr_accessor :Type, :FileId, :Url
+        # 当使用GV模型时，可作为参考方式,可选asset(素材)、style(风格)。
+        # @type ReferenceType: String
+        # @param ObjectId: 主体id.
+        # 适用模型：Vidu-q2.
+        # 当需要对图片标识主体时，需要每个图片都带主体id，后续生成时可以通过@主体id的方式使用。
+        # @type ObjectId: String
+        # @param VoiceId: 适用于Vidu-q2模型。
+        # 当全部图片携带主体id时，可针对主体设置音色id。 音色列表：https://shengshu.feishu.cn/sheets/EgFvs6DShhiEBStmjzccr5gonOg
+        # @type VoiceId: String
 
-        def initialize(type=nil, fileid=nil, url=nil)
+        attr_accessor :Type, :FileId, :Url, :ReferenceType, :ObjectId, :VoiceId
+
+        def initialize(type=nil, fileid=nil, url=nil, referencetype=nil, objectid=nil, voiceid=nil)
           @Type = type
           @FileId = fileid
           @Url = url
+          @ReferenceType = referencetype
+          @ObjectId = objectid
+          @VoiceId = voiceid
         end
 
         def deserialize(params)
           @Type = params['Type']
           @FileId = params['FileId']
           @Url = params['Url']
+          @ReferenceType = params['ReferenceType']
+          @ObjectId = params['ObjectId']
+          @VoiceId = params['VoiceId']
         end
       end
 
@@ -5767,6 +5810,29 @@ module TencentCloud
         end
       end
 
+      # AI 换衣参数配置
+      class ChangeClothesConfig < TencentCloud::Common::AbstractModel
+        # @param ClothesFileInfos: 输入需要更换的**衣物**图片列表。目前最大支持4张图片。
+        # @type ClothesFileInfos: Array
+
+        attr_accessor :ClothesFileInfos
+
+        def initialize(clothesfileinfos=nil)
+          @ClothesFileInfos = clothesfileinfos
+        end
+
+        def deserialize(params)
+          unless params['ClothesFileInfos'].nil?
+            @ClothesFileInfos = []
+            params['ClothesFileInfos'].each do |i|
+              sceneaigcimagetaskinputfileinfo_tmp = SceneAigcImageTaskInputFileInfo.new
+              sceneaigcimagetaskinputfileinfo_tmp.deserialize(i)
+              @ClothesFileInfos << sceneaigcimagetaskinputfileinfo_tmp
+            end
+          end
+        end
+      end
+
       # 智能分类任务控制参数
       class ClassificationConfigureInfo < TencentCloud::Common::AbstractModel
         # @param Switch: 智能分类任务开关，可选值：
@@ -7236,9 +7302,15 @@ module TencentCloud
         # @type ModelName: String
         # @param ModelVersion: 模型版本。取值：<li>当 ModelName 是 Hailuo，可选值为 02、2.3、2.3-fast；</li><li>当 ModelName 是 Kling，可选值为 1.6、2.0、2.1、2.5、O1；</li><li>当 ModelName 是 Jimeng，可选值为 3.0pro；</li><li>当 ModelName 是 Vidu，可选值为 q2、q2-pro、q2-turbo；</li><li>当 ModelName 是 GV，可选值为 3.1、3.1-Fast；</li><li>当 ModelName 是 OS，可选值为 2.0；</li><li>当 ModelName 是 Hunyuan，可选值为 1.5；</li><li>当 ModelName 是 Mingmou，可选值为 1.0；</li>
         # @type ModelVersion: String
-        # @param FileInfos: AIGC 生视频任务的输入图片的文件信息。说明
-        # 1. 当 ModelName 是 GV 时，最大长度为 3；其他情况下最大长度为1。
-        # 2. 当 ModelName 是 GV 时，并且长度大于1时，则不能再指定 LastFrameFileId 参数。
+        # @param FileInfos: 最多包含三张素材资源图片的列表，用于描述模型在生成视频时要使用的资源图片。
+
+        # 支持多图输入的模型：
+        # 1. GV，使用多图输入时，不可使用LastFrameFileId和LastFrameUrl。
+        # 2. Vidu，支持多图参考生视频。q2模型1-7张图片，可通过FileInfos里面的ObjectId作为主体id来传入。
+
+        # 注意：
+        # 1. 图片大小不超过10M。
+        # 2. 支持的图片格式：jpeg、png。
         # @type FileInfos: Array
         # @param LastFrameFileId: 用于作为尾帧画面来生成视频的媒体文件 ID。该文件在云点播上的全局唯一标识符，在上传成功后由云点播后台分配。可以在 [视频上传完成事件通知](/document/product/266/7830) 或 [云点播控制台](https://console.cloud.tencent.com/vod/media) 获取该字段。说明：
         # 1. 只支持模型 GV 、Kling、Vidu，其他模型暂不支持。当 ModelName 为 GV 时，如果指定该参数，则需同时指定 FileInfos 作为待生成视频的首帧。当 ModelName 为 Kling 、ModelVersion 为 2.1 并且指定输出分辨率 Resolution 为 1080P 时，才能指定该参数。当 ModelName 为 Vidu、ModelVersion 为 q2-pro、q2-turbo 时，才能指定该参数。
@@ -7250,9 +7322,10 @@ module TencentCloud
         # 2. 图片大小需小于5M。
         # 3. 3. 图片格式的取值为：jpeg，jpg, png, webp。
         # @type LastFrameUrl: String
-        # @param Prompt: 生成图片的提示词。当 FileInfos 为空时，此参数必填。
+        # @param Prompt: 生成视频的提示词。当 FileInfos 为空时，此参数必填。
+        # 示例值：move the picture
         # @type Prompt: String
-        # @param NegativePrompt: 要阻止模型生成图片的提示词。
+        # @param NegativePrompt: 要阻止模型生成视频的提示词。
         # @type NegativePrompt: String
         # @param EnhancePrompt: 是否自动优化提示词。开启时将自动优化传入的 Prompt，以提升生成质量。取值有： <li>Enabled：开启；</li> <li>Disabled：关闭；</li>
         # @type EnhancePrompt: String
@@ -7266,10 +7339,12 @@ module TencentCloud
         # @type TasksPriority: Integer
         # @param ExtInfo: 保留字段，特殊用途时使用。
         # @type ExtInfo: String
+        # @param InputRegion: 输入图片的区域信息。当图片url是国外地址时候，可选Oversea。默认Mainland。
+        # @type InputRegion: String
 
-        attr_accessor :SubAppId, :ModelName, :ModelVersion, :FileInfos, :LastFrameFileId, :LastFrameUrl, :Prompt, :NegativePrompt, :EnhancePrompt, :OutputConfig, :SessionId, :SessionContext, :TasksPriority, :ExtInfo
+        attr_accessor :SubAppId, :ModelName, :ModelVersion, :FileInfos, :LastFrameFileId, :LastFrameUrl, :Prompt, :NegativePrompt, :EnhancePrompt, :OutputConfig, :SessionId, :SessionContext, :TasksPriority, :ExtInfo, :InputRegion
 
-        def initialize(subappid=nil, modelname=nil, modelversion=nil, fileinfos=nil, lastframefileid=nil, lastframeurl=nil, prompt=nil, negativeprompt=nil, enhanceprompt=nil, outputconfig=nil, sessionid=nil, sessioncontext=nil, taskspriority=nil, extinfo=nil)
+        def initialize(subappid=nil, modelname=nil, modelversion=nil, fileinfos=nil, lastframefileid=nil, lastframeurl=nil, prompt=nil, negativeprompt=nil, enhanceprompt=nil, outputconfig=nil, sessionid=nil, sessioncontext=nil, taskspriority=nil, extinfo=nil, inputregion=nil)
           @SubAppId = subappid
           @ModelName = modelname
           @ModelVersion = modelversion
@@ -7284,6 +7359,7 @@ module TencentCloud
           @SessionContext = sessioncontext
           @TasksPriority = taskspriority
           @ExtInfo = extinfo
+          @InputRegion = inputregion
         end
 
         def deserialize(params)
@@ -7311,6 +7387,7 @@ module TencentCloud
           @SessionContext = params['SessionContext']
           @TasksPriority = params['TasksPriority']
           @ExtInfo = params['ExtInfo']
+          @InputRegion = params['InputRegion']
         end
       end
 
@@ -8836,6 +8913,85 @@ module TencentCloud
         end
       end
 
+      # CreateSceneAigcImageTask请求参数结构体
+      class CreateSceneAigcImageTaskRequest < TencentCloud::Common::AbstractModel
+        # @param SubAppId: **点播应用 ID。从2023年12月25日起开通点播的客户，如访问点播应用中的资源（无论是默认应用还是新创建的应用），必须将该字段填写为应用 ID。**
+        # @type SubAppId: Integer
+        # @param SceneInfo: 场景化生图参数配置。
+        # @type SceneInfo: :class:`Tencentcloud::Vod.v20180717.models.AigcImageSceneInfo`
+        # @param FileInfos: 输入图片列表，支持的图片格式：jpg、jpeg、png、webp。不同的场景需要不同的输入数据：
+
+        # - change_clothes：只能输入1张**模特**图片。
+        # @type FileInfos: Array
+        # @param OutputConfig: 场景化生图任务的输出媒体文件配置。
+        # @type OutputConfig: :class:`Tencentcloud::Vod.v20180717.models.SceneAigcImageOutputConfig`
+        # @param SessionId: 用于去重的识别码，如果三天内曾有过相同的识别码的请求，则本次的请求会返回错误。最长 50 个字符，不带或者带空字符串表示不做去重。
+        # @type SessionId: String
+        # @param SessionContext: 来源上下文，用于透传用户请求信息，音画质重生完成回调将返回该字段值，最长 1000 个字符。
+        # @type SessionContext: String
+        # @param TasksPriority: 任务的优先级，数值越大优先级越高，取值范围是 -10 到 10，不填代表 0。
+        # @type TasksPriority: Integer
+        # @param ExtInfo: 保留字段，特殊用途时使用。
+        # @type ExtInfo: String
+
+        attr_accessor :SubAppId, :SceneInfo, :FileInfos, :OutputConfig, :SessionId, :SessionContext, :TasksPriority, :ExtInfo
+
+        def initialize(subappid=nil, sceneinfo=nil, fileinfos=nil, outputconfig=nil, sessionid=nil, sessioncontext=nil, taskspriority=nil, extinfo=nil)
+          @SubAppId = subappid
+          @SceneInfo = sceneinfo
+          @FileInfos = fileinfos
+          @OutputConfig = outputconfig
+          @SessionId = sessionid
+          @SessionContext = sessioncontext
+          @TasksPriority = taskspriority
+          @ExtInfo = extinfo
+        end
+
+        def deserialize(params)
+          @SubAppId = params['SubAppId']
+          unless params['SceneInfo'].nil?
+            @SceneInfo = AigcImageSceneInfo.new
+            @SceneInfo.deserialize(params['SceneInfo'])
+          end
+          unless params['FileInfos'].nil?
+            @FileInfos = []
+            params['FileInfos'].each do |i|
+              sceneaigcimagetaskinputfileinfo_tmp = SceneAigcImageTaskInputFileInfo.new
+              sceneaigcimagetaskinputfileinfo_tmp.deserialize(i)
+              @FileInfos << sceneaigcimagetaskinputfileinfo_tmp
+            end
+          end
+          unless params['OutputConfig'].nil?
+            @OutputConfig = SceneAigcImageOutputConfig.new
+            @OutputConfig.deserialize(params['OutputConfig'])
+          end
+          @SessionId = params['SessionId']
+          @SessionContext = params['SessionContext']
+          @TasksPriority = params['TasksPriority']
+          @ExtInfo = params['ExtInfo']
+        end
+      end
+
+      # CreateSceneAigcImageTask返回参数结构体
+      class CreateSceneAigcImageTaskResponse < TencentCloud::Common::AbstractModel
+        # @param TaskId: 任务 ID。
+        # @type TaskId: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskId, :RequestId
+
+        def initialize(taskid=nil, requestid=nil)
+          @TaskId = taskid
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @TaskId = params['TaskId']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateSnapshotByTimeOffsetTemplate请求参数结构体
       class CreateSnapshotByTimeOffsetTemplateRequest < TencentCloud::Common::AbstractModel
         # @param SubAppId: <b>点播[应用](/document/product/266/14574) ID。从2023年12月25日起开通点播的客户，如访问点播应用中的资源（无论是默认应用还是新创建的应用），必须将该字段填写为应用 ID。</b>
@@ -27291,6 +27447,66 @@ module TencentCloud
         end
       end
 
+      # AIGC 场景化生图任务的输出媒体文件配置。
+      class SceneAigcImageOutputConfig < TencentCloud::Common::AbstractModel
+        # @param StorageMode: 存储模式。取值有： <li>Permanent：永久存储，生成的图片文件将存储到云点播，可在事件通知中获取到 FileId；</li> <li>Temporary：临时存储，生成的图片文件不会存储到云点播，可在事件通知中获取到临时访问的 URL；</li>
+        # 默认值：Temporary
+        # @type StorageMode: String
+        # @param MediaName: 输出文件名，最长 64 个字符。缺省由系统指定生成文件名。
+        # @type MediaName: String
+        # @param ClassId: 分类ID，用于对媒体进行分类管理，可通过 [创建分类](/document/product/266/7812) 接口，创建分类，获得分类 ID。
+        # <li>默认值：0，表示其他分类。</li>
+        # @type ClassId: Integer
+        # @param ExpireTime: 输出文件的过期时间，超过该时间文件将被删除，默认为永久不过期，格式按照 ISO 8601标准表示，详见 [ISO 日期格式说明](https://cloud.tencent.com/document/product/266/11732#I)。
+        # @type ExpireTime: String
+
+        attr_accessor :StorageMode, :MediaName, :ClassId, :ExpireTime
+
+        def initialize(storagemode=nil, medianame=nil, classid=nil, expiretime=nil)
+          @StorageMode = storagemode
+          @MediaName = medianame
+          @ClassId = classid
+          @ExpireTime = expiretime
+        end
+
+        def deserialize(params)
+          @StorageMode = params['StorageMode']
+          @MediaName = params['MediaName']
+          @ClassId = params['ClassId']
+          @ExpireTime = params['ExpireTime']
+        end
+      end
+
+      # AIGC场景化生图任务输入文件信息
+      class SceneAigcImageTaskInputFileInfo < TencentCloud::Common::AbstractModel
+        # @param Type: 输入的视频文件类型。取值有： <li>File：点播媒体文件；</li> <li>Url：可访问的 URL；</li>
+        # @type Type: String
+        # @param FileId: 图片文件的媒体文件 ID，即该文件在云点播上的全局唯一标识符，在上传成功后由云点播后台分配。可以在 [视频上传完成事件通知](/document/product/266/7830) 或 [云点播控制台](https://console.cloud.tencent.com/vod/media) 获取该字段。当 Type 取值为 File 时，本参数有效。
+        # 说明：
+        # 1. 推荐使用小于7M的图片；
+        # 2. 图片格式的取值为：jpeg，jpg, png, webp。
+        # @type FileId: String
+        # @param Url: 可访问的文件 URL。当 Type 取值为 Url 时，本参数有效。
+        # 说明：
+        # 1. 推荐使用小于7M的图片；
+        # 2. 图片格式的取值为：jpeg，jpg, png, webp。
+        # @type Url: String
+
+        attr_accessor :Type, :FileId, :Url
+
+        def initialize(type=nil, fileid=nil, url=nil)
+          @Type = type
+          @FileId = fileid
+          @Url = url
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          @FileId = params['FileId']
+          @Url = params['Url']
+        end
+      end
+
       # 去划痕控制信息
       class ScratchRepairInfo < TencentCloud::Common::AbstractModel
         # @param Switch: 去划痕控制开关，可选值：

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-vod
 version: !ruby/object:Gem::Version
-  version: 3.0.1190
+  version: 3.0.1192
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-25 00:00:00.000000000 Z
+date: 2025-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common