tencentcloud-sdk-python 3.0.1312__tar.gz → 3.0.1313__tar.gz

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python
-Version: 3.0.1312
+Version: 3.0.1313
 Summary: Tencent Cloud SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1312'
+__version__ = '3.0.1313'

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/tencentcloud/lkeap/v20240522/errorcodes.py

@@ -20,6 +20,9 @@ FAILEDOPERATION = 'FailedOperation'
 # FailedOperation.DownLoadError
 FAILEDOPERATION_DOWNLOADERROR = 'FailedOperation.DownLoadError'
 
+# 引擎层内部错误；
+FAILEDOPERATION_ENGINESERVERERROR = 'FailedOperation.EngineServerError'
+
 # FailedOperation.FileDecodeFailed
 FAILEDOPERATION_FILEDECODEFAILED = 'FailedOperation.FileDecodeFailed'
 

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/tencentcloud/lkeap/v20240522/lkeap_client.py

@@ -27,7 +27,94 @@ class LkeapClient(AbstractClient):
 
 
     def ChatCompletions(self, request):
-        """对话
+        """#### 接口功能
+
+        调用接口，发起一次对话请求。
+
+        #### 已支持的模型
+        - DeepSeek-V3（model 参数值为**deepseek-v3**）
+            - DeepSeek-V3为671B参数MoE模型，在百科知识、数学推理等多项任务上优势突出，评测成绩在主流榜单中位列开源模型榜首。
+            - 支持64K上下文长度，最大支持8K输出长度。
+        - DeepSeek-R1（model 参数值为**deepseek-r1**）
+            - DeepSeek-R1为671B模型，使用强化学习训练，推理过程包含大量反思和验证，思维链长度可达数万字。 该系列模型在数学、代码以及各种复杂逻辑推理任务上推理效果优异，并为用户展现了完整的思考过程。
+            - 支持64K上下文长度，最大支持8K输出长度。
+
+        #### 计费说明
+        - 限时免费
+
+        本接口调用DeepSeek系列模型限时免费。即日至北京时间2025年2月25日23:59:59，所有腾讯云用户均可享受DeepSeek-V3、DeepSeek-R1模型限时免费服务，单账号限制接口并发上限为5。在此之后，模型价格将恢复至原价。
+        - 标准计费（2025年2月26日起生效）
+        ![image](https://cdn.xiaowei.qq.com/static/lke/deepseek-token.png)
+
+
+        #### 快速接入
+        1. 完成[实名认证](https://console.cloud.tencent.com/developer/auth)。
+        2. 主账户前往[控制台](https://console.cloud.tencent.com/lkeap)开通服务。若为子账户，需由主账号在[权限管理](https://console.cloud.tencent.com/cam)中为子账号授权，关联预设策略，策略名称：QcloudLKEAPFullAccess。
+        3. 通过API Explorer[在线调试](https://console.cloud.tencent.com/api/explorer?Product=lkeap&Version=2024-05-22&Action=ChatCompletions)。
+        4. 使用[官方 SDK ](https://cloud.tencent.com/document/product/1772/115963#SDK)调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）。
+
+        -----------
+
+        ### SDK调用示例
+        通过本地代码调用本接口（支持Python/Java/PHP/Go/Node.js/.NET等语言）：下面的代码以 Python 语言为例，展示如何访问腾讯云上的DeepSeek模型API的样例。
+        （1）安装环境
+        ```
+        python3 -m pip install --upgrade tencentcloud-sdk-python-common
+        python3 -m pip install --upgrade tencentcloud-sdk-python-lkeap
+        ```
+
+        （2）示例代码
+
+        - 其中SecretKey和SecretID需要从腾讯云控制台获取
+
+        - 参数params中模型Model字段可以选择“deepseek-r1“和“deepseek-v3”
+
+        ```
+        # -*- coding: utf-8 -*-
+        import json
+
+        from tencentcloud.common.common_client import CommonClient
+        from tencentcloud.common import credential
+        from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
+        from tencentcloud.common.profile.client_profile import ClientProfile
+        from tencentcloud.common.profile.http_profile import HttpProfile
+
+        class NonStreamResponse(object):
+            def __init__(self):
+                self.response = ""
+
+            def _deserialize(self, obj):
+                self.response = json.dumps(obj)
+
+        try:
+            # 实例化一个认证对象，入参需要传入腾讯云账户 SecretId 和 SecretKey，此处还需注意密钥对的保密
+            # 代码泄露可能会导致 SecretId 和 SecretKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考，建议采用更安全的方式来使用密钥，请参见：https://cloud.tencent.com/document/product/1278/85305
+            # 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取
+            cred = credential.Credential("", "")
+
+            httpProfile = HttpProfile()
+            httpProfile.endpoint = "lkeap.tencentcloudapi.com"
+            httpProfile.reqTimeout = 40000  # 流式接口可能耗时较长
+            clientProfile = ClientProfile()
+            clientProfile.httpProfile = httpProfile
+
+            params = "{\"Model\":\"deepseek-r1\",\"Messages\":[{\"Role\":\"user\",\"Content\":\"你好\"}],\"Stream\":true}";
+            common_client = CommonClient("lkeap", "2024-05-22", cred, "ap-guangzhou", profile=clientProfile)
+            resp = common_client._call_and_deserialize("ChatCompletions", json.loads(params), NonStreamResponse)
+            if isinstance(resp, NonStreamResponse):  # 非流式响应
+                print(resp.response)
+            else:  # 流式响应
+                for event in resp:
+                    print(event)
+        except TencentCloudSDKException as err:
+            print(err)
+
+        ```
+
+        **DeepSeek-R1使用建议**
+
+        1. 将温度设置在 0.5-0.7 范围内（建议为0.6），以防止无休止的重复或不连贯的输出。
+        2. 避免添加system prompt，所有说明都应包含在user prompt中。
 
         :param request: Request instance for ChatCompletions.
         :type request: :class:`tencentcloud.lkeap.v20240522.models.ChatCompletionsRequest`

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/tencentcloud/lkeap/v20240522/models.py

@@ -235,10 +235,16 @@ class ChatCompletionsRequest(AbstractModel):
         :type Messages: list of Message
         :param _Stream: 是否流式输出
         :type Stream: bool
+        :param _Temperature: 控制生成的随机性，较高的值会产生更多样化的输出。
+        :type Temperature: float
+        :param _MaxTokens: 最大生成的token数量
+        :type MaxTokens: int
         """
         self._Model = None
         self._Messages = None
         self._Stream = None
+        self._Temperature = None
+        self._MaxTokens = None
 
     @property
     def Model(self):
@@ -273,6 +279,28 @@ class ChatCompletionsRequest(AbstractModel):
     def Stream(self, Stream):
         self._Stream = Stream
 
+    @property
+    def Temperature(self):
+        """控制生成的随机性，较高的值会产生更多样化的输出。
+        :rtype: float
+        """
+        return self._Temperature
+
+    @Temperature.setter
+    def Temperature(self, Temperature):
+        self._Temperature = Temperature
+
+    @property
+    def MaxTokens(self):
+        """最大生成的token数量
+        :rtype: int
+        """
+        return self._MaxTokens
+
+    @MaxTokens.setter
+    def MaxTokens(self, MaxTokens):
+        self._MaxTokens = MaxTokens
+
 
     def _deserialize(self, params):
         self._Model = params.get("Model")
@@ -283,6 +311,8 @@ class ChatCompletionsRequest(AbstractModel):
                 obj._deserialize(item)
                 self._Messages.append(obj)
         self._Stream = params.get("Stream")
+        self._Temperature = params.get("Temperature")
+        self._MaxTokens = params.get("MaxTokens")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -300,11 +330,83 @@ class ChatCompletionsResponse(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _Created: Unix 时间戳，单位为秒。
+        :type Created: int
+        :param _Usage: Token 统计信息。
+按照总 Token 数量计费。
+        :type Usage: :class:`tencentcloud.lkeap.v20240522.models.ChatUsage`
+        :param _Id: 本次请求的 RequestId。
+        :type Id: str
+        :param _Choices: 回复内容。
+        :type Choices: list of Choice
+        :param _Model: 模型名称。
+        :type Model: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
         :type RequestId: str
         """
+        self._Created = None
+        self._Usage = None
+        self._Id = None
+        self._Choices = None
+        self._Model = None
         self._RequestId = None
 
+    @property
+    def Created(self):
+        """Unix 时间戳，单位为秒。
+        :rtype: int
+        """
+        return self._Created
+
+    @Created.setter
+    def Created(self, Created):
+        self._Created = Created
+
+    @property
+    def Usage(self):
+        """Token 统计信息。
+按照总 Token 数量计费。
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ChatUsage`
+        """
+        return self._Usage
+
+    @Usage.setter
+    def Usage(self, Usage):
+        self._Usage = Usage
+
+    @property
+    def Id(self):
+        """本次请求的 RequestId。
+        :rtype: str
+        """
+        return self._Id
+
+    @Id.setter
+    def Id(self, Id):
+        self._Id = Id
+
+    @property
+    def Choices(self):
+        """回复内容。
+        :rtype: list of Choice
+        """
+        return self._Choices
+
+    @Choices.setter
+    def Choices(self, Choices):
+        self._Choices = Choices
+
+    @property
+    def Model(self):
+        """模型名称。
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
     @property
     def RequestId(self):
         """唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
@@ -318,9 +420,178 @@ class ChatCompletionsResponse(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._Created = params.get("Created")
+        if params.get("Usage") is not None:
+            self._Usage = ChatUsage()
+            self._Usage._deserialize(params.get("Usage"))
+        self._Id = params.get("Id")
+        if params.get("Choices") is not None:
+            self._Choices = []
+            for item in params.get("Choices"):
+                obj = Choice()
+                obj._deserialize(item)
+                self._Choices.append(obj)
+        self._Model = params.get("Model")
         self._RequestId = params.get("RequestId")
 
 
+class ChatUsage(AbstractModel):
+    """消耗量
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _PromptTokens: 输入token数
+        :type PromptTokens: int
+        :param _CompletionTokens: 输出token数
+        :type CompletionTokens: int
+        :param _TotalTokens: 总token数
+        :type TotalTokens: int
+        """
+        self._PromptTokens = None
+        self._CompletionTokens = None
+        self._TotalTokens = None
+
+    @property
+    def PromptTokens(self):
+        """输入token数
+        :rtype: int
+        """
+        return self._PromptTokens
+
+    @PromptTokens.setter
+    def PromptTokens(self, PromptTokens):
+        self._PromptTokens = PromptTokens
+
+    @property
+    def CompletionTokens(self):
+        """输出token数
+        :rtype: int
+        """
+        return self._CompletionTokens
+
+    @CompletionTokens.setter
+    def CompletionTokens(self, CompletionTokens):
+        self._CompletionTokens = CompletionTokens
+
+    @property
+    def TotalTokens(self):
+        """总token数
+        :rtype: int
+        """
+        return self._TotalTokens
+
+    @TotalTokens.setter
+    def TotalTokens(self, TotalTokens):
+        self._TotalTokens = TotalTokens
+
+
+    def _deserialize(self, params):
+        self._PromptTokens = params.get("PromptTokens")
+        self._CompletionTokens = params.get("CompletionTokens")
+        self._TotalTokens = params.get("TotalTokens")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class Choice(AbstractModel):
+    """返回的回复, 支持多个
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _FinishReason: 结束标志位，可能为 stop、 sensitive或者tool_calls。
+stop 表示输出正常结束。
+sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+tool_calls 标识函数调用。
+        :type FinishReason: str
+        :param _Delta: 增量返回值，流式调用时使用该字段。
+        :type Delta: :class:`tencentcloud.lkeap.v20240522.models.Delta`
+        :param _Message: 返回值，非流式调用时使用该字段。
+        :type Message: :class:`tencentcloud.lkeap.v20240522.models.Message`
+        :param _Index: 索引值，流式调用时使用该字段。
+        :type Index: int
+        """
+        self._FinishReason = None
+        self._Delta = None
+        self._Message = None
+        self._Index = None
+
+    @property
+    def FinishReason(self):
+        """结束标志位，可能为 stop、 sensitive或者tool_calls。
+stop 表示输出正常结束。
+sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+tool_calls 标识函数调用。
+        :rtype: str
+        """
+        return self._FinishReason
+
+    @FinishReason.setter
+    def FinishReason(self, FinishReason):
+        self._FinishReason = FinishReason
+
+    @property
+    def Delta(self):
+        """增量返回值，流式调用时使用该字段。
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.Delta`
+        """
+        return self._Delta
+
+    @Delta.setter
+    def Delta(self, Delta):
+        self._Delta = Delta
+
+    @property
+    def Message(self):
+        """返回值，非流式调用时使用该字段。
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.Message`
+        """
+        return self._Message
+
+    @Message.setter
+    def Message(self, Message):
+        self._Message = Message
+
+    @property
+    def Index(self):
+        """索引值，流式调用时使用该字段。
+        :rtype: int
+        """
+        return self._Index
+
+    @Index.setter
+    def Index(self, Index):
+        self._Index = Index
+
+
+    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"))
+        self._Index = params.get("Index")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class CreateAttributeLabelRequest(AbstractModel):
     """CreateAttributeLabel请求参数结构体
 
@@ -1263,6 +1534,57 @@ class DeleteQAsResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class Delta(AbstractModel):
+    """返回的内容
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Role: 角色名称。
+        :type Role: str
+        :param _Content: 内容详情。
+        :type Content: str
+        """
+        self._Role = None
+        self._Content = None
+
+    @property
+    def Role(self):
+        """角色名称。
+        :rtype: str
+        """
+        return self._Role
+
+    @Role.setter
+    def Role(self, Role):
+        self._Role = Role
+
+    @property
+    def Content(self):
+        """内容详情。
+        :rtype: str
+        """
+        return self._Content
+
+    @Content.setter
+    def Content(self, Content):
+        self._Content = Content
+
+
+    def _deserialize(self, params):
+        self._Role = params.get("Role")
+        self._Content = params.get("Content")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class DescribeDocRequest(AbstractModel):
     """DescribeDoc请求参数结构体
 
@@ -2203,9 +2525,13 @@ class Message(AbstractModel):
         :type Role: str
         :param _Content: 内容
         :type Content: str
+        :param _ReasoningContent: 思维链内容。
+ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+        :type ReasoningContent: str
         """
         self._Role = None
         self._Content = None
+        self._ReasoningContent = None
 
     @property
     def Role(self):
@@ -2229,10 +2555,23 @@ class Message(AbstractModel):
     def Content(self, Content):
         self._Content = Content
 
+    @property
+    def ReasoningContent(self):
+        """思维链内容。
+ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+        :rtype: str
+        """
+        return self._ReasoningContent
+
+    @ReasoningContent.setter
+    def ReasoningContent(self, ReasoningContent):
+        self._ReasoningContent = ReasoningContent
+
 
     def _deserialize(self, params):
         self._Role = params.get("Role")
         self._Content = params.get("Content")
+        self._ReasoningContent = params.get("ReasoningContent")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud-sdk-python-3.0.1312 → tencentcloud-sdk-python-3.0.1313}/tencentcloud/mongodb/v20190725/models.py

@@ -1898,7 +1898,11 @@ class CreateDBInstanceRequest(AbstractModel):
         :type VpcId: str
         :param _SubnetId: 私有网络VPC的子网。请登录 [私有网络控制台](https://console.cloud.tencent.com/vpc) 查询子网列表确认正确的 ID。 示例值：subnet-7jbabche
         :type SubnetId: str
-        :param _Password: 实例密码。自定义密码长度为8-32个字符，至少包含字母、数字和字符（!@#%^*()_）中的两种。
+        :param _Password: 实例密码。设置要求如下：
+- 字符个数为[8,32]。
+- 可输入[A,Z]、[a,z]、[0,9]范围内的字符。
+- 可输入的特殊字符包括：感叹号“!”，at“@”，警号“#“、百分号”%”、插入号“^”、星号“*”、括号“()”、下划线“_”。
+- 不能设置单一的字母或者数字。
         :type Password: str
         :param _Tags: 实例标签信息。
         :type Tags: list of TagInfo
@@ -2137,7 +2141,11 @@ class CreateDBInstanceRequest(AbstractModel):
 
     @property
     def Password(self):
-        """实例密码。自定义密码长度为8-32个字符，至少包含字母、数字和字符（!@#%^*()_）中的两种。
+        """实例密码。设置要求如下：
+- 字符个数为[8,32]。
+- 可输入[A,Z]、[a,z]、[0,9]范围内的字符。
+- 可输入的特殊字符包括：感叹号“!”，at“@”，警号“#“、百分号”%”、插入号“^”、星号“*”、括号“()”、下划线“_”。
+- 不能设置单一的字母或者数字。
         :rtype: str
         """
         return self._Password
@@ -6736,7 +6744,7 @@ class InquirePriceRenewDBInstancesRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _InstanceIds: 实例ID，格式如：cmgo-p8vn****。与云数据库控制台页面中显示的实例ID相同，接口单次最多只支持5个实例进行操作。
+        :param _InstanceIds: 实例ID，格式如：cmgo-p8vn****。请登录[MongoDB 控制台](https://console.cloud.tencent.com/mongodb)在实例列表复制实例 ID，且单次最多同时查询5个实例。
         :type InstanceIds: list of str
         :param _InstanceChargePrepaid: 预付费模式（即包年包月）相关参数设置。通过该参数可以指定包年包月实例的续费时长、是否设置自动续费等属性。
         :type InstanceChargePrepaid: :class:`tencentcloud.mongodb.v20190725.models.InstanceChargePrepaid`
@@ -6746,7 +6754,7 @@ class InquirePriceRenewDBInstancesRequest(AbstractModel):
 
     @property
     def InstanceIds(self):
-        """实例ID，格式如：cmgo-p8vn****。与云数据库控制台页面中显示的实例ID相同，接口单次最多只支持5个实例进行操作。
+        """实例ID，格式如：cmgo-p8vn****。请登录[MongoDB 控制台](https://console.cloud.tencent.com/mongodb)在实例列表复制实例 ID，且单次最多同时查询5个实例。
         :rtype: list of str
         """
         return self._InstanceIds