tencentcloud-sdk-hunyuan 3.0.1019 → 3.0.1021

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 93d0877f6e9d984d8cf2281c17a42fa1284a4b31
-  data.tar.gz: c48776a74044857a8d04f288e5ffa35b1bf53af8
+  metadata.gz: 7232016fecfac3d83c7da82e4cfa6e0d19508cd2
+  data.tar.gz: 7e274557beefa02c9aa4157793d45a50a334a22c
 SHA512:
-  metadata.gz: 9cd967dbdffdc425d3cbef5129735e5005586f43f9b552be4387c539fa413bc8ed189879628b34c227697d54b425be6a42c13fdfc0df7258b6ac87be5fd62620
-  data.tar.gz: e02ef19be9eae705659ea12e59edec9dda1cef0d5d06b5f83c94db995402720ae04b4924dfe6c292be3e2f42bdf8645940550b2b49ba2ff07851ea21fc215ddc
+  metadata.gz: 05808951dd90f19d48e6ee4c4c8a387fcdf30aa455a1b5bc338fc26466e7e5a2260be48c6f2e4e3beda52c2572b720b094d8882b1e6fa2f7e77d43961e131714
+  data.tar.gz: 0d6cc3bc8a5fdb054c38081b12b995e7baa73eb1475bcaedac32734ddadbaf41f75dea3342e8fa89f7c4c329c3de76656569e20a117254cbb5a611295f312949

data/lib/VERSION

@@ -1 +1 @@
-3.0.1019
+3.0.1021

data/lib/v20230901/client.rb

