tencentcloud-sdk-hunyuan 3.0.925 → 3.0.926

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c987c90690d878a11f0fd647a855bb9f2eabad8f
-  data.tar.gz: 0e523b0073002bc19b82c42bee6f2a0e329720c0
+  metadata.gz: 8891368c75731431a54d6c2fb2fe6c9c35159bf9
+  data.tar.gz: f352ccc8a281c4ee9a989045702c0611e22c2c7e
 SHA512:
-  metadata.gz: 4a9b2fac5ef63b17b18e0fb584bd4c6f04f812b8a1cac17d1df2e71d77700c61d4391a1947186b69b44ada059ab4f95662ed969b7749abb710735f0b96df0943
-  data.tar.gz: c5278e538722ed0a11a7f27399ebb954e7385a2afd8d8bb3f1b7eac2aa57b83406b652ce45a4c8e9524d46dcda3bfc245170ac60e73b3ce051c92a11d34fedf8
+  metadata.gz: 5b02b1c5236635f8a5b19cf3a4baa43f1dfc9c12d718c910726d0ffc179ac7c180d918e3ed116b807d57d00ec2aa3790042ee1e1f43fa1492bca736b6d3f5d56
+  data.tar.gz: 3302dee95a8cccc20cdeeeaa7f68ad5b9e7c470bd620fa10604677f24a4172265e57ac661a23cd8bb63da78da99fe13da207371d579a164d52da601a8cd3731c

data/lib/VERSION

@@ -1 +1 @@
-3.0.925
+3.0.926

data/lib/v20230901/models.rb

@@ -60,8 +60,8 @@ module TencentCloud
         # @param Messages: 聊天上下文信息。
         # 说明：
         # 1. 长度最多为 40，按对话时间从旧到新在数组中排列。
-        # 2. Message.Role 可选值：system、user、assistant、 tool。
-        # 其中，system 角色可选，如存在则必须位于列表的最开始。user（tool） 和 assistant 需交替出现（一问一答），以 user 提问开始，user（tool）提问结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。
+        # 2. Message.Role 可选值：system、user、assistant、 tool（functioncall场景）。
+        # 其中，system 角色可选，如存在则必须位于列表的最开始。user（tool） 和 assistant 需交替出现（一问一答），以 user 提问开始，user（tool）提问结束，其中tool可以连续出现多次，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user（tool tool ...） assistant user（tool tool ...） ...]。
         # 3. Messages 中 Content 总长度不能超过模型输入长度上限（可参考 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 文档），超过则会截断最前面的内容，只保留尾部内容。
         # @type Messages: Array
         # @param Stream: 流式调用开关。
@@ -121,13 +121,14 @@ module TencentCloud
         # @type Citation: Boolean
         # @param EnableSpeedSearch: 是否开启极速版搜索，默认false，不开启；在开启且命中搜索时，会启用极速版搜索，流式输出首字返回更快。
         # @type EnableSpeedSearch: Boolean
-        # @param EnableMultimedia: 图文并茂开关。
-        # 详细介绍请阅读 [图文并茂](https://cloud.tencent.com/document/product/1729/111178) 中的说明。
+        # @param EnableMultimedia: 多媒体开关。
+        # 详细介绍请阅读 [多媒体介绍](https://cloud.tencent.com/document/product/1729/111178) 中的说明。
         # 说明：
-        # 1. 该参数仅在功能增强（如搜索）开关开启（EnableEnhancement=true）时生效。
-        # 2. hunyuan-lite 无图文并茂能力，该参数对 hunyuan-lite 版本不生效。
-        # 3. 未传值时默认关闭。
-        # 4. 开启并搜索到对应的多媒体信息时，会输出对应的多媒体地址，可以定制个性化的图文消息。
+        # 1. 该参数目前仅对白名单内用户生效，如您想体验该功能请 [联系我们](https://cloud.tencent.com/act/event/Online_service)。
+        # 2. 该参数仅在功能增强（如搜索）开关开启（EnableEnhancement=true）并且极速版搜索开关关闭（EnableSpeedSearch=false）时生效。
+        # 3. hunyuan-lite 无多媒体能力，该参数对 hunyuan-lite 版本不生效。
+        # 4. 未传值时默认关闭。
+        # 5. 开启并搜索到对应的多媒体信息时，会输出对应的多媒体地址，可以定制个性化的图文消息。
         # @type EnableMultimedia: Boolean
 
         attr_accessor :Model, :Messages, :Stream, :StreamModeration, :TopP, :Temperature, :EnableEnhancement, :Tools, :ToolChoice, :CustomTool, :SearchInfo, :Citation, :EnableSpeedSearch, :EnableMultimedia
