tencentcloud-sdk-nodejs 4.0.833 → 4.0.834

package/src/services/hunyuan/v20230901/hunyuan_client.ts

@@ -45,11 +45,11 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 腾讯混元大模型高级版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为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/ 目录下有提供示例供参考。
      */
   async ChatPro(
     req: ChatProRequest,
@@ -59,11 +59,11 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 腾讯混元大模型标准版是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口为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/ 目录下有提供示例供参考。
      */
   async ChatStd(
     req: ChatStdRequest,

package/src/services/hunyuan/v20230901/hunyuan_models.ts

@@ -77,12 +77,12 @@ export interface ErrorMsg {
  */
 export interface ChatStdResponse {
   /**
-   * unix 时间戳，单位为秒。
+   * Unix 时间戳，单位为秒。
    */
   Created?: number
   /**
-   * token统计信息。
-按照总token数量计费。
+   * Token 统计信息。
+按照总 Token 数量计费。
    */
   Usage?: Usage
   /**
@@ -90,7 +90,7 @@ export interface ChatStdResponse {
    */
   Note?: string
   /**
-   * 本轮对话的id。
+   * 本轮对话的 ID。
    */
   Id?: string
   /**
@@ -124,12 +124,12 @@ export interface GetEmbeddingRequest {
  */
 export interface ChatProResponse {
   /**
-   * unix 时间戳，单位为秒。
+   * Unix 时间戳，单位为秒。
    */
   Created?: number
   /**
-   * token统计信息。
-按照总token数量计费。
+   * Token 统计信息。
+按照总 Token 数量计费。
    */
   Usage?: Usage
   /**
@@ -137,7 +137,7 @@ export interface ChatProResponse {
    */
   Note?: string
   /**
-   * 本轮对话的id。
+   * 本轮对话的 ID。
    */
   Id?: string
   /**
@@ -161,13 +161,19 @@ export interface ChatProResponse {
  */
 export interface Choice {
   /**
-   * 流式结束标志位，为 stop 则表示尾包。
+   * 结束标志位，为 stop 则表示尾包。
    */
   FinishReason?: string
   /**
-   * 返回值。
+   * 增量返回值，流式调用时使用该字段。
+注意：此字段可能返回 null，表示取不到有效值。
    */
   Delta?: Delta
+  /**
+   * 返回值，非流式调用时使用该字段。
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Message?: Message
 }
 
 /**
@@ -177,25 +183,46 @@ export interface ChatProRequest {
   /**
    * 聊天上下文信息。
 说明：
-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。
    */
   Messages: Array<Message>
   /**
    * 说明：
-1.影响输出文本的多样性，取值越大，生成文本的多样性越强。
-2.默认1.0，取值区间为[0.0, 1.0]。
-3.非必要不建议使用, 不合理的取值会影响效果。
+1. 影响输出文本的多样性，取值越大，生成文本的多样性越强。
+2. 默认 1.0，取值区间为 [0.0, 1.0]。
+3. 非必要不建议使用，不合理的取值会影响效果。
    */
   TopP?: number
   /**
    * 说明：
-1.较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
-2.默认1.0，取值区间为[0.0，2.0]。
-3.非必要不建议使用,不合理的取值会影响效果。
+1. 较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
+2. 默认 1.0，取值区间为 [0.0，2.0]。
+3. 非必要不建议使用，不合理的取值会影响效果。
    */
   Temperature?: number
+  /**
+   * 流式调用开关。
+说明：
+1. 未传值时默认为流式调用。
+2. 流式调用时以 SSE 协议增量返回结果。
+3. 非流式调用时接口响应耗时较长，非必要不建议使用。
+4. 非流式调用时只返回一次最终结果，调用方式与普通 HTTP 请求无异。
+   */
+  Stream?: boolean
+  /**
+   * 流式输出审核开关。
+说明：
+1. 当 Stream 字段值为 true 时，该字段有效。
+2. 未传值时默认不使用流式输出审核。
+3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
+
+注意：
+当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+   */
+  StreamModeration?: boolean
 }
 
 /**
@@ -266,7 +293,7 @@ export interface Usage {
 }
 
 /**
- * 会话内容,  按对话时间序排列，长度最多为40
+ * 单条消息
  */
 export interface Message {
   /**
@@ -274,7 +301,7 @@ export interface Message {
    */
   Role: string
   /**
-   * 消息的内容
+   * 消息内容
    */
   Content: string
 }
@@ -296,23 +323,45 @@ export interface ChatStdRequest {
   /**
    * 聊天上下文信息。
 说明：
-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。
+
    */
   Messages: Array<Message>
   /**
    * 说明：
-1.影响输出文本的多样性，取值越大，生成文本的多样性越强。
-2.默认1.0，取值区间为[0.0, 1.0]。
-3.非必要不建议使用, 不合理的取值会影响效果。
+1. 影响输出文本的多样性，取值越大，生成文本的多样性越强。
+2. 默认 1.0，取值区间为 [0.0, 1.0]。
+3. 非必要不建议使用，不合理的取值会影响效果。
    */
   TopP?: number
   /**
    * 说明：
-1.较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
-2.默认1.0，取值区间为[0.0，2.0]。
-3.非必要不建议使用,不合理的取值会影响效果。
+1. 较高的数值会使输出更加随机，而较低的数值会使其更加集中和确定。
+2. 默认 1.0，取值区间为 [0.0，2.0]。
+3. 非必要不建议使用，不合理的取值会影响效果。
    */
   Temperature?: number
+  /**
+   * 流式调用开关。
+说明：
+1. 未传值时默认为流式调用。
+2. 流式调用时以 SSE 协议增量返回结果。
+3. 非流式调用时接口响应耗时较长，非必要不建议使用。
+4. 非流式调用时只返回一次最终结果，调用方式与普通 HTTP 请求无异。
+   */
+  Stream?: boolean
+  /**
+   * 流式输出审核开关。
+说明：
+1. 当 Stream 字段值为 true 时，该字段有效。
+2. 未传值时默认不使用流式输出审核。
+3. 如果值为 true，将对输出内容进行分段审核，审核通过的内容流式输出返回。如果出现审核不过，响应中的 finish_reason 值为 sensitive。
+4. 如果值为 false，则需要审核完所有输出内容后再返回结果。
+
+注意：
+当选择流式输出审核时，可能会出现部分内容已输出，但中间某一段响应中的 finish_reason 值为 sensitive，此时说明安全审核未通过。如果业务场景有实时文字上屏的需求，需要自行撤回已上屏的内容，并建议自定义替换为一条提示语，如 “这个问题我不方便回答，不如我们换个话题试试”，以保障终端体验。
+   */
+  StreamModeration?: boolean
 }

package/src/services/index.ts

@@ -133,6 +133,7 @@ export { kms } from "./kms"
 export { lcic } from "./lcic"
 export { lighthouse } from "./lighthouse"
 export { live } from "./live"
+export { lke } from "./lke"
 export { lowcode } from "./lowcode"
 export { lp } from "./lp"
 export { mall } from "./mall"

package/src/services/lke/index.ts

@@ -0,0 +1,5 @@
+import { v20231130 } from "./v20231130"
+
+export const lke = {
+  v20231130: v20231130,
+}

package/src/services/lke/v20231130/index.ts

@@ -0,0 +1,6 @@
+import * as Models from "./lke_models"
+import { Client } from "./lke_client"
+export const v20231130 = {
+  Client: Client,
+  Models: Models,
+}