@@ -350,6 +350,37 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 如需使用OpenAI兼容接口， 请参考文档：[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1729/111007)
+
+        # 腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。
+
+        #  1. 本接口暂不支持返回图片内容。
+        #  2. 默认该接口下单账号限制并发数为  5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。
+        #  3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。SDK 链接在文档下方 “**开发者资源 - SDK**” 部分提供。
+        #  4. 我们推荐您使用 API Explorer，方便快速地在线调试接口和下载各语言的示例代码，[点击打开](https://console.cloud.tencent.com/api/explorer?Product=hunyuan&Version=2023-09-01&Action=ChatCompletions)。
+
+        # @param request: Request instance for GroupChatCompletions.
+        # @type request: :class:`Tencentcloud::hunyuan::V20230901::GroupChatCompletionsRequest`
+        # @rtype: :class:`Tencentcloud::hunyuan::V20230901::GroupChatCompletionsResponse`
+        def GroupChatCompletions(request)
+          body = send_request('GroupChatCompletions', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = GroupChatCompletionsResponse.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

@@ -49,6 +49,26 @@ module TencentCloud
         end
       end
 
+      # 人物描述
+      class Character < TencentCloud::Common::AbstractModel
+        # @param Name: 人物名称
+        # @type Name: String
+        # @param SystemPrompt: 人物对应SystemPrompt
+        # @type SystemPrompt: String
+
+        attr_accessor :Name, :SystemPrompt
+
+        def initialize(name=nil, systemprompt=nil)
+          @Name = name
+          @SystemPrompt = systemprompt
+        end
+
+        def deserialize(params)
+          @Name = params['Name']
+          @SystemPrompt = params['SystemPrompt']
+        end
+      end
+
       # ChatCompletions请求参数结构体
       class ChatCompletionsRequest < TencentCloud::Common::AbstractModel
         # @param Model: 模型名称，可选值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-code、hunyuan-role、hunyuan-functioncall、hunyuan-vision、hunyuan-turbo、hunyuan-turbo-latest、hunyuan-turbo-20241223、hunyuan-turbo-20241120、hunyuan-large、hunyuan-large-longcontext、hunyuan-turbo-vision、hunyuan-standard-vision、hunyuan-lite-vision、hunyuan-turbos-20250226、hunyuan-turbos-latest。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。
@@ -247,8 +267,8 @@ module TencentCloud
 
         attr_accessor :Created, :Usage, :Note, :Id, :Choices, :ErrorMsg, :ModerationLevel, :SearchInfo, :Replaces, :RecommendedQuestions, :RequestId
         extend Gem::Deprecate
-        deprecate :ModerationLevel, :none, 2025, 2
-        deprecate :ModerationLevel=, :none, 2025, 2
+        deprecate :ModerationLevel, :none, 2025, 3
+        deprecate :ModerationLevel=, :none, 2025, 3
 
         def initialize(created=nil, usage=nil, note=nil, id=nil, choices=nil, errormsg=nil, moderationlevel=nil, searchinfo=nil, replaces=nil, recommendedquestions=nil, requestid=nil)
           @Created = created
@@ -944,10 +964,10 @@ module TencentCloud
 
         attr_accessor :Data, :FirstID, :LastID, :HasMore, :Object, :FirstMsgID, :LastMsgID, :RequestId
         extend Gem::Deprecate
-        deprecate :FirstID, :none, 2025, 2
-        deprecate :FirstID=, :none, 2025, 2
-        deprecate :LastID, :none, 2025, 2
-        deprecate :LastID=, :none, 2025, 2
+        deprecate :FirstID, :none, 2025, 3
+        deprecate :FirstID=, :none, 2025, 3
+        deprecate :LastID, :none, 2025, 3
+        deprecate :LastID=, :none, 2025, 3
 
         def initialize(data=nil, firstid=nil, lastid=nil, hasmore=nil, object=nil, firstmsgid=nil, lastmsgid=nil, requestid=nil)
           @Data = data
@@ -1179,6 +1199,202 @@ module TencentCloud
         end
       end
 
+      # GroupChatCompletions请求参数结构体
+      class GroupChatCompletionsRequest < TencentCloud::Common::AbstractModel
+        # @param Model: 模型名称，可选值包括 hunyuan-large-role-group。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。
+        # @type Model: String
+        # @param Messages: 聊天上下文信息。
+        # @type Messages: Array
+        # @param Stream: 流式调用开关。
+        # 说明：
+        # 1. 未传值时默认为非流式调用（false）。
+        # 2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。
+        # 3. 非流式调用时：
+        # 调用方式与普通 HTTP 请求无异。
+        # 接口响应耗时较长，**如需更低时延建议设置为 true**。
+        # 只返回一次最终结果（返回值取 Choices[n].Message 中的值）。
+
+        # 注意：
+        # 通过 SDK 调用时，流式和非流式调用需用**不同的方式**获取返回值，具体参考 SDK 中的注释或示例（在各语言 SDK 代码仓库的 examples/hunyuan/v20230901/ 目录中）。
+        # @type Stream: Boolean
+        # @param TargetCharacterName: 目标人物名称
+        # @type TargetCharacterName: String
+        # @param GroupChatConfig: 角色描述
+        # @type GroupChatConfig: :class:`Tencentcloud::Hunyuan.v20230901.models.GroupChatConfig`
+        # @param UserId: 用户ID
+        # @type UserId: String
+        # @param SessionId: 对话接口
+        # @type SessionId: String
+
+        attr_accessor :Model, :Messages, :Stream, :TargetCharacterName, :GroupChatConfig, :UserId, :SessionId
+
+        def initialize(model=nil, messages=nil, stream=nil, targetcharactername=nil, groupchatconfig=nil, userid=nil, sessionid=nil)
+          @Model = model
+          @Messages = messages
+          @Stream = stream
+          @TargetCharacterName = targetcharactername
+          @GroupChatConfig = groupchatconfig
+          @UserId = userid
+          @SessionId = sessionid
+        end
+
+        def deserialize(params)
+          @Model = params['Model']
+          unless params['Messages'].nil?
+            @Messages = []
+            params['Messages'].each do |i|
+              groupmessage_tmp = GroupMessage.new
+              groupmessage_tmp.deserialize(i)
+              @Messages << groupmessage_tmp
+            end
+          end
+          @Stream = params['Stream']
+          @TargetCharacterName = params['TargetCharacterName']
+          unless params['GroupChatConfig'].nil?
+            @GroupChatConfig = GroupChatConfig.new
+            @GroupChatConfig.deserialize(params['GroupChatConfig'])
+          end
+          @UserId = params['UserId']
+          @SessionId = params['SessionId']
+        end
+      end
+
+      # GroupChatCompletions返回参数结构体
+      class GroupChatCompletionsResponse < TencentCloud::Common::AbstractModel
+        # @param Created: Unix 时间戳，单位为秒。
+        # @type Created: Integer
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
+        # @type Usage: :class:`Tencentcloud::Hunyuan.v20230901.models.Usage`
+        # @param Note: 免责声明。
+        # @type Note: String
+        # @param Id: 本次请求的 RequestId。
+        # @type Id: String
+        # @param Choices: 回复内容。
+        # @type Choices: Array
+        # @param ErrorMsg: 错误信息。
+        # 如果流式返回中服务处理异常，返回该错误信息。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ErrorMsg: :class:`Tencentcloud::Hunyuan.v20230901.models.ErrorMsg`
+        # @param SearchInfo: 搜索结果信息
+        # @type SearchInfo: :class:`Tencentcloud::Hunyuan.v20230901.models.SearchInfo`
+        # @param Replaces: 多媒体信息。
+        # 说明：
+        # 1. 可以用多媒体信息替换回复内容里的占位符，得到完整的消息。
+        # 2. 可能会出现回复内容里存在占位符，但是因为审核等原因没有返回多媒体信息。
+        # @type Replaces: Array
+        # @param RecommendedQuestions: 推荐问答。
+        # @type RecommendedQuestions: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+        # @type RequestId: String
+
+        attr_accessor :Created, :Usage, :Note, :Id, :Choices, :ErrorMsg, :SearchInfo, :Replaces, :RecommendedQuestions, :RequestId
+
+        def initialize(created=nil, usage=nil, note=nil, id=nil, choices=nil, errormsg=nil, searchinfo=nil, replaces=nil, recommendedquestions=nil, requestid=nil)
+          @Created = created
+          @Usage = usage
+          @Note = note
+          @Id = id
+          @Choices = choices
+          @ErrorMsg = errormsg
+          @SearchInfo = searchinfo
+          @Replaces = replaces
+          @RecommendedQuestions = recommendedquestions
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Created = params['Created']
+          unless params['Usage'].nil?
+            @Usage = Usage.new
+            @Usage.deserialize(params['Usage'])
+          end
+          @Note = params['Note']
+          @Id = params['Id']
+          unless params['Choices'].nil?
+            @Choices = []
+            params['Choices'].each do |i|
+              choice_tmp = Choice.new
+              choice_tmp.deserialize(i)
+              @Choices << choice_tmp
+            end
+          end
+          unless params['ErrorMsg'].nil?
+            @ErrorMsg = ErrorMsg.new
+            @ErrorMsg.deserialize(params['ErrorMsg'])
+          end
+          unless params['SearchInfo'].nil?
+            @SearchInfo = SearchInfo.new
+            @SearchInfo.deserialize(params['SearchInfo'])
+          end
+          unless params['Replaces'].nil?
+            @Replaces = []
+            params['Replaces'].each do |i|
+              replace_tmp = Replace.new
+              replace_tmp.deserialize(i)
+              @Replaces << replace_tmp
+            end
+          end
+          @RecommendedQuestions = params['RecommendedQuestions']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # 群聊配置
+      class GroupChatConfig < TencentCloud::Common::AbstractModel
+        # @param UserName: 人物名称
+        # @type UserName: String
+        # @param Description: ### 主题：\n武道修炼与科技创新的碰撞\n\n### 地点：\n布尔玛的实验室\n\n### 故事背景：\n布尔玛正在研发一种新型的龙珠雷达，旨在更精确地定位龙珠的位置。她邀请了孙悟空、天津饭、饺子和雅木茶前来测试新设备。然而，这些武道家们对科技的理解有限，导致了一系列有趣的误解和互动。\n\n### 人物关系：\n- **布尔玛**：天才科学家，负责研发和解释新设备。\n- **孙悟空**：纯粹的战斗狂，对科技一窍不通，但对新事物充满好奇。\n- **天津饭**：严肃自律的武道家，对科技持谨慎态度，但愿意尝试。\n- **饺子**：内向单纯，依赖天津饭，对科技感到困惑和害怕。\n- **雅木茶**：幽默自嘲的前沙漠强盗，对科技有一定了解，但更倾向于轻松调侃。\n\n### 人物目标：\n- **布尔玛**：希望新龙珠雷达能够得到有效测试，并得到反馈以改进。\n- **孙悟空**：希望通过新设备找到更强的对手进行战斗。\n- **天津饭**：希望通过测试新设备提升自己的武道修炼。\n- **饺子**：希望在不引起麻烦的情况下完成任务，并得到天津饭的认可。\n- **雅木茶**：希望通过参与测试证明自己的价值，同时享受与朋友们的互动。\n\n### 场景描述：\n布尔玛在实验室中展示她的新龙珠雷达，解释其工作原理和优势。孙悟空对设备的功能感到兴奋，但完全无法理解技术细节，不断提出天真的问题。天津饭则严肃地询问设备的安全性和可靠性，表现出对科技的谨慎态度。饺子对复杂的设备感到害怕，不断向天津饭寻求确认和安慰。雅木茶则在一旁调侃大家的反应，试图缓解紧张气氛。布尔玛在解释过程中不断被孙悟空的问题打断，感到无奈，但也被他的热情所感染。最终，大家决定一起外出测试新设备，展开一场充满欢笑和冒险的旅程。
+        # @type Description: String
+        # @param Characters: 角色描述
+        # @type Characters: Array
+
+        attr_accessor :UserName, :Description, :Characters
+
+        def initialize(username=nil, description=nil, characters=nil)
+          @UserName = username
+          @Description = description
+          @Characters = characters
+        end
+
+        def deserialize(params)
+          @UserName = params['UserName']
+          @Description = params['Description']
+          unless params['Characters'].nil?
+            @Characters = []
+            params['Characters'].each do |i|
+              character_tmp = Character.new
+              character_tmp.deserialize(i)
+              @Characters << character_tmp
+            end
+          end
+        end
+      end
+
+      # 群聊会话内容
+      class GroupMessage < TencentCloud::Common::AbstractModel
+        # @param Role: 角色，可选值包括 system、user、assistant、 tool。
+        # @type Role: String
+        # @param Content: 文本内容
+        # @type Content: String
+        # @param Name: 角色名称
+        # @type Name: String
+
+        attr_accessor :Role, :Content, :Name
+
+        def initialize(role=nil, content=nil, name=nil)
+          @Role = role
+          @Content = content
+          @Name = name
+        end
+
+        def deserialize(params)
+          @Role = params['Role']
+          @Content = params['Content']
+          @Name = params['Name']
+        end
+      end
+
       # 混元生图多轮对话历史记录。
       class History < TencentCloud::Common::AbstractModel
         # @param ChatId: 对话的 ID，用于唯一标识一轮对话
@@ -1211,6 +1427,26 @@ module TencentCloud
         end
       end
 
+      # 图片信息
+      class Image < TencentCloud::Common::AbstractModel
+        # @param ImageUrl: 图片Url。
+        # @type ImageUrl: String
+        # @param ImageBase64: 图片Base64。
+        # @type ImageBase64: String
+
+        attr_accessor :ImageUrl, :ImageBase64
+
+        def initialize(imageurl=nil, imagebase64=nil)
+          @ImageUrl = imageurl
+          @ImageBase64 = imagebase64
+        end
+
+        def deserialize(params)
+          @ImageUrl = params['ImageUrl']
+          @ImageBase64 = params['ImageBase64']
+        end
+      end
+
       # 具体的图片内容
       class ImageUrl < TencentCloud::Common::AbstractModel
         # @param Url: 图片的 Url（以 http:// 或 https:// 开头）
@@ -1999,23 +2235,29 @@ module TencentCloud
         # @type Style: String
         # @param Resolution: 生成图分辨率。
         # 支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3），不传默认使用1024:1024。
+        # 如果上传 ContentImage 参考图，分辨率仅支持：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1），不传将自动适配分辨率。如果参考图被用于做风格转换，将生成保持原图长宽比例且长边为1024的图片，指定的分辨率不生效。
         # @type Resolution: String
         # @param Num: 图片生成数量。
         # 支持1 ~ 4张，默认生成1张。
         # @type Num: Integer
-        # @param Seed: 随机种子，默认随机。
-        # 不传：随机种子生成。
-        # 正数：固定种子生成。
-        # @type Seed: Integer
         # @param Clarity: 超分选项，默认不做超分，可选开启。
         #  x2：2倍超分
         #  x4：4倍超分
+        # 在 Resolution 的基础上按比例提高分辨率，例如1024:1024开启2倍超分后将得到2048:2048。
         # @type Clarity: String
+        # @param ContentImage: 用于引导内容的参考图。
+        # 图片限制：单边分辨率小于5000，转成 Base64 字符串后小于 8MB，格式支持 jpg、jpeg、png、bmp、tiff、webp。
+        # @type ContentImage: :class:`Tencentcloud::Hunyuan.v20230901.models.Image`
         # @param Revise: prompt 扩写开关。1为开启，0为关闭，不传默认开启。
         # 开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。
-        # 如果关闭扩写，将直接使用原始输入的 prompt 生成图片。
+        # 如果关闭扩写，将直接使用原始输入的 prompt 生成图片。如果上传了参考图，扩写关闭不生效，将保持开启。
         # 建议开启，在多数场景下可提升生成图片效果、丰富生成图片细节。
         # @type Revise: Integer
+        # @param Seed: 随机种子，默认随机。
+        # 不传：随机种子生成。
+        # 正数：固定种子生成。
+        # 扩写开启时固定种子不生效，将保持随机。
+        # @type Seed: Integer
         # @param LogoAdd: 为生成结果图添加显式水印标识的开关，默认为1。
         # 1：添加。
         # 0：不添加。
@@ -2026,17 +2268,18 @@ module TencentCloud
         # 默认在生成结果图右下角添加“图片由 AI 生成”字样，您可根据自身需要替换为其他的标识图片。
         # @type LogoParam: :class:`Tencentcloud::Hunyuan.v20230901.models.LogoParam`
 
-        attr_accessor :Prompt, :NegativePrompt, :Style, :Resolution, :Num, :Seed, :Clarity, :Revise, :LogoAdd, :LogoParam
+        attr_accessor :Prompt, :NegativePrompt, :Style, :Resolution, :Num, :Clarity, :ContentImage, :Revise, :Seed, :LogoAdd, :LogoParam
 
-        def initialize(prompt=nil, negativeprompt=nil, style=nil, resolution=nil, num=nil, seed=nil, clarity=nil, revise=nil, logoadd=nil, logoparam=nil)
+        def initialize(prompt=nil, negativeprompt=nil, style=nil, resolution=nil, num=nil, clarity=nil, contentimage=nil, revise=nil, seed=nil, logoadd=nil, logoparam=nil)
           @Prompt = prompt
           @NegativePrompt = negativeprompt
           @Style = style
           @Resolution = resolution
           @Num = num
-          @Seed = seed
           @Clarity = clarity
+          @ContentImage = contentimage
           @Revise = revise
+          @Seed = seed
           @LogoAdd = logoadd
           @LogoParam = logoparam
         end
@@ -2047,9 +2290,13 @@ module TencentCloud
           @Style = params['Style']
           @Resolution = params['Resolution']
           @Num = params['Num']
-          @Seed = params['Seed']
           @Clarity = params['Clarity']
+          unless params['ContentImage'].nil?
+            @ContentImage = Image.new
+            @ContentImage.deserialize(params['ContentImage'])
+          end
           @Revise = params['Revise']
+          @Seed = params['Seed']
           @LogoAdd = params['LogoAdd']
           unless params['LogoParam'].nil?
             @LogoParam = LogoParam.new

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-hunyuan
 version: !ruby/object:Gem::Version
-  version: 3.0.1019
+  version: 3.0.1021
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-14 00:00:00.000000000 Z
+date: 2025-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common