tencentcloud-sdk-lkeap 3.0.991 → 3.0.993

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 10314c65642395b4e9f59e336e92fa1b57371a7e
-  data.tar.gz: a20d6cb0873698294260f90dd66799d8351de768
+  metadata.gz: c8913f944b23edb62fcfde4a836cf2613308baa6
+  data.tar.gz: fc79381e1976cd6a702a580346c103032bb506b1
 SHA512:
-  metadata.gz: 9581732829552d25635b9e6dc4451bfb2c0a1937484199230048bbfb94e04401cacf4f94346916f8cad2fab41e5fd637e4587f12d4489789db09f0dfe681fcbb
-  data.tar.gz: d638f58a58d024f9b7d151cb3d11734926056c44df80e078935a743200e247528bda7b5c93e0a8719a988ab58962d056dc656d8406f6c007f243fc1f8820dec0
+  metadata.gz: 85fafc1a6ba43b4adf7f04034fa5b641fb685dd59d106b3434f2a9668f5f36569e46a81e4f13a48153073b2989e1de42937e53c6290e5f83b72fd651ec8968f3
+  data.tar.gz: bdb5c02835a308f952183f4c49e70889f51d80e56b2d27113e34c9b5f9c6db98166b9f0bc09ce82bb6eb195e63a7b51b64d0fdaa55923350847eafd95521064f

data/lib/VERSION

@@ -1 +1 @@
-3.0.991
+3.0.993

data/lib/v20240522/client.rb

@@ -29,7 +29,100 @@ module TencentCloud
         end
 
 
-        # 对话
+        # #### 接口功能
+
+        # 调用接口，发起一次对话请求。
+
+        # #### 已支持的模型
+        # - 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)
+
+        # ### Openai兼容协议接口
+        # 知识引擎原子能力大模型对话 API 兼容了 OpenAI 的接口规范，这意味着您可以直接使用 OpenAI 官方提供的 SDK 来调用大模型对话接口。您仅需要将 base_url 和 [api_key](https://cloud.tencent.com/document/product/1772/115970) 替换成相关配置，不需要对应用做额外修改，即可无缝将您的应用切换到相应的大模型。
+        # > base_url：  https://api.lkeap.cloud.tencent.com/v1
+
+        # > api_key的获取请参考[API KEY管理](https://cloud.tencent.com/document/product/1772/115970)
+
+
+        # #### 快速接入
+        # 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::ChatCompletionsRequest`

data/lib/v20240522/models.rb

@@ -108,13 +108,19 @@ module TencentCloud
         # @type Messages: Array
         # @param Stream: 是否流式输出
         # @type Stream: Boolean
+        # @param Temperature: 控制生成的随机性，较高的值会产生更多样化的输出。
+        # @type Temperature: Float
+        # @param MaxTokens: 最大生成的token数量
+        # @type MaxTokens: Integer
 
-        attr_accessor :Model, :Messages, :Stream
+        attr_accessor :Model, :Messages, :Stream, :Temperature, :MaxTokens
 
-        def initialize(model=nil, messages=nil, stream=nil)
+        def initialize(model=nil, messages=nil, stream=nil, temperature=nil, maxtokens=nil)
           @Model = model
           @Messages = messages
           @Stream = stream
+          @Temperature = temperature
+          @MaxTokens = maxtokens
         end
 
         def deserialize(params)
@@ -128,25 +134,119 @@ module TencentCloud
             end
           end
           @Stream = params['Stream']
+          @Temperature = params['Temperature']
+          @MaxTokens = params['MaxTokens']
         end
       end
 
       # ChatCompletions返回参数结构体
       class ChatCompletionsResponse < TencentCloud::Common::AbstractModel
+        # @param Created: Unix 时间戳，单位为秒。
+        # @type Created: Integer
+        # @param Usage: Token 统计信息。
+        # 按照总 Token 数量计费。
+        # @type Usage: :class:`Tencentcloud::Lkeap.v20240522.models.ChatUsage`
+        # @param Id: 本次请求的 RequestId。
+        # @type Id: String
+        # @param Choices: 回复内容。
+        # @type Choices: Array
+        # @param Model: 模型名称。
+        # @type Model: String
         # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
         # @type RequestId: String
 
-        attr_accessor :RequestId
+        attr_accessor :Created, :Usage, :Id, :Choices, :Model, :RequestId
 
-        def initialize(requestid=nil)
+        def initialize(created=nil, usage=nil, id=nil, choices=nil, model=nil, requestid=nil)
+          @Created = created
+          @Usage = usage
+          @Id = id
+          @Choices = choices
+          @Model = model
           @RequestId = requestid
         end
 
         def deserialize(params)