@@ -207,7 +208,7 @@ module TencentCloud
         # @type SearchInfo: :class:`Tencentcloud::Hunyuan.v20230901.models.SearchInfo`
         # @param Replaces: 多媒体信息。
         # 说明：
-        # 1. 可以用多媒体信息替换回复内容里的占位符，得到完整的图文信息。
+        # 1. 可以用多媒体信息替换回复内容里的占位符，得到完整的消息。
         # 2. 可能会出现回复内容里存在占位符，但是因为审核等原因没有返回多媒体信息。
         # @type Replaces: Array
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
@@ -684,27 +685,64 @@ module TencentCloud
         end
       end
 
-      # 图文并茂详情
+      # 多媒体详情
       class Multimedia < TencentCloud::Common::AbstractModel
-        # @param Type: 多媒体类型，image：图片。
+        # @param Type: 多媒体类型，可选值包括 image、music、album、playlist。
+        # 说明：
+        # 1. image：图片；music：单曲，类型为单曲时，会返回详细歌手和歌曲信息；album：专辑；playlist：歌单。
+        # 2. 当 type 为 music、album、playlist 时，需要配合 [QQ音乐SDK](https://developer.y.qq.com/) 使用。
         # @type Type: String
-        # @param Url: 多媒体预览地址。
+        # @param Url: 多媒体地址。
+        # 说明：
+        # 1. type 为 image 时，地址为图片的预览地址；其他类型时，地址为封面图地址。
         # @type Url: String
         # @param JumpUrl: 多媒体详情地址。
+        # 说明：
+        # 1. 仅 type 为 image 时，该字段有值。
+        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type JumpUrl: String
+        # @param Title: 名称。
+        # 说明：
+        # 1. type 为 image 时，该字段为空。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Title: String
+        # @param Desc: 描述。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Desc: String
+        # @param Singer: 歌手名称。
+        # 说明：
+        # 1. 仅 type 为 music 时，该字段有值。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Singer: String
+        # @param Ext: 歌曲详情。
+        # 说明：
+        # 1. 仅 type 为 music 时，该字段有值。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Ext: :class:`Tencentcloud::Hunyuan.v20230901.models.SongExt`
 
-        attr_accessor :Type, :Url, :JumpUrl
+        attr_accessor :Type, :Url, :JumpUrl, :Title, :Desc, :Singer, :Ext
 
-        def initialize(type=nil, url=nil, jumpurl=nil)
+        def initialize(type=nil, url=nil, jumpurl=nil, title=nil, desc=nil, singer=nil, ext=nil)
           @Type = type
           @Url = url
           @JumpUrl = jumpurl
+          @Title = title
+          @Desc = desc
+          @Singer = singer
+          @Ext = ext
         end
 
         def deserialize(params)
           @Type = params['Type']
           @Url = params['Url']
           @JumpUrl = params['JumpUrl']
+          @Title = params['Title']
+          @Desc = params['Desc']
+          @Singer = params['Singer']
+          unless params['Ext'].nil?
+            @Ext = SongExt.new
+            @Ext.deserialize(params['Ext'])
+          end
         end
       end
 
@@ -843,7 +881,7 @@ module TencentCloud
         end
       end
 
-      # 图文并茂占位符替换信息
+      # 多媒体占位符替换信息
       class Replace < TencentCloud::Common::AbstractModel
         # @param Id: 占位符序号
         # @type Id: String
@@ -953,6 +991,30 @@ module TencentCloud
         end
       end
 
+      # 歌曲详情。具体含义参考  [QQ音乐SDK](https://developer.y.qq.com/)
+      class SongExt < TencentCloud::Common::AbstractModel
+        # @param SongId: 歌曲id
+        # @type SongId: Integer
+        # @param SongMid: 歌曲mid
+        # @type SongMid: String
+        # @param Vip: 歌曲是否为vip。1：vip歌曲； 0：普通歌曲。
+        # @type Vip: Integer
+
+        attr_accessor :SongId, :SongMid, :Vip
+
+        def initialize(songid=nil, songmid=nil, vip=nil)
+          @SongId = songid
+          @SongMid = songmid
+          @Vip = vip
+        end
+
+        def deserialize(params)
+          @SongId = params['SongId']
+          @SongMid = params['SongMid']
+          @Vip = params['Vip']
+        end
+      end
+
       # SubmitHunyuanImageChatJob请求参数结构体
       class SubmitHunyuanImageChatJobRequest < TencentCloud::Common::AbstractModel
         # @param Prompt: 本轮对话的文本描述。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-hunyuan
 version: !ruby/object:Gem::Version
-  version: 3.0.925
+  version: 3.0.926
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-16 00:00:00.000000000 Z
+date: 2024-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common