tencentcloud-sdk-nodejs 4.0.1023 → 4.0.1024

package/README.md

@@ -56,7 +56,7 @@ npm install tencentcloud-sdk-nodejs --save
 1. 前往 [GitHub 仓库](https://github.com/tencentcloud/tencentcloud-sdk-nodejs) 或者 [Gitee 仓库](https://gitee.com/tencentcloud/tencentcloud-sdk-nodejs) 下载源码压缩包。
 2. 解压源码包到您项目合适的位置，例如 `sdk/tencentcloud-sdk-nodejs`。
 3. 执行 `npm install ./sdk/tencentcloud-sdk-nodejs`。
-4. 使用 `require("tencentcloud-sdk-nodejs")` 的方式引入sdk，具体可参考示例。
+4. 使用 `require("tencentcloud-sdk-nodejs")` 的方式引入SDK，具体可参考示例。
 
 # 示例
 
@@ -154,9 +154,9 @@ new XxxClient({
 # 常见问题
 - webpack打包出错/浏览器报错
 
-  请**务必不要**将此sdk直接用于web前端(包括小程序等)，暴露密钥在这些环境非常不安全。
+  请**务必不要**将此SDK直接用于web前端(包括小程序等)，暴露密钥在这些环境非常不安全。
 
-  正确的做法是在自己的服务端引用此sdk，并保存好密钥，做好请求鉴权；前端再调用服务端执行业务流程。
+  正确的做法是在自己的服务端引用此SDK，并保存好密钥，做好请求鉴权；前端再调用服务端执行业务流程。
 
 - `The "original" argument must be of type Function.`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs",
-  "version": "4.0.1023",
+  "version": "4.0.1024",
   "description": "腾讯云 API NODEJS SDK",
   "main": "tencentcloud/index.js",
   "scripts": {

package/src/common/sdk_version.ts

@@ -1 +1 @@
-export const sdkVersion = "4.0.1023"
+export const sdkVersion = "4.0.1024"

package/src/services/lkeap/v20240522/lkeap_client.ts

@@ -43,16 +43,19 @@ import {
   SegmentationConfig,
   CreateQAResponse,
   ModifyAttributeLabelRequest,
+  GetReconstructDocumentResultResponse,
   ReconstructDocumentSSEConfig,
   ListDocsResponse,
   DocumentUsage,
   ListAttributeLabelsRequest,
   DeleteAttributeLabelsRequest,
   RetrieveKnowledgeRequest,
-  GetReconstructDocumentResultResponse,
+  Choice,
   CreateReconstructDocumentFlowConfig,
   RunRerankRequest,
+  ChatUsage,
   GetSplitDocumentResultRequest,
+  Delta,
   ReconstructDocumentSSERequest,
   ListAttributeLabelsResponse,
   RetrievalRecord,
@@ -80,14 +83,14 @@ import {
   CreateSplitDocumentFlowConfig,
   RunRerankResponse,
   CreateReconstructDocumentFlowResponse,
-  ChatCompletionsResponse,
+  DeleteKnowledgeBaseRequest,
   CreateQARequest,
   UploadDocResponse,
   AttributeItem,
   EmbeddingObject,
   Message,
   CreateKnowledgeBaseRequest,
-  DeleteKnowledgeBaseRequest,
+  ChatCompletionsResponse,
   DeleteDocsRequest,
 } from "./lkeap_models"
 
@@ -357,8 +360,95 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * 对话
-   */
+     * #### 接口功能
+
+调用接口，发起一次对话请求。
+
+#### 已支持的模型
+- 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中。
+     */
   async ChatCompletions(
     req: ChatCompletionsRequest,
     cb?: (error: string, rep: ChatCompletionsResponse) => void

package/src/services/lkeap/v20240522/lkeap_models.ts

@@ -31,6 +31,14 @@ export interface ChatCompletionsRequest {
    * 是否流式输出
    */
   Stream?: boolean
+  /**
+   * 控制生成的随机性，较高的值会产生更多样化的输出。
+   */
+  Temperature?: number
+  /**
+   * 最大生成的token数量
+   */
+  MaxTokens?: number
 }
 
 /**
@@ -416,6 +424,28 @@ export interface ModifyAttributeLabelRequest {
   Labels?: Array<AttributeLabelItem>
 }
 
+/**
+ * GetReconstructDocumentResult返回参数结构体
+ */
+export interface GetReconstructDocumentResultResponse {
+  /**
+   * 任务状态。- `Success`：执行完成- `Processing`：执行中- `Pause`: 暂停- `Failed`：执行失败- `WaitExecute`：等待执行
+   */
+  Status?: string
+  /**
+   * 解析结果的临时下载地址。文件类型为zip压缩包，下载链接有效期30分钟
+   */
+  DocumentRecognizeResultUrl?: string
+  /**
+   * 文档解析失败的页码
+   */
+  FailedPages?: Array<ReconstructDocumentFailedPage>
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * ReconstructDocumentSSE 功能配置参数
  */
@@ -517,25 +547,28 @@ export interface RetrieveKnowledgeRequest {
 }
 
 /**
- * GetReconstructDocumentResult返回参数结构体
+ * 返回的回复, 支持多个
  */
-export interface GetReconstructDocumentResultResponse {
+export interface Choice {
   /**
-   * 任务状态。- `Success`：执行完成- `Processing`：执行中- `Pause`: 暂停- `Failed`：执行失败- `WaitExecute`：等待执行
+   * 结束标志位，可能为 stop、 sensitive或者tool_calls。
+stop 表示输出正常结束。
+sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+tool_calls 标识函数调用。
    */
-  Status?: string
+  FinishReason?: string
   /**
-   * 解析结果的临时下载地址。文件类型为zip压缩包，下载链接有效期30分钟
+   * 增量返回值，流式调用时使用该字段。
    */
-  DocumentRecognizeResultUrl?: string
+  Delta?: Delta
   /**
-   * 文档解析失败的页码
+   * 返回值，非流式调用时使用该字段。
    */
-  FailedPages?: Array<ReconstructDocumentFailedPage>
+  Message?: Message
   /**
-   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   * 索引值，流式调用时使用该字段。
    */
-  RequestId?: string
+  Index?: number
 }
 
 /**
@@ -581,6 +614,24 @@ export interface RunRerankRequest {
   Model?: string
 }
 
+/**
+ * 消耗量
+ */
+export interface ChatUsage {
+  /**
+   * 输入token数
+   */
+  PromptTokens?: number
+  /**
+   * 输出token数
+   */
+  CompletionTokens?: number
+  /**
+   * 总token数
+   */
+  TotalTokens?: number
+}
+
 /**
  * GetSplitDocumentResult请求参数结构体
  */
@@ -591,6 +642,20 @@ export interface GetSplitDocumentResultRequest {
   TaskId: string
 }
 
+/**
+ * 返回的内容
+ */
+export interface Delta {
+  /**
+   * 角色名称。
+   */
+  Role?: string
+  /**
+   * 内容详情。
+   */
+  Content?: string
+}
+
 /**
  * ReconstructDocumentSSE请求参数结构体
  */
@@ -1103,13 +1168,13 @@ export interface CreateReconstructDocumentFlowResponse {
 }
 
 /**
- * ChatCompletions返回参数结构体
+ * DeleteKnowledgeBase请求参数结构体
  */
-export interface ChatCompletionsResponse {
+export interface DeleteKnowledgeBaseRequest {
   /**
-   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+   * 知识库ID
    */
-  RequestId?: string
+  KnowledgeBaseId: string
 }
 
 /**
@@ -1184,6 +1249,11 @@ export interface Message {
    * 内容
    */
   Content?: string
+  /**
+   * 思维链内容。
+ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+   */
+  ReasoningContent?: string
 }
 
 /**
@@ -1192,13 +1262,34 @@ export interface Message {
 export type CreateKnowledgeBaseRequest = null
 
 /**
- * DeleteKnowledgeBase请求参数结构体
+ * ChatCompletions返回参数结构体
  */
-export interface DeleteKnowledgeBaseRequest {
+export interface ChatCompletionsResponse {
   /**
-   * 知识库ID
+   * Unix 时间戳，单位为秒。
    */
-  KnowledgeBaseId: string
+  Created?: number
+  /**
+   * Token 统计信息。
+按照总 Token 数量计费。
+   */
+  Usage?: ChatUsage
+  /**
+   * 本次请求的 RequestId。
+   */
+  Id?: string
+  /**
+   * 回复内容。
+   */
+  Choices?: Array<Choice>
+  /**
+   * 模型名称。
+   */
+  Model?: string
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+   */
+  RequestId?: string
 }
 
 /**

package/src/services/mongodb/v20190725/mongodb_models.ts

@@ -99,7 +99,11 @@ export interface CreateDBInstanceRequest {
    */
   SubnetId?: string
   /**
-   * 实例密码。自定义密码长度为8-32个字符，至少包含字母、数字和字符（!@#%^*()_）中的两种。
+   * 实例密码。设置要求如下：
+- 字符个数为[8,32]。
+- 可输入[A,Z]、[a,z]、[0,9]范围内的字符。
+- 可输入的特殊字符包括：感叹号“!”，at“@”，警号“#“、百分号”%”、插入号“^”、星号“*”、括号“()”、下划线“_”。
+- 不能设置单一的字母或者数字。
    */
   Password?: string
   /**
@@ -276,7 +280,7 @@ export interface KillOpsRequest {
  */
 export interface InquirePriceRenewDBInstancesRequest {
   /**
-   * 实例ID，格式如：cmgo-p8vn****。与云数据库控制台页面中显示的实例ID相同，接口单次最多只支持5个实例进行操作。
+   * 实例ID，格式如：cmgo-p8vn****。请登录[MongoDB 控制台](https://console.cloud.tencent.com/mongodb)在实例列表复制实例 ID，且单次最多同时查询5个实例。
    */
   InstanceIds: Array<string>
   /**

package/src/services/ses/v20201002/ses_models.ts

@@ -319,23 +319,23 @@ export interface TemplatesMetadata {
   /**
    * 创建时间
    */
-  CreatedTimestamp: number
+  CreatedTimestamp?: number
   /**
    * 模板名称
    */
-  TemplateName: string
+  TemplateName?: string
   /**
    * 模板状态。1-审核中|0-已通过|2-拒绝|其它-不可用
    */
-  TemplateStatus: number
+  TemplateStatus?: number
   /**
    * 模板ID
    */
-  TemplateID: number
+  TemplateID?: number
   /**
    * 审核原因
    */
-  ReviewReason: string
+  ReviewReason?: string
 }
 
 /**
@@ -356,17 +356,14 @@ export interface ReceiverDetail {
   TemplateData?: string
   /**
    * 无效原因
-注意：此字段可能返回 null，表示取不到有效值。
    */
   Reason?: string
   /**
    * 1:有效，2:无效
-注意：此字段可能返回 null，表示取不到有效值。
    */
   Status?: number
   /**
    * 收件人地址id
-注意：此字段可能返回 null，表示取不到有效值。
    */
   EmailId?: number
 }
@@ -435,36 +432,36 @@ export interface Volume {
    * 日期
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  SendDate: string
+  SendDate?: string
   /**
    * 邮件请求数量
    */
-  RequestCount: number
+  RequestCount?: number
   /**
    * 腾讯云通过数量
    */
-  AcceptedCount: number
+  AcceptedCount?: number
   /**
    * 送达数量
    */
-  DeliveredCount: number
+  DeliveredCount?: number
   /**
    * 打开邮件的用户数量，根据收件人去重
    */
-  OpenedCount: number
+  OpenedCount?: number
   /**
    * 点击了邮件中的链接数量用户数量
    */
-  ClickedCount: number
+  ClickedCount?: number
   /**
    * 退信数量
    */
-  BounceCount: number
+  BounceCount?: number
   /**
    * 取消订阅的用户数量
 注意：此字段可能返回 null，表示取不到有效值。
    */
-  UnsubscribeCount: number
+  UnsubscribeCount?: number
 }
 
 /**
@@ -755,12 +752,10 @@ export interface ReceiverData {
   Count?: number
   /**
    * 收件人列表描述
-注意：此字段可能返回 null，表示取不到有效值。
    */
   Desc?: string
   /**
    * 列表状态(1 待上传 2 上传中 3 上传完成)
-注意：此字段可能返回 null，表示取不到有效值。
    */
   ReceiversStatus?: number
   /**
@@ -769,7 +764,6 @@ export interface ReceiverData {
   CreateTime?: string
   /**
    * 无效收件人数量
-注意：此字段可能返回 null，表示取不到有效值。
    */
   InvalidCount?: number
 }
@@ -969,27 +963,22 @@ export interface ListEmailTemplatesRequest {
 export interface CreateReceiverDetailWithDataResponse {
   /**
    * 收件人总数
-注意：此字段可能返回 null，表示取不到有效值。
    */
   TotalCount?: number
   /**
    * 实际上传数量
-注意：此字段可能返回 null，表示取不到有效值。
    */
   ValidCount?: number
   /**
    * 数据过长数量
-注意：此字段可能返回 null，表示取不到有效值。
    */
   TooLongCount?: number
   /**
    * 邮件地址为空数量
-注意：此字段可能返回 null，表示取不到有效值。
    */
   EmptyEmailCount?: number
   /**
    * 重复数量
-注意：此字段可能返回 null，表示取不到有效值。
    */
   RepeatCount?: number
   /**
@@ -1353,7 +1342,6 @@ export interface BlackEmailAddress {
   EmailAddress?: string
   /**
    * 被拉黑的理由
-注意：此字段可能返回 null，表示取不到有效值。
    */
   IspDesc?: string
 }

package/tencentcloud/common/sdk_version.d.ts

@@ -1 +1 @@
-export declare const sdkVersion = "4.0.1023";
+export declare const sdkVersion = "4.0.1024";

package/tencentcloud/common/sdk_version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkVersion = void 0;
-exports.sdkVersion = "4.0.1023";
+exports.sdkVersion = "4.0.1024";

package/tencentcloud/services/lkeap/v20240522/lkeap_client.d.ts

@@ -1,6 +1,6 @@
 import { AbstractClient } from "../../../common/abstract_client";
 import { ClientConfig } from "../../../common/interface";
-import { ChatCompletionsRequest, CreateSplitDocumentFlowRequest, ListQAsRequest, ReconstructDocumentSSEResponse, GetEmbeddingRequest, ImportQAsResponse, UploadDocRealtimeRequest, DescribeDocResponse, DeleteQAsRequest, ModifyQARequest, GetReconstructDocumentResultRequest, ListQAsResponse, DeleteAttributeLabelsResponse, ListDocsRequest, CreateAttributeLabelResponse, RetrieveKnowledgeResponse, CreateSplitDocumentFlowResponse, CreateQAResponse, ModifyAttributeLabelRequest, ListDocsResponse, ListAttributeLabelsRequest, DeleteAttributeLabelsRequest, RetrieveKnowledgeRequest, GetReconstructDocumentResultResponse, RunRerankRequest, GetSplitDocumentResultRequest, ReconstructDocumentSSERequest, ListAttributeLabelsResponse, CreateAttributeLabelRequest, ImportQAsRequest, DescribeDocRequest, DeleteKnowledgeBaseResponse, DeleteDocsResponse, CreateReconstructDocumentFlowRequest, GetSplitDocumentResultResponse, ModifyQAResponse, UploadDocRealtimeResponse, ModifyAttributeLabelResponse, QueryRewriteResponse, UploadDocRequest, DeleteQAsResponse, CreateKnowledgeBaseResponse, GetEmbeddingResponse, QueryRewriteRequest, RunRerankResponse, CreateReconstructDocumentFlowResponse, ChatCompletionsResponse, CreateQARequest, UploadDocResponse, CreateKnowledgeBaseRequest, DeleteKnowledgeBaseRequest, DeleteDocsRequest } from "./lkeap_models";
+import { ChatCompletionsRequest, CreateSplitDocumentFlowRequest, ListQAsRequest, ReconstructDocumentSSEResponse, GetEmbeddingRequest, ImportQAsResponse, UploadDocRealtimeRequest, DescribeDocResponse, DeleteQAsRequest, ModifyQARequest, GetReconstructDocumentResultRequest, ListQAsResponse, DeleteAttributeLabelsResponse, ListDocsRequest, CreateAttributeLabelResponse, RetrieveKnowledgeResponse, CreateSplitDocumentFlowResponse, CreateQAResponse, ModifyAttributeLabelRequest, GetReconstructDocumentResultResponse, ListDocsResponse, ListAttributeLabelsRequest, DeleteAttributeLabelsRequest, RetrieveKnowledgeRequest, RunRerankRequest, GetSplitDocumentResultRequest, ReconstructDocumentSSERequest, ListAttributeLabelsResponse, CreateAttributeLabelRequest, ImportQAsRequest, DescribeDocRequest, DeleteKnowledgeBaseResponse, DeleteDocsResponse, CreateReconstructDocumentFlowRequest, GetSplitDocumentResultResponse, ModifyQAResponse, UploadDocRealtimeResponse, ModifyAttributeLabelResponse, QueryRewriteResponse, UploadDocRequest, DeleteQAsResponse, CreateKnowledgeBaseResponse, GetEmbeddingResponse, QueryRewriteRequest, RunRerankResponse, CreateReconstructDocumentFlowResponse, DeleteKnowledgeBaseRequest, CreateQARequest, UploadDocResponse, CreateKnowledgeBaseRequest, ChatCompletionsResponse, DeleteDocsRequest } from "./lkeap_models";
 /**
  * lkeap client
  * @class
@@ -114,7 +114,94 @@ export declare class Client extends AbstractClient {
      */
     UploadDoc(req: UploadDocRequest, cb?: (error: string, rep: UploadDocResponse) => void): Promise<UploadDocResponse>;
     /**
-     * 对话
+     * #### 接口功能
+
+调用接口，发起一次对话请求。
+
+#### 已支持的模型
+- 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中。
      */
     ChatCompletions(req: ChatCompletionsRequest, cb?: (error: string, rep: ChatCompletionsResponse) => void): Promise<ChatCompletionsResponse>;
 }

package/tencentcloud/services/lkeap/v20240522/lkeap_client.js

@@ -184,7 +184,94 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("UploadDoc", req, cb);
     }
     /**
-     * 对话
+     * #### 接口功能
+
+调用接口，发起一次对话请求。
+
+#### 已支持的模型
+- 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中。
      */
     async ChatCompletions(req, cb) {
         return this.request("ChatCompletions", req, cb);

package/tencentcloud/services/lkeap/v20240522/lkeap_models.d.ts

@@ -14,6 +14,14 @@ export interface ChatCompletionsRequest {
      * 是否流式输出
      */
     Stream?: boolean;
+    /**
+     * 控制生成的随机性，较高的值会产生更多样化的输出。
+     */
+    Temperature?: number;
+    /**
+     * 最大生成的token数量
+     */
+    MaxTokens?: number;
 }
 /**
  * CreateSplitDocumentFlow请求参数结构体
@@ -374,6 +382,27 @@ export interface ModifyAttributeLabelRequest {
      */
     Labels?: Array<AttributeLabelItem>;
 }
+/**
+ * GetReconstructDocumentResult返回参数结构体
+ */
+export interface GetReconstructDocumentResultResponse {
+    /**
+     * 任务状态。- `Success`：执行完成- `Processing`：执行中- `Pause`: 暂停- `Failed`：执行失败- `WaitExecute`：等待执行
+     */
+    Status?: string;
+    /**
+     * 解析结果的临时下载地址。文件类型为zip压缩包，下载链接有效期30分钟
+     */
+    DocumentRecognizeResultUrl?: string;
+    /**
+     * 文档解析失败的页码
+     */
+    FailedPages?: Array<ReconstructDocumentFailedPage>;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}
 /**
  * ReconstructDocumentSSE 功能配置参数
  */
@@ -469,25 +498,28 @@ export interface RetrieveKnowledgeRequest {
     AttributeLabels?: Array<LabelItem>;
 }
 /**
- * GetReconstructDocumentResult返回参数结构体
+ * 返回的回复, 支持多个
  */
-export interface GetReconstructDocumentResultResponse {
+export interface Choice {
     /**
-     * 任务状态。- `Success`：执行完成- `Processing`：执行中- `Pause`: 暂停- `Failed`：执行失败- `WaitExecute`：等待执行
+     * 结束标志位，可能为 stop、 sensitive或者tool_calls。
+  stop 表示输出正常结束。
+  sensitive 只在开启流式输出审核时会出现，表示安全审核未通过。
+  tool_calls 标识函数调用。
      */
-    Status?: string;
+    FinishReason?: string;
     /**
-     * 解析结果的临时下载地址。文件类型为zip压缩包，下载链接有效期30分钟
+     * 增量返回值，流式调用时使用该字段。
      */
-    DocumentRecognizeResultUrl?: string;
+    Delta?: Delta;
     /**
-     * 文档解析失败的页码
+     * 返回值，非流式调用时使用该字段。
      */
-    FailedPages?: Array<ReconstructDocumentFailedPage>;
+    Message?: Message;
     /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     * 索引值，流式调用时使用该字段。
      */
-    RequestId?: string;
+    Index?: number;
 }
 /**
  * 创建智能文档解析任务的配置信息
@@ -530,6 +562,23 @@ export interface RunRerankRequest {
      */
     Model?: string;
 }
+/**
+ * 消耗量
+ */
+export interface ChatUsage {
+    /**
+     * 输入token数
+     */
+    PromptTokens?: number;
+    /**
+     * 输出token数
+     */
+    CompletionTokens?: number;
+    /**
+     * 总token数
+     */
+    TotalTokens?: number;
+}
 /**
  * GetSplitDocumentResult请求参数结构体
  */
@@ -539,6 +588,19 @@ export interface GetSplitDocumentResultRequest {
      */
     TaskId: string;
 }
+/**
+ * 返回的内容
+ */
+export interface Delta {
+    /**
+     * 角色名称。
+     */
+    Role?: string;
+    /**
+     * 内容详情。
+     */
+    Content?: string;
+}
 /**
  * ReconstructDocumentSSE请求参数结构体
  */
@@ -1024,13 +1086,13 @@ export interface CreateReconstructDocumentFlowResponse {
     RequestId?: string;
 }
 /**
- * ChatCompletions返回参数结构体
+ * DeleteKnowledgeBase请求参数结构体
  */
-export interface ChatCompletionsResponse {
+export interface DeleteKnowledgeBaseRequest {
     /**
-     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+     * 知识库ID
      */
-    RequestId?: string;
+    KnowledgeBaseId: string;
 }
 /**
  * CreateQA请求参数结构体
@@ -1100,19 +1162,45 @@ export interface Message {
      * 内容
      */
     Content?: string;
+    /**
+     * 思维链内容。
+  ReasoningConent参数仅支持出参，且只有deepseek-r1模型会返回。
+     */
+    ReasoningContent?: string;
 }
 /**
  * CreateKnowledgeBase请求参数结构体
  */
 export declare type CreateKnowledgeBaseRequest = null;
 /**
- * DeleteKnowledgeBase请求参数结构体
+ * ChatCompletions返回参数结构体
  */
-export interface DeleteKnowledgeBaseRequest {
+export interface ChatCompletionsResponse {
     /**
-     * 知识库ID
+     * Unix 时间戳，单位为秒。
      */
-    KnowledgeBaseId: string;
+    Created?: number;
+    /**
+     * Token 统计信息。
+  按照总 Token 数量计费。
+     */
+    Usage?: ChatUsage;
+    /**
+     * 本次请求的 RequestId。
+     */
+    Id?: string;
+    /**
+     * 回复内容。
+     */
+    Choices?: Array<Choice>;
+    /**
+     * 模型名称。
+     */
+    Model?: string;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+     */
+    RequestId?: string;
 }
 /**
  * DeleteDocs请求参数结构体

package/tencentcloud/services/mongodb/v20190725/mongodb_models.d.ts

@@ -81,7 +81,11 @@ export interface CreateDBInstanceRequest {
      */
     SubnetId?: string;
     /**
-     * 实例密码。自定义密码长度为8-32个字符，至少包含字母、数字和字符（!@#%^*()_）中的两种。
+     * 实例密码。设置要求如下：
+  - 字符个数为[8,32]。
+  - 可输入[A,Z]、[a,z]、[0,9]范围内的字符。
+  - 可输入的特殊字符包括：感叹号“!”，at“@”，警号“#“、百分号”%”、插入号“^”、星号“*”、括号“()”、下划线“_”。
+  - 不能设置单一的字母或者数字。
      */
     Password?: string;
     /**
@@ -251,7 +255,7 @@ export interface KillOpsRequest {
  */
 export interface InquirePriceRenewDBInstancesRequest {
     /**
-     * 实例ID，格式如：cmgo-p8vn****。与云数据库控制台页面中显示的实例ID相同，接口单次最多只支持5个实例进行操作。
+     * 实例ID，格式如：cmgo-p8vn****。请登录[MongoDB 控制台](https://console.cloud.tencent.com/mongodb)在实例列表复制实例 ID，且单次最多同时查询5个实例。
      */
     InstanceIds: Array<string>;
     /**

package/tencentcloud/services/ses/v20201002/ses_models.d.ts

@@ -287,23 +287,23 @@ export interface TemplatesMetadata {
     /**
      * 创建时间
      */
-    CreatedTimestamp: number;
+    CreatedTimestamp?: number;
     /**
      * 模板名称
      */
-    TemplateName: string;
+    TemplateName?: string;
     /**
      * 模板状态。1-审核中|0-已通过|2-拒绝|其它-不可用
      */
-    TemplateStatus: number;
+    TemplateStatus?: number;
     /**
      * 模板ID
      */
-    TemplateID: number;
+    TemplateID?: number;
     /**
      * 审核原因
      */
-    ReviewReason: string;
+    ReviewReason?: string;
 }
 /**
  * 收件人列表详情
@@ -323,17 +323,14 @@ export interface ReceiverDetail {
     TemplateData?: string;
     /**
      * 无效原因
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     Reason?: string;
     /**
      * 1:有效，2:无效
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     Status?: number;
     /**
      * 收件人地址id
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     EmailId?: number;
 }
@@ -397,36 +394,36 @@ export interface Volume {
      * 日期
   注意：此字段可能返回 null，表示取不到有效值。
      */
-    SendDate: string;
+    SendDate?: string;
     /**
      * 邮件请求数量
      */
-    RequestCount: number;
+    RequestCount?: number;
     /**
      * 腾讯云通过数量
      */
-    AcceptedCount: number;
+    AcceptedCount?: number;
     /**
      * 送达数量
      */
-    DeliveredCount: number;
+    DeliveredCount?: number;
     /**
      * 打开邮件的用户数量，根据收件人去重
      */
-    OpenedCount: number;
+    OpenedCount?: number;
     /**
      * 点击了邮件中的链接数量用户数量
      */
-    ClickedCount: number;
+    ClickedCount?: number;
     /**
      * 退信数量
      */
-    BounceCount: number;
+    BounceCount?: number;
     /**
      * 取消订阅的用户数量
   注意：此字段可能返回 null，表示取不到有效值。
      */
-    UnsubscribeCount: number;
+    UnsubscribeCount?: number;
 }
 /**
  * UpdateEmailIdentity请求参数结构体
@@ -703,12 +700,10 @@ export interface ReceiverData {
     Count?: number;
     /**
      * 收件人列表描述
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     Desc?: string;
     /**
      * 列表状态(1 待上传 2 上传中 3 上传完成)
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     ReceiversStatus?: number;
     /**
@@ -717,7 +712,6 @@ export interface ReceiverData {
     CreateTime?: string;
     /**
      * 无效收件人数量
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     InvalidCount?: number;
 }
@@ -908,27 +902,22 @@ export interface ListEmailTemplatesRequest {
 export interface CreateReceiverDetailWithDataResponse {
     /**
      * 收件人总数
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     TotalCount?: number;
     /**
      * 实际上传数量
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     ValidCount?: number;
     /**
      * 数据过长数量
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     TooLongCount?: number;
     /**
      * 邮件地址为空数量
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     EmptyEmailCount?: number;
     /**
      * 重复数量
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     RepeatCount?: number;
     /**
@@ -1274,7 +1263,6 @@ export interface BlackEmailAddress {
     EmailAddress?: string;
     /**
      * 被拉黑的理由
-  注意：此字段可能返回 null，表示取不到有效值。
      */
     IspDesc?: string;
 }