tencentcloud-sdk-hunyuan 3.0.1180 → 3.0.1205

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0cbae0beb6acd4a347575ec5e20f50354afda9a9
-  data.tar.gz: 71693614d07141bbd07277c0a78f4b9659031d37
+  metadata.gz: 1dafea296b7432fa9327cb98b3cfd98c5a548580
+  data.tar.gz: b7ec8ed703cb3c8f1d6df6370891d95ca1c3c9ff
 SHA512:
-  metadata.gz: 57c3d51ca86a1e261db185df07b004b2c1137bbd2b05da379fcef37ba34d76a11acb1b29d5e024f4c8db387d94d10b624e954e05ac90c14d6af999c06a3d464f
-  data.tar.gz: 715d50e267492b95a31902cb62e780e70bd8dc570b0c40e678c8ac5c0a97e9d01f78e99ff26abecf04e7fd71f95a0f6d7ee40188ab05deaca7036716c62b330a
+  metadata.gz: 624f1f4545c33c8cfc8578d8e5ccc850833cb81e33af8cc020fe82f0ea5c2785f30b2477975832b7cc0a29ec0c2fad28fbab7877f62a49b27b15580810f33740
+  data.tar.gz: 16d537a669887f99f716afb3a6383ddc80ca9bcea4bdf5acab7c1d3181eb0c895703e0014697ef9d6a225437c8a6f004caf4de4be2cb7cb9e93904e2e43ac785

data/lib/VERSION

@@ -1 +1 @@
-3.0.1180
+3.0.1205

data/lib/v20230901/client.rb

