tencentcloud-sdk-python 3.0.1127__py2.py3-none-any.whl → 3.0.1128__py2.py3-none-any.whl

tencentcloud/hunyuan/v20230901/hunyuan_client.py

@@ -27,11 +27,11 @@ class HunyuanClient(AbstractClient):
 
 
     def ChatPro(self, request):
-        """腾讯混元大模型高级版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为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.models.ChatProRequest`
@@ -49,11 +49,11 @@ class HunyuanClient(AbstractClient):
 
 
     def ChatStd(self, request):
-        """腾讯混元大模型标准版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为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.models.ChatStdRequest`

tencentcloud/hunyuan/v20230901/models.py

@@ -27,24 +27,43 @@ class ChatProRequest(AbstractModel):
         r"""
         :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: list of Message
         :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: bool
+        :param _StreamModeration: 流式输出审核开关。
+说明：
+1. 当 Stream 字段值为 true 时，该字段有效。
+2. 未传值时默认不使用流式输出审核。
+3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
+
+注意：
+当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+        :type StreamModeration: bool
         """
         self._Messages = None
         self._TopP = None
         self._Temperature = None
+        self._Stream = None
+        self._StreamModeration = None
 
     @property
     def Messages(self):
@@ -70,6 +89,22 @@ class ChatProRequest(AbstractModel):
     def Temperature(self, Temperature):
         self._Temperature = Temperature
 
+    @property
+    def Stream(self):
+        return self._Stream
+
+    @Stream.setter
+    def Stream(self, Stream):
+        self._Stream = Stream
+
+    @property
+    def StreamModeration(self):
+        return self._StreamModeration
+
+    @StreamModeration.setter
+    def StreamModeration(self, StreamModeration):
+        self._StreamModeration = StreamModeration
+
 
     def _deserialize(self, params):
         if params.get("Messages") is not None:
@@ -80,6 +115,8 @@ class ChatProRequest(AbstractModel):
                 self._Messages.append(obj)
         self._TopP = params.get("TopP")
         self._Temperature = params.get("Temperature")
+        self._Stream = params.get("Stream")
+        self._StreamModeration = params.get("StreamModeration")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -97,14 +134,14 @@ class ChatProResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Created: unix 时间戳，单位为秒。
+        :param _Created: Unix 时间戳，单位为秒。
         :type Created: int
-        :param _Usage: token统计信息。
-按照总token数量计费。
+        :param _Usage: Token 统计信息。
+按照总 Token 数量计费。
         :type Usage: :class:`tencentcloud.hunyuan.v20230901.models.Usage`
         :param _Note: 免责声明。
         :type Note: str
-        :param _Id: 本轮对话的id。
+        :param _Id: 本轮对话的 ID。
         :type Id: str
         :param _Choices: 回复内容。
         :type Choices: list of Choice
@@ -208,24 +245,44 @@ class ChatStdRequest(AbstractModel):
         r"""
         :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: list of Message
         :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: bool
+        :param _StreamModeration: 流式输出审核开关。
+说明：
+1. 当 Stream 字段值为 true 时，该字段有效。
+2. 未传值时默认不使用流式输出审核。
+3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
+
+注意：
+当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+        :type StreamModeration: bool
         """
         self._Messages = None
         self._TopP = None
         self._Temperature = None
+        self._Stream = None
+        self._StreamModeration = None
 
     @property
     def Messages(self):
@@ -251,6 +308,22 @@ class ChatStdRequest(AbstractModel):
     def Temperature(self, Temperature):
         self._Temperature = Temperature
 
+    @property
+    def Stream(self):
+        return self._Stream
+
+    @Stream.setter
+    def Stream(self, Stream):
+        self._Stream = Stream
+
+    @property
+    def StreamModeration(self):
+        return self._StreamModeration
+
+    @StreamModeration.setter
+    def StreamModeration(self, StreamModeration):
+        self._StreamModeration = StreamModeration
+
 
     def _deserialize(self, params):
         if params.get("Messages") is not None:
@@ -261,6 +334,8 @@ class ChatStdRequest(AbstractModel):
                 self._Messages.append(obj)
         self._TopP = params.get("TopP")
         self._Temperature = params.get("Temperature")
+        self._Stream = params.get("Stream")
+        self._StreamModeration = params.get("StreamModeration")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -278,14 +353,14 @@ class ChatStdResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Created: unix 时间戳，单位为秒。
+        :param _Created: Unix 时间戳，单位为秒。
         :type Created: int
-        :param _Usage: token统计信息。
-按照总token数量计费。
+        :param _Usage: Token 统计信息。
+按照总 Token 数量计费。
         :type Usage: :class:`tencentcloud.hunyuan.v20230901.models.Usage`
         :param _Note: 免责声明。
         :type Note: str
-        :param _Id: 本轮对话的id。
+        :param _Id: 本轮对话的 ID。
         :type Id: str
         :param _Choices: 回复内容。
         :type Choices: list of Choice
@@ -387,13 +462,18 @@ class Choice(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FinishReason: 流式结束标志位，为 stop 则表示尾包。
+        :param _FinishReason: 结束标志位，为 stop 则表示尾包。
         :type FinishReason: str
-        :param _Delta: 返回值。
+        :param _Delta: 增量返回值，流式调用时使用该字段。
+注意：此字段可能返回 null，表示取不到有效值。
         :type Delta: :class:`tencentcloud.hunyuan.v20230901.models.Delta`
+        :param _Message: 返回值，非流式调用时使用该字段。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type Message: :class:`tencentcloud.hunyuan.v20230901.models.Message`
         """
         self._FinishReason = None
         self._Delta = None
+        self._Message = None
 
     @property
     def FinishReason(self):
@@ -411,12 +491,23 @@ class Choice(AbstractModel):
     def Delta(self, Delta):
         self._Delta = Delta
 
+    @property
+    def Message(self):
+        return self._Message
+
+    @Message.setter
+    def Message(self, Message):
+        self._Message = Message
+
 
     def _deserialize(self, params):
         self._FinishReason = params.get("FinishReason")
         if params.get("Delta") is not None:
             self._Delta = Delta()
             self._Delta._deserialize(params.get("Delta"))
+        if params.get("Message") is not None:
+            self._Message = Message()
+            self._Message._deserialize(params.get("Message"))
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -809,7 +900,7 @@ class GetTokenCountResponse(AbstractModel):
 
 
 class Message(AbstractModel):
-    """会话内容,  按对话时间序排列，长度最多为40
+    """单条消息
 
     """
 
@@ -817,7 +908,7 @@ class Message(AbstractModel):
         r"""
         :param _Role: 角色
         :type Role: str
-        :param _Content: 消息的内容
+        :param _Content: 消息内容
         :type Content: str
         """
         self._Role = None

tencentcloud/lke/v20231130/errorcodes.py

@@ -0,0 +1,30 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# 操作失败。
+FAILEDOPERATION = 'FailedOperation'
+
+# 内部错误。
+INTERNALERROR = 'InternalError'
+
+# 参数错误。
+INVALIDPARAMETER = 'InvalidParameter'
+
+# 超过配额限制。
+LIMITEXCEEDED = 'LimitExceeded'
+
+# 请求的次数超过了频率限制。
+REQUESTLIMITEXCEEDED = 'RequestLimitExceeded'