tencentcloud-sdk-hunyuan 3.0.801 → 3.0.802

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7295f15a07c2519214c6e23aac6b38157bda3ece
-  data.tar.gz: 7d2ef2d513669de4654c0b2454bcae539235bfb9
+  metadata.gz: c98c12ddc03019ff11f454abdb6eac142e80173b
+  data.tar.gz: eff401bf438fe42c4bffa7195bcdb41ed1329505
 SHA512:
-  metadata.gz: 60a6971fd57c44e12cf1108fcd466ae30701cec116e77de80c2a5d92735588e1f035fc72224b3f1109d6f32a1b6bbedad6a8a6810a17f74b79c6007dd073a2b7
-  data.tar.gz: 07c56084c22a1e0ee50796bb45102ace87034c9a1c0ca5b8f37ba156d71b1cc50fbfd15a6dc6003808407f67b52939bce70074aee775373b533694a3bc9cc4dc
+  metadata.gz: d8d1f881c3b0df2df12f9473f968dc9ca9ce2caf2dfe6d3fbf0a7988f70fe24970c86a07a3254249dcc7d7775dc1973cb46cc3ae13576ce7c89f98bb93fb434c
+  data.tar.gz: cc0897bebe42909c632ef3e7a3d38eba5ebe5e79920a0b7d37393f7d1119e30eb3f8a445ae3e6bb43e84f764f8661adf6884ed425ca4979b762f3fa6441d914c

data/lib/VERSION

@@ -1 +1 @@
-3.0.801
+3.0.802

data/lib/v20230901/client.rb

@@ -29,11 +29,11 @@ module TencentCloud
         end
 
 
-        # 腾讯混元大模型高级版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为SSE协议。
+        # 腾讯混元大模型高级版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。
 
-        #  1.本接口暂不支持返回图片内容。
-        #  2.默认单账号限制并发数为5路，如您有提高并发限制的需求请 [联系我们](https://cloud.tencent.com/act/event/Online_service) 。
-        #  3.请使用SDK调用本接口 ，每种开发语言的SDK GitHub仓库examples/hunyuan/v20230901/目录下有提供示例供参考。
+        #  1. 本接口暂不支持返回图片内容。
+        #  2. 默认单账号限制并发数为 5 路，如您有提高并发限制的需求请 [联系我们](https://cloud.tencent.com/act/event/Online_service) 。
+        #  3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。
 
         # @param request: Request instance for ChatPro.
         # @type request: :class:`Tencentcloud::hunyuan::V20230901::ChatProRequest`
@@ -57,11 +57,11 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 腾讯混元大模型标准版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为SSE协议。
+        # 腾讯混元大模型标准版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。
 
-        #  1.本接口暂不支持返回图片内容。
-        #  2.默认单账号限制并发数为5路，如您有提高并发限制的需求请 [联系我们](https://cloud.tencent.com/act/event/Online_service) 。
-        #  3.请使用SDK调用本接口 ，每种开发语言的SDK GitHub仓库examples/hunyuan/v20230901/目录下有提供示例供参考。
+        #  1. 本接口暂不支持返回图片内容。
+        #  2. 默认单账号限制并发数为 5 路，如您有提高并发限制的需求请 [联系我们](https://cloud.tencent.com/act/event/Online_service) 。
+        #  3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。
 
         # @param request: Request instance for ChatStd.
         # @type request: :class:`Tencentcloud::hunyuan::V20230901::ChatStdRequest`

data/lib/v20230901/models.rb

@@ -21,27 +21,46 @@ module TencentCloud
       class ChatProRequest < TencentCloud::Common::AbstractModel
         # @param Messages: 聊天上下文信息。
         # 说明：
-        # 1.长度最多为40, 按对话时间从旧到新在数组中排列。
-        # 2.Message的Role当前可选值：system、user、assistant，其中，system角色是可选的，如果存在，必须位于列表的最开始。user和assistant需要交替出现(一问一答)，最后一个为user提问, 且Content不能为空。
-        # 3.Messages中Content总长度不超过16000 token，超过则会截断最前面的内容，只保留尾部内容。建议不超过4000 token。
+        # 1. 长度最多为 40，按对话时间从旧到新在数组中排列。
+        # 2. Message 的 Role 当前可选值：system、user、assistant。其中，system 角色是可选的，如果存在，必须位于列表的最开始。此外，user 和 assistant 需交替出现（一问一答），以 user 提问开始和结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。
+        # 3. Messages 中 Content 总长度不超过 16000 Token，超过则会截断最前面的内容，只保留尾部内容。建议不超过 4000 Token。
         # @type Messages: Array
         # @param TopP: 说明：
-        # 1.影响输出文本的多样性，取值越大，生成文本的多样性越强。
-        # 2.默认1.0，取值区间为[0.0, 1.0]。
-        # 3.非必要不建议使用, 不合理的取值会影响效果。
+        # 1. 影响输出文本的多样性，取值越大，生成文本的多样性越强。
+        # 2. 默认 1.0，取值区间为 [0.0, 1.0]。
+        # 3. 非必要不建议使用，不合理的取值会影响效果。
         # @type TopP: Float
         # @param Temperature: 说明：
-        # 1.较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
-        # 2.默认1.0，取值区间为[0.0，2.0]。
-        # 3.非必要不建议使用,不合理的取值会影响效果。
+        # 1. 较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
+        # 2. 默认 1.0，取值区间为 [0.0，2.0]。
+        # 3. 非必要不建议使用，不合理的取值会影响效果。
         # @type Temperature: Float
+        # @param Stream: 流式调用开关。
+        # 说明：
+        # 1. 未传值时默认为流式调用。
+        # 2. 流式调用时以 SSE 协议增量返回结果。
+        # 3. 非流式调用时接口响应耗时较长，非必要不建议使用。
+        # 4. 非流式调用时只返回一次最终结果，调用方式与普通 HTTP 请求无异。
+        # @type Stream: Boolean
+        # @param StreamModeration: 流式输出审核开关。
+        # 说明：
+        # 1. 当 Stream 字段值为 true 时，该字段有效。
+        # 2. 未传值时默认不使用流式输出审核。
+        # 3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+        # 4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
+
+        # 注意：
+        # 当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+        # @type StreamModeration: Boolean
 
-        attr_accessor :Messages, :TopP, :Temperature
+        attr_accessor :Messages, :TopP, :Temperature, :Stream, :StreamModeration
 
-        def initialize(messages=nil, topp=nil, temperature=nil)
+        def initialize(messages=nil, topp=nil, temperature=nil, stream=nil, streammoderation=nil)
           @Messages = messages
           @TopP = topp
           @Temperature = temperature
+          @Stream = stream
+          @StreamModeration = streammoderation
         end
 
         def deserialize(params)
@@ -55,19 +74,21 @@ module TencentCloud
           end
           @TopP = params['TopP']
           @Temperature = params['Temperature']
+          @Stream = params['Stream']
+          @StreamModeration = params['StreamModeration']
         end
       end
 
       # ChatPro返回参数结构体
       class ChatProResponse < TencentCloud::Common::AbstractModel
-        # @param Created: unix 时间戳，单位为秒。
+        # @param Created: Unix 时间戳，单位为秒。
         # @type Created: Integer
-        # @param Usage: token统计信息。
-        # 按照总token数量计费。
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
         # @type Usage: :class:`Tencentcloud::Hunyuan.v20230901.models.Usage`
         # @param Note: 免责声明。
         # @type Note: String
-        # @param Id: 本轮对话的id。
+        # @param Id: 本轮对话的 ID。
         # @type Id: String
         # @param Choices: 回复内容。
         # @type Choices: Array
@@ -118,27 +139,46 @@ module TencentCloud
       class ChatStdRequest < TencentCloud::Common::AbstractModel
         # @param Messages: 聊天上下文信息。
         # 说明：
-        # 1.长度最多为40, 按对话时间从旧到新在数组中排列。
-        # 2.Message的Role当前可选值：user、assistant，其中，user和assistant需要交替出现(一问一答)，最后一个为user提问, 且Content不能为空。
-        # 3.Messages中Content总长度不超过16000 token，超过则会截断最前面的内容，只保留尾部内容。建议不超过4000 token。
+        # 1. 长度最多为 40，按对话时间从旧到新在数组中排列。
+        # 2. Message 的 Role 当前可选值：user、assistant。其中，user 和 assistant 需交替出现（一问一答），以 user 提问开始和结束，且 Content 不能为空。Role 的顺序示例：[user assistant user assistant user ...]。
+        # 3. Messages 中 Content 总长度不超过 16000 Token，超过则会截断最前面的内容，只保留尾部内容。建议不超过 4000 Token。
         # @type Messages: Array
         # @param TopP: 说明：
-        # 1.影响输出文本的多样性，取值越大，生成文本的多样性越强。
-        # 2.默认1.0，取值区间为[0.0, 1.0]。
-        # 3.非必要不建议使用, 不合理的取值会影响效果。
+        # 1. 影响输出文本的多样性，取值越大，生成文本的多样性越强。
+        # 2. 默认 1.0，取值区间为 [0.0, 1.0]。
+        # 3. 非必要不建议使用，不合理的取值会影响效果。
         # @type TopP: Float
         # @param Temperature: 说明：
-        # 1.较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
-        # 2.默认1.0，取值区间为[0.0，2.0]。
-        # 3.非必要不建议使用,不合理的取值会影响效果。
+        # 1. 较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
+        # 2. 默认 1.0，取值区间为 [0.0，2.0]。
+        # 3. 非必要不建议使用，不合理的取值会影响效果。
         # @type Temperature: Float
+        # @param Stream: 流式调用开关。
+        # 说明：
+        # 1. 未传值时默认为流式调用。
+        # 2. 流式调用时以 SSE 协议增量返回结果。
+        # 3. 非流式调用时接口响应耗时较长，非必要不建议使用。
+        # 4. 非流式调用时只返回一次最终结果，调用方式与普通 HTTP 请求无异。
+        # @type Stream: Boolean
+        # @param StreamModeration: 流式输出审核开关。
+        # 说明：
+        # 1. 当 Stream 字段值为 true 时，该字段有效。
+        # 2. 未传值时默认不使用流式输出审核。
+        # 3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+        # 4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
 
-        attr_accessor :Messages, :TopP, :Temperature
+        # 注意：
+        # 当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+        # @type StreamModeration: Boolean
 
-        def initialize(messages=nil, topp=nil, temperature=nil)
+        attr_accessor :Messages, :TopP, :Temperature, :Stream, :StreamModeration
+
+        def initialize(messages=nil, topp=nil, temperature=nil, stream=nil, streammoderation=nil)
           @Messages = messages
           @TopP = topp
           @Temperature = temperature
+          @Stream = stream
+          @StreamModeration = streammoderation
         end
 
         def deserialize(params)
@@ -152,19 +192,21 @@ module TencentCloud
           end
           @TopP = params['TopP']
           @Temperature = params['Temperature']
+          @Stream = params['Stream']
+          @StreamModeration = params['StreamModeration']
         end
       end
 
       # ChatStd返回参数结构体
       class ChatStdResponse < TencentCloud::Common::AbstractModel
-        # @param Created: unix 时间戳，单位为秒。
+        # @param Created: Unix 时间戳，单位为秒。
         # @type Created: Integer
-        # @param Usage: token统计信息。
-        # 按照总token数量计费。
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
         # @type Usage: :class:`Tencentcloud::Hunyuan.v20230901.models.Usage`
         # @param Note: 免责声明。
         # @type Note: String
-        # @param Id: 本轮对话的id。
+        # @param Id: 本轮对话的 ID。
         # @type Id: String
         # @param Choices: 回复内容。
         # @type Choices: Array
@@ -213,16 +255,21 @@ module TencentCloud
 
       # 返回的回复, 支持多个
       class Choice < TencentCloud::Common::AbstractModel
-        # @param FinishReason: 流式结束标志位，为 stop 则表示尾包。
+        # @param FinishReason: 结束标志位，为 stop 则表示尾包。
         # @type FinishReason: String
-        # @param Delta: 返回值。
+        # @param Delta: 增量返回值，流式调用时使用该字段。
+        # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Delta: :class:`Tencentcloud::Hunyuan.v20230901.models.Delta`
+        # @param Message: 返回值，非流式调用时使用该字段。
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type Message: :class:`Tencentcloud::Hunyuan.v20230901.models.Message`
 
-        attr_accessor :FinishReason, :Delta
+        attr_accessor :FinishReason, :Delta, :Message
 
-        def initialize(finishreason=nil, delta=nil)
+        def initialize(finishreason=nil, delta=nil, message=nil)
           @FinishReason = finishreason
           @Delta = delta
+          @Message = message
         end
 
         def deserialize(params)
@@ -231,6 +278,10 @@ module TencentCloud
             @Delta = Delta.new
             @Delta.deserialize(params['Delta'])
           end
+          unless params['Message'].nil?
+            @Message = Message.new
+            @Message.deserialize(params['Message'])
+          end
         end
       end
 
@@ -417,11 +468,11 @@ module TencentCloud
         end
       end
 
-      # 会话内容,  按对话时间序排列，长度最多为40
+      # 单条消息
       class Message < TencentCloud::Common::AbstractModel
         # @param Role: 角色
         # @type Role: String
-        # @param Content: 消息的内容
+        # @param Content: 消息内容
         # @type Content: String
 
         attr_accessor :Role, :Content

metadata

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