+          @Created = params['Created']
+          unless params['Usage'].nil?
+            @Usage = ChatUsage.new
+            @Usage.deserialize(params['Usage'])
+          end
+          @Id = params['Id']
+          unless params['Choices'].nil?
+            @Choices = []
+            params['Choices'].each do |i|
+              choice_tmp = Choice.new
+              choice_tmp.deserialize(i)
+              @Choices << choice_tmp
+            end
+          end
+          @Model = params['Model']
           @RequestId = params['RequestId']
         end
       end
 
+      # 消耗量
+      class ChatUsage < TencentCloud::Common::AbstractModel
+        # @param PromptTokens: 输入token数
+        # @type PromptTokens: Integer
+        # @param CompletionTokens: 输出token数
+        # @type CompletionTokens: Integer
+        # @param TotalTokens: 总token数
+        # @type TotalTokens: Integer
+
+        attr_accessor :PromptTokens, :CompletionTokens, :TotalTokens
+
+        def initialize(prompttokens=nil, completiontokens=nil, totaltokens=nil)
+          @PromptTokens = prompttokens
+          @CompletionTokens = completiontokens
+          @TotalTokens = totaltokens
+        end
+
+        def deserialize(params)
+          @PromptTokens = params['PromptTokens']
+          @CompletionTokens = params['CompletionTokens']
+          @TotalTokens = params['TotalTokens']
+        end
+      end
+
+      # 返回的回复, 支持多个
+      class Choice < TencentCloud::Common::AbstractModel
+        # @param FinishReason: 结束标志位，可能为 stop、 sensitive或者tool_calls。
+        # stop 表示输出正常结束。
+        # sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+        # tool_calls 标识函数调用。
+        # @type FinishReason: String
+        # @param Delta: 增量返回值，流式调用时使用该字段。
+        # @type Delta: :class:`Tencentcloud::Lkeap.v20240522.models.Delta`
+        # @param Message: 返回值，非流式调用时使用该字段。
+        # @type Message: :class:`Tencentcloud::Lkeap.v20240522.models.Message`
+        # @param Index: 索引值，流式调用时使用该字段。
+        # @type Index: Integer
+
+        attr_accessor :FinishReason, :Delta, :Message, :Index
+
+        def initialize(finishreason=nil, delta=nil, message=nil, index=nil)
+          @FinishReason = finishreason
+          @Delta = delta
+          @Message = message
+          @Index = index
+        end
+
+        def deserialize(params)
+          @FinishReason = params['FinishReason']
+          unless params['Delta'].nil?
+            @Delta = Delta.new
+            @Delta.deserialize(params['Delta'])
+          end
+          unless params['Message'].nil?
+            @Message = Message.new
+            @Message.deserialize(params['Message'])
+          end
+          @Index = params['Index']
+        end
+      end
+
       # CreateAttributeLabel请求参数结构体
       class CreateAttributeLabelRequest < TencentCloud::Common::AbstractModel
         # @param Labels: 属性标签信息
@@ -601,6 +701,26 @@ module TencentCloud
         end
       end
 
+      # 返回的内容
+      class Delta < TencentCloud::Common::AbstractModel
+        # @param Role: 角色名称。
+        # @type Role: String
+        # @param Content: 内容详情。
+        # @type Content: String
+
+        attr_accessor :Role, :Content
+
+        def initialize(role=nil, content=nil)
+          @Role = role
+          @Content = content
+        end
+
+        def deserialize(params)
+          @Role = params['Role']
+          @Content = params['Content']
+        end
+      end
+
       # DescribeDoc请求参数结构体
       class DescribeDocRequest < TencentCloud::Common::AbstractModel
 
@@ -1082,17 +1202,22 @@ module TencentCloud
         # @type Role: String
         # @param Content: 内容
         # @type Content: String
+        # @param ReasoningContent: 思维链内容。
+        # ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+        # @type ReasoningContent: String
 
-        attr_accessor :Role, :Content
+        attr_accessor :Role, :Content, :ReasoningContent
 
-        def initialize(role=nil, content=nil)
+        def initialize(role=nil, content=nil, reasoningcontent=nil)
           @Role = role
           @Content = content
+          @ReasoningContent = reasoningcontent
         end
 
         def deserialize(params)
           @Role = params['Role']
           @Content = params['Content']
+          @ReasoningContent = params['ReasoningContent']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-lkeap
 version: !ruby/object:Gem::Version
-  version: 3.0.991
+  version: 3.0.993
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-02-04 00:00:00.000000000 Z
+date: 2025-02-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common