@@ -142,6 +142,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
+        # 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for Describe3DSmartTopologyJob.
+        # @type request: :class:`Tencentcloud::hunyuan::V20230901::Describe3DSmartTopologyJobRequest`
+        # @rtype: :class:`Tencentcloud::hunyuan::V20230901::Describe3DSmartTopologyJobResponse`
+        def Describe3DSmartTopologyJob(request)
+          body = send_request('Describe3DSmartTopologyJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = Describe3DSmartTopologyJobResponse.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 FilesDeletions.
@@ -519,6 +544,31 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 混元生3D接口，采用 Polygon 1.5模型，输入3D 高模后，可生成布线规整，较低面数的3D 模型。
+        # 默认提供1个并发，代表最多能同时处理1个已提交的任务，上一个任务处理完毕后，才能开始处理下一个任务。
+
+        # @param request: Request instance for Submit3DSmartTopologyJob.
+        # @type request: :class:`Tencentcloud::hunyuan::V20230901::Submit3DSmartTopologyJobRequest`
+        # @rtype: :class:`Tencentcloud::hunyuan::V20230901::Submit3DSmartTopologyJobResponse`
+        def Submit3DSmartTopologyJob(request)
+          body = send_request('Submit3DSmartTopologyJob', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = Submit3DSmartTopologyJobResponse.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。
         # 查询任务：根据任务 ID 查询任务的处理状态、处理结果，任务处理完成后可获得在上一轮对话基础上继续生成的图像结果。

data/lib/v20230901/models.rb

@@ -211,10 +211,10 @@ module TencentCloud
 
         attr_accessor :Model, :Messages, :Stream, :StreamModeration, :TopP, :Temperature, :EnableEnhancement, :Tools, :ToolChoice, :CustomTool, :SearchInfo, :Citation, :EnableSpeedSearch, :EnableMultimedia, :EnableDeepSearch, :Seed, :ForceSearchEnhancement, :Stop, :EnableRecommendedQuestions, :EnableDeepRead, :WebSearchOptions, :TopicChoice, :EnableThinking
         extend Gem::Deprecate
-        deprecate :EnableDeepSearch, :none, 2025, 12
-        deprecate :EnableDeepSearch=, :none, 2025, 12
-        deprecate :EnableDeepRead, :none, 2025, 12
-        deprecate :EnableDeepRead=, :none, 2025, 12
+        deprecate :EnableDeepSearch, :none, 2026, 1
+        deprecate :EnableDeepSearch=, :none, 2026, 1
+        deprecate :EnableDeepRead, :none, 2026, 1
+        deprecate :EnableDeepRead=, :none, 2026, 1
 
         def initialize(model=nil, messages=nil, stream=nil, streammoderation=nil, topp=nil, temperature=nil, enableenhancement=nil, tools=nil, toolchoice=nil, customtool=nil, searchinfo=nil, citation=nil, enablespeedsearch=nil, enablemultimedia=nil, enabledeepsearch=nil, seed=nil, forcesearchenhancement=nil, stop=nil, enablerecommendedquestions=nil, enabledeepread=nil, websearchoptions=nil, topicchoice=nil, enablethinking=nil)
           @Model = model
@@ -324,8 +324,8 @@ module TencentCloud
 
         attr_accessor :Created, :Usage, :Note, :Id, :Choices, :ErrorMsg, :ModerationLevel, :SearchInfo, :Replaces, :RecommendedQuestions, :Processes, :RequestId
         extend Gem::Deprecate
-        deprecate :ModerationLevel, :none, 2025, 12
-        deprecate :ModerationLevel=, :none, 2025, 12
+        deprecate :ModerationLevel, :none, 2026, 1
+        deprecate :ModerationLevel=, :none, 2026, 1
 
         def initialize(created=nil, usage=nil, note=nil, id=nil, choices=nil, errormsg=nil, moderationlevel=nil, searchinfo=nil, replaces=nil, recommendedquestions=nil, processes=nil, requestid=nil)
           @Created = created
@@ -551,25 +551,25 @@ module TencentCloud
         end
       end
 
-      # 可以传入多种类型的内容，如图片、文本。
+      # 可以传入多种类型的内容，目前支持文本、图片、视频。
       class Content < TencentCloud::Common::AbstractModel
         # @param Type: 内容类型
         # 注意：
         # 需包含至少一个 Type 为"text"的参数。
-        # 参数值可选范围：[text", "image_url","video_url"]
+        # 参数值可选范围：["text", "image_url","video_url","video_frames"]
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Type: String
-        # @param Text: 当 Type 为 text 时使用，表示具体的文本内容。当 Type 为 image_url 时，当前字段内容需保持为空，传递内容不生效。
+        # @param Text: 当 Type 为 text 时使用，表示具体的文本内容。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Text: String
         # @param ImageUrl: 图片的url，当 Type 为 image_url 时使用，表示具体的图片内容
-        # 如"https://example.com/1.png" 或 图片的base64（注意 "data:image/jpeg;base64," 为必要部分）："data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA......"。当 Type 为 text 时，当前字段内容需保持为空，传递内容不生效。
+        # 如"https://example.com/1.png" 或 图片的base64（注意 "data:image/jpeg;base64," 为必要部分）："data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA......"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ImageUrl: :class:`Tencentcloud::Hunyuan.v20230901.models.ImageUrl`
-        # @param VideoUrl: 当type为video_url时使用，标识具体的视频链接内容
+        # @param VideoUrl: 当 Type 为 video_url 时使用，标识具体的视频链接内容，如"https://your-video-path.mp4"。当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type VideoUrl: :class:`Tencentcloud::Hunyuan.v20230901.models.VideoUrl`
-        # @param VideoFrames: 当type为video_frames时使用，标识具体的视频内图像帧内容
+        # @param VideoFrames: 当 Type 为 video_frames 时使用，标识具体的视频内图像帧内容，当 Type 为 其他类型 时，当前字段内容需保持为空，传递内容不生效。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type VideoFrames: :class:`Tencentcloud::Hunyuan.v20230901.models.VideoFrames`
 
@@ -687,6 +687,61 @@ module TencentCloud
         end
       end
 
+      # Describe3DSmartTopologyJob请求参数结构体
+      class Describe3DSmartTopologyJobRequest < 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
+
+      # Describe3DSmartTopologyJob返回参数结构体
+      class Describe3DSmartTopologyJobResponse < TencentCloud::Common::AbstractModel
+        # @param Status: 任务状态。WAIT：等待中，RUN：执行中，FAIL：任务失败，DONE：任务成功 示例值：RUN。
+        # @type Status: String
+        # @param ErrorCode: 错误码。
+        # @type ErrorCode: String
+        # @param ErrorMessage: 错误信息。
+        # @type ErrorMessage: String
+        # @param ResultFile3Ds: 生成文件的URL地址，有效期1天。
+        # @type ResultFile3Ds: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Status, :ErrorCode, :ErrorMessage, :ResultFile3Ds, :RequestId
+
+        def initialize(status=nil, errorcode=nil, errormessage=nil, resultfile3ds=nil, requestid=nil)
+          @Status = status
+          @ErrorCode = errorcode
+          @ErrorMessage = errormessage
+          @ResultFile3Ds = resultfile3ds
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Status = params['Status']
+          @ErrorCode = params['ErrorCode']
+          @ErrorMessage = params['ErrorMessage']
+          unless params['ResultFile3Ds'].nil?
+            @ResultFile3Ds = []
+            params['ResultFile3Ds'].each do |i|
+              file3d_tmp = File3D.new
+              file3d_tmp.deserialize(i)
+              @ResultFile3Ds << file3d_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # Embedding 信息。
       class EmbeddingData < TencentCloud::Common::AbstractModel
         # @param Embedding: Embedding 信息，目前为 1024 维浮点数。
@@ -756,6 +811,30 @@ module TencentCloud
         end
       end
 
+      # 3D文件
+      class File3D < TencentCloud::Common::AbstractModel
+        # @param Type: 3D文件的格式。取值范围：GIF, OBJ
+        # @type Type: String
+        # @param Url: 文件的Url（有效期24小时）
+        # @type Url: String
+        # @param PreviewImageUrl: 预览图片Url
+        # @type PreviewImageUrl: String
+
+        attr_accessor :Type, :Url, :PreviewImageUrl
+
+        def initialize(type=nil, url=nil, previewimageurl=nil)
+          @Type = type
+          @Url = url
+          @PreviewImageUrl = previewimageurl
+        end
+
+        def deserialize(params)
+          @Type = params['Type']
+          @Url = params['Url']
+          @PreviewImageUrl = params['PreviewImageUrl']
+        end
+      end
+
       # 已上传的文件对象。
       class FileObject < TencentCloud::Common::AbstractModel
         # @param ID: 文件标识符，可在各个API中引用。
@@ -1052,10 +1131,10 @@ module TencentCloud
 
         attr_accessor :Data, :FirstID, :LastID, :HasMore, :Object, :FirstMsgID, :LastMsgID, :RequestId
         extend Gem::Deprecate
-        deprecate :FirstID, :none, 2025, 12
-        deprecate :FirstID=, :none, 2025, 12
-        deprecate :LastID, :none, 2025, 12
-        deprecate :LastID=, :none, 2025, 12
+        deprecate :FirstID, :none, 2026, 1
+        deprecate :FirstID=, :none, 2026, 1
+        deprecate :LastID, :none, 2026, 1
+        deprecate :LastID=, :none, 2026, 1
 
         def initialize(data=nil, firstid=nil, lastid=nil, hasmore=nil, object=nil, firstmsgid=nil, lastmsgid=nil, requestid=nil)
           @Data = data
@@ -1680,6 +1759,26 @@ module TencentCloud
         end
       end
 
+      # 3D文件
+      class InputFile3D < TencentCloud::Common::AbstractModel
+        # @param Url: 文件的Url（有效期24小时）
+        # @type Url: String
+        # @param Type: 文件格式
+        # @type Type: String
+
+        attr_accessor :Url, :Type
+
+        def initialize(url=nil, type=nil)
+          @Url = url
+          @Type = type
+        end
+
+        def deserialize(params)
+          @Url = params['Url']
+          @Type = params['Type']
+        end
+      end
+
       # 外部知识
       class Knowledge < TencentCloud::Common::AbstractModel
         # @param Text: 表示具体的知识信息文本
@@ -1757,7 +1856,7 @@ module TencentCloud
         # @type Role: String
         # @param Content: 文本内容
         # @type Content: String
-        # @param Contents: 多种类型内容（目前支持图片和文本），仅 hunyuan-vision 和 hunyuan-turbo-vision 模型支持
+        # @param Contents: 多种类型内容（目前支持文本、图片和视频），图片支持混元图生文系列模型，视频支持混元视频生文系列模型，详情参考[产品概述](https://cloud.tencent.com/document/product/1729/104753)
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Contents: Array
         # @param ToolCallId: 当role为tool时传入，标识具体的函数调用
@@ -2466,6 +2565,58 @@ module TencentCloud
         end
       end
 
+      # Submit3DSmartTopologyJob请求参数结构体
+      class Submit3DSmartTopologyJobRequest < TencentCloud::Common::AbstractModel
+        # @param File3D: 源3D文件模型链接，参考值：
+        # Type：glb，obj格式文件必选其一。
+        # Url：文件大小不超过200MB。
+        # 3D模型要求：复杂模型和拓扑过的模型暂无法支持减面操作，建议输入未拓扑过的高模，比如混元3D生成的模型，适用度比较高的类别：硬表面、游戏角色、道具、日常生活用品等。
+        # @type File3D: :class:`Tencentcloud::Hunyuan.v20230901.models.InputFile3D`
+        # @param PolygonType: 多边形类型，表示模型的表面由几边形网格构成，默认为triangle,参考值:
+        # triangle:三角形面。
+        # quadrilateral：四边形面。
+        # @type PolygonType: String
+        # @param FaceLevel: 减面后面数档位类型，可选值：high，medium, low。
+        # @type FaceLevel: String
+
+        attr_accessor :File3D, :PolygonType, :FaceLevel
+
+        def initialize(file3d=nil, polygontype=nil, facelevel=nil)
+          @File3D = file3d
+          @PolygonType = polygontype
+          @FaceLevel = facelevel
+        end
+
+        def deserialize(params)
+          unless params['File3D'].nil?
+            @File3D = InputFile3D.new
+            @File3D.deserialize(params['File3D'])
+          end
+          @PolygonType = params['PolygonType']
+          @FaceLevel = params['FaceLevel']
+        end
+      end
+
+      # Submit3DSmartTopologyJob返回参数结构体
+      class Submit3DSmartTopologyJobResponse < 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
+
       # SubmitHunyuanImageChatJob请求参数结构体
       class SubmitHunyuanImageChatJobRequest < TencentCloud::Common::AbstractModel
         # @param Prompt: 本轮对话的文本描述。
@@ -3133,7 +3284,7 @@ module TencentCloud
 
       # 当type为video_frames时使用，标识具体的视频内图像帧内容
       class VideoFrames < TencentCloud::Common::AbstractModel
-        # @param Frames: 视频图像帧列表，图像帧传url
+        # @param Frames: 视频图像帧列表，图像帧传url，最大支持传入数量为512帧
         # @type Frames: Array
 
         attr_accessor :Frames
@@ -3149,7 +3300,7 @@ module TencentCloud
 
       # 当type为video_url时使用，标识具体的视频链接内容
       class VideoUrl < TencentCloud::Common::AbstractModel
-        # @param Url: 视频的url，如"https://your-video-path.mp/4"
+        # @param Url: 视频的url，如"https://your-video-path.mp4"，视频文件大小不超过100M。
         # @type Url: String
         # @param Fps: 控制视频抽帧频率，取值范围为 0.1 ~5，表示每隔 1/fps 秒抽取一帧，默认为 1s抽取一帧
         # @type Fps: Float

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-hunyuan
 version: !ruby/object:Gem::Version
-  version: 3.0.1180
+  version: 3.0.1205
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-09 00:00:00.000000000 Z
+date: 2026-01-21 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-hunyuan.rb
-- lib/v20230901/models.rb
 - lib/v20230901/client.rb
+- lib/v20230901/models.rb
+- lib/tencentcloud-sdk-hunyuan.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: