tencentcloud-sdk-python-lkeap 3.0.1308__tar.gz → 3.0.1313__tar.gz

{tencentcloud-sdk-python-lkeap-3.0.1308 → tencentcloud-sdk-python-lkeap-3.0.1313}/PKG-INFO

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

{tencentcloud-sdk-python-lkeap-3.0.1308 → tencentcloud-sdk-python-lkeap-3.0.1313}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-lkeap',
-    install_requires=["tencentcloud-sdk-python-common==3.0.1308"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1313"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Lkeap SDK for Python',
     long_description=open('README.rst').read(),

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

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

{tencentcloud-sdk-python-lkeap-3.0.1308 → tencentcloud-sdk-python-lkeap-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-lkeap-3.0.1308 → tencentcloud-sdk-python-lkeap-3.0.1313}/tencentcloud/lkeap/v20240522/lkeap_client.py

@@ -26,6 +26,111 @@ class LkeapClient(AbstractClient):
     _service = 'lkeap'
 
 
+    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`
+        :rtype: :class:`tencentcloud.lkeap.v20240522.models.ChatCompletionsResponse`
+
+        """
+        try:
+            params = request._serialize()
+            return self._call_and_deserialize("ChatCompletions", params, models.ChatCompletionsResponse, headers=request.headers)
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateAttributeLabel(self, request):
         """用于为问答对创建属性标签，以便对内容进行分类和管理。 使用场景：当需要为问答对添加分类标签和属性标记时使用，比如为问答对添加“售后”标签。
 

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

@@ -222,6 +222,376 @@ class AttributeLabelReferItem(AbstractModel):
         
 
 
+class ChatCompletionsRequest(AbstractModel):
+    """ChatCompletions请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Model: 模型名称
+        :type Model: str
+        :param _Messages: 会话列表
+        :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):
+        """模型名称
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
+    @property
+    def Messages(self):
+        """会话列表
+        :rtype: list of Message
+        """
+        return self._Messages
+
+    @Messages.setter
+    def Messages(self, Messages):
+        self._Messages = Messages
+
+    @property
+    def Stream(self):
+        """是否流式输出
+        :rtype: bool
+        """
+        return self._Stream
+
+    @Stream.setter
+    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")
+        if params.get("Messages") is not None:
+            self._Messages = []
+            for item in params.get("Messages"):
+                obj = Message()
+                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:]
+            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 ChatCompletionsResponse(AbstractModel):
+    """ChatCompletions返回参数结构体
+
+    """
+
+    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" 中。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    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请求参数结构体
 
@@ -1164,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请求参数结构体
 
@@ -2104,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):
@@ -2130,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-lkeap-3.0.1308 → tencentcloud-sdk-python-lkeap-3.0.1313}/tencentcloud_sdk_python_lkeap.egg-info/PKG-INFO

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

tencentcloud-sdk-python-lkeap-3.0.1313/tencentcloud_sdk_python_lkeap.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common==3.0.1313

tencentcloud-sdk-python-lkeap-3.0.1308/tencentcloud_sdk_python_lkeap.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common==3.0.1308