tencentcloud-sdk-nodejs 4.0.889 → 4.0.891

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

@@ -20,7 +20,7 @@
  */
 export interface ChatCompletionsRequest {
   /**
-   * 模型名称，可选值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-pro。
+   * 模型名称，可选值包括 hunyuan-lite、hunyuan-standard、hunyuan-standard-256K、hunyuan-pro、 hunyuan-code、 hunyuan-role、 hunyuan-functioncall、 hunyuan-vision。
 各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。
 
 注意：
@@ -31,8 +31,8 @@ export interface ChatCompletionsRequest {
    * 聊天上下文信息。
 说明：
 1. 长度最多为 40，按对话时间从旧到新在数组中排列。
-2. Message.Role 可选值：system、user、assistant。
-其中，system 角色可选，如存在则必须位于列表的最开始。user 和 assistant 需交替出现（一问一答），以 user 提问开始和结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。
+2. Message.Role 可选值：system、user、assistant、 tool。
+其中，system 角色可选，如存在则必须位于列表的最开始。user（tool） 和 assistant 需交替出现（一问一答），以 user 提问开始，user（tool）提问结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。
 3. Messages 中 Content 总长度不能超过模型输入长度上限（可参考 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 文档），超过则会截断最前面的内容，只保留尾部内容。
    */
   Messages: Array<Message>
@@ -85,75 +85,144 @@ export interface ChatCompletionsRequest {
 4. 安全审核能力不属于功能增强范围，不受此字段影响。
    */
   EnableEnhancement?: boolean
+  /**
+   * 可调用的工具列表，仅对 hunyuan-functioncall 模型生效。
+   */
+  Tools?: Array<Tool>
+  /**
+   * 工具使用选项，可选值包括 none、auto、custom。
+说明：
+1. 仅对 hunyuan-functioncall 模型生效。
+2. none：不调用工具；auto：模型自行选择生成回复或调用工具；custom：强制模型调用指定的工具。
+3. 未设置时，默认值为auto
+   */
+  ToolChoice?: string
+  /**
+   * 强制模型调用指定的工具，当参数ToolChoice为custom时，此参数为必填
+   */
+  CustomTool?: Tool
 }
 
 /**
- * GetEmbedding返回参数结构体
+ * GetEmbedding请求参数结构体
  */
-export interface GetEmbeddingResponse {
+export interface GetEmbeddingRequest {
   /**
-   * 返回的 Embedding 信息。当前不支持批量，所以数组元素数目为 1。
+   * 输入文本。总长度不超过 1024 个 Token，超过则会截断最后面的内容。
    */
-  Data?: Array<EmbeddingData>
+  Input: string
+}
+
+/**
+ * 具体的图片内容
+ */
+export interface ImageUrl {
   /**
-   * Token 使用计数，按照总 Token 数量收费。
+   * 图片的 Url（以 http:// 或 https:// 开头）
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  Usage?: EmbeddingUsage
+  Url: string
+}
+
+/**
+ * 可以传入多种类型的内容，如图片或文本。当前只支持传入单张图片，传入多张图片时，以第一个图片为准。
+ */
+export interface Content {
   /**
-   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   * 内容类型
+注意：
+当前只支持传入单张图片，传入多张图片时，以第一个图片为准。
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  RequestId?: string
+  Type: string
+  /**
+   * 当 Type 为 text 时使用，表示具体的文本内容
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Text?: string
+  /**
+   * 当 Type 为 image_url 时使用，表示具体的图片内容
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ImageUrl?: ImageUrl
 }
 
 /**
- * QueryHunyuanImageJob请求参数结构体
+ * SubmitHunyuanImageJob请求参数结构体
  */
-export interface QueryHunyuanImageJobRequest {
+export interface SubmitHunyuanImageJobRequest {
   /**
-   * 任务 ID。
+   * 文本描述。 算法将根据输入的文本智能生成与之相关的图像。 不能为空，推荐使用中文。最多可传100个 utf-8 字符。
    */
-  JobId: string
+  Prompt: string
+  /**
+   * 绘画风格。
+请在 [混元生图风格列表](https://cloud.tencent.com/document/product/1729/105846) 中选择期望的风格，传入风格编号。
+不传默认不指定风格。
+   */
+  Style?: string
+  /**
+   * 生成图分辨率。
+支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3），不传默认使用1024:1024。
+   */
+  Resolution?: string
+  /**
+   * 为生成结果图添加显式水印标识的开关，默认为1。  
+1：添加。  
+0：不添加。  
+其他数值：默认按1处理。  
+建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+   */
+  LogoAdd?: number
+  /**
+   * prompt 扩写开关。1为开启，0为关闭，不传默认开启。
+开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。
+如果关闭扩写，将直接使用原始输入的 prompt 生成图片。
+建议开启，在多数场景下可提升生成图片效果、丰富生成图片细节。
+   */
+  Revise?: number
 }
 
 /**
- * 运行时异常信息。
+ * Token 数量
  */
-export interface ErrorMsg {
+export interface Usage {
   /**
-   * 错误提示信息。
+   * 输入 Token 数量。
    */
-  Msg?: string
+  PromptTokens?: number
   /**
-   * 错误码。
-4000 服务内部异常。
-4001 请求模型超时。
-
+   * 输出 Token 数量。
    */
-  Code?: number
+  CompletionTokens?: number
+  /**
+   * 总 Token 数量。
+   */
+  TotalTokens?: number
 }
 
 /**
- * GetEmbedding请求参数结构体
+ * QueryHunyuanImageJob请求参数结构体
  */
-export interface GetEmbeddingRequest {
+export interface QueryHunyuanImageJobRequest {
   /**
-   * 输入文本。总长度不超过 1024 个 Token，超过则会截断最后面的内容。
+   * 任务 ID。
    */
-  Input: string
+  JobId: string
 }
 
 /**
- * SubmitHunyuanImageJob返回参数结构体
+ * 用户指定模型使用的工具
  */
-export interface SubmitHunyuanImageJobResponse {
+export interface Tool {
   /**
-   * 任务 ID。
+   * 工具类型，当前只支持function
    */
-  JobId?: string
+  Type: string
   /**
-   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   * 具体要调用的function
    */
-  RequestId?: string
+  Function: ToolFunction
 }
 
 /**
@@ -220,6 +289,92 @@ export interface EmbeddingData {
   Object?: string
 }
 
+/**
+ * function定义
+ */
+export interface ToolFunction {
+  /**
+   * function名称，只能包含a-z，A-Z，0-9，\_或-
+   */
+  Name: string
+  /**
+   * function参数，一般为json字符串
+   */
+  Parameters: string
+  /**
+   * function的简单描述
+   */
+  Description?: string
+}
+
+/**
+ * 返回的内容（流式返回）
+ */
+export interface Delta {
+  /**
+   * 角色名称。
+   */
+  Role?: string
+  /**
+   * 内容详情。
+   */
+  Content?: string
+  /**
+   * 模型生成的工具调用，仅 hunyuan-functioncall 模型支持
+说明：
+对于每一次的输出值应该以Id为标识对Type、Name、Arguments字段进行合并。
+
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ToolCalls?: Array<ToolCall>
+}
+
+/**
+ * 具体的function调用
+ */
+export interface ToolCallFunction {
+  /**
+   * function名称
+   */
+  Name: string
+  /**
+   * function参数，一般为json字符串
+   */
+  Arguments: string
+}
+
+/**
+ * 模型生成的工具调用
+ */
+export interface ToolCall {
+  /**
+   * 工具调用id
+   */
+  Id: string
+  /**
+   * 工具调用类型，当前只支持function
+   */
+  Type: string
+  /**
+   * 具体的function调用
+   */
+  Function: ToolCallFunction
+}
+
+/**
+ * SubmitHunyuanImageJob返回参数结构体
+ */
+export interface SubmitHunyuanImageJobResponse {
+  /**
+   * 任务 ID。
+   */
+  JobId?: string
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * QueryHunyuanImageJob返回参数结构体
  */
@@ -265,71 +420,48 @@ export interface QueryHunyuanImageJobResponse {
 }
 
 /**
- * SubmitHunyuanImageJob请求参数结构体
+ * GetEmbedding返回参数结构体
  */
-export interface SubmitHunyuanImageJobRequest {
-  /**
-   * 文本描述。 算法将根据输入的文本智能生成与之相关的图像。 不能为空，推荐使用中文。最多可传100个 utf-8 字符。
-   */
-  Prompt: string
-  /**
-   * 绘画风格。
-请在 [混元生图风格列表](https://cloud.tencent.com/document/product/1729/105846) 中选择期望的风格，传入风格编号。
-不传默认不指定风格。
-   */
-  Style?: string
+export interface GetEmbeddingResponse {
   /**
-   * 生成图分辨率。
-支持生成以下分辨率的图片：768:768（1:1）、768:1024（3:4）、1024:768（4:3）、1024:1024（1:1）、720:1280（9:16）、1280:720（16:9）、768:1280（3:5）、1280:768（5:3），不传默认使用1024:1024。
+   * 返回的 Embedding 信息。当前不支持批量，所以数组元素数目为 1。
    */
-  Resolution?: string
+  Data?: Array<EmbeddingData>
   /**
-   * 为生成结果图添加显式水印标识的开关，默认为1。  
-1：添加。  
-0：不添加。  
-其他数值：默认按1处理。  
-建议您使用显著标识来提示结果图使用了 AI 绘画技术，是 AI 生成的图片。
+   * Token 使用计数，按照总 Token 数量收费。
    */
-  LogoAdd?: number
+  Usage?: EmbeddingUsage
   /**
-   * prompt 扩写开关。1为开启，0为关闭，不传默认开启。
-开启扩写后，将自动扩写原始输入的 prompt 并使用扩写后的 prompt 生成图片，返回生成图片结果时将一并返回扩写后的 prompt 文本。
-如果关闭扩写，将直接使用原始输入的 prompt 生成图片。
-建议开启，在多数场景下可提升生成图片效果、丰富生成图片细节。
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
    */
-  Revise?: number
+  RequestId?: string
 }
 
 /**
- * 返回的内容（流式返回）
+ * 运行时异常信息。
  */
-export interface Delta {
+export interface ErrorMsg {
   /**
-   * 角色名称。
+   * 错误提示信息。
    */
-  Role?: string
+  Msg?: string
   /**
-   * 内容详情。
+   * 错误码。
+4000 服务内部异常。
+4001 请求模型超时。
+
    */
-  Content?: string
+  Code?: number
 }
 
 /**
- * Token 数量
+ * GetTokenCount请求参数结构体
  */
-export interface Usage {
-  /**
-   * 输入 Token 数量。
-   */
-  PromptTokens?: number
-  /**
-   * 输出 Token 数量。
-   */
-  CompletionTokens?: number
+export interface GetTokenCountRequest {
   /**
-   * 总 Token 数量。
+   * 输入文本
    */
-  TotalTokens?: number
+  Prompt: string
 }
 
 /**
@@ -337,23 +469,28 @@ export interface Usage {
  */
 export interface Message {
   /**
-   * 角色，可选值包括 system、user、assistant。
+   * 角色，可选值包括 system、user、assistant、 tool。
    */
   Role: string
   /**
    * 文本内容
    */
   Content?: string
-}
-
-/**
- * GetTokenCount请求参数结构体
- */
-export interface GetTokenCountRequest {
   /**
-   * 输入文本
+   * 多种类型内容（目前支持图片和文本），仅 hunyuan-vision 模型支持
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  Prompt: string
+  Contents?: Array<Content>
+  /**
+   * 当role为tool时传入，标识具体的函数调用
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ToolCallId?: string
+  /**
+   * 模型生成的工具调用，仅 hunyuan-functioncall 模型支持
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  ToolCalls?: Array<ToolCall>
 }
 
 /**

package/src/services/iotexplorer/v20190423/iotexplorer_client.ts

@@ -45,7 +45,7 @@ import {
   GetDeviceListResponse,
   DismissRoomByStrRoomIdFromTRTCResponse,
   DescribeFirmwareUpdateStatusResponse,
-  GenerateSignedVideoURLRequest,
+  DeviceActiveResult,
   TopicRulePayload,
   DeleteLoRaFrequencyResponse,
   DescribeGatewaySubDeviceListResponse,
@@ -227,6 +227,7 @@ import {
   DescribeBindedProductsResponse,
   DeviceSignatureInfo,
   PositionSpaceInfo,
+  GenerateSignedVideoURLRequest,
   TWeCallInfo,
   LoRaGatewayLocation,
   DescribeDeviceRequest,

package/src/services/iotexplorer/v20190423/iotexplorer_models.ts

@@ -554,21 +554,24 @@ export interface DescribeFirmwareUpdateStatusResponse {
 }
 
 /**
- * GenerateSignedVideoURL请求参数结构体
+ * 设备激活结果数据
  */
-export interface GenerateSignedVideoURLRequest {
+export interface DeviceActiveResult {
   /**
-   * 视频播放原始URL地址
+   * 模版ID
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  VideoURL: string
+  ModelId?: string
   /**
-   * 播放链接过期时间
+   * SN信息
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  ExpireTime: number
+  Sn?: string
   /**
-   * 通道ID 非NVR设备不填 NVR设备必填 默认为无
+   * 设备激活状态，0：激活成功；9800020：设备数超出限制；9800040：资源包类型和设备类型不匹配；9800039：资源包余额不足；9800037：激活码序号已使用；9800038：设备有效期超出限制；
+注意：此字段可能返回 null，表示取不到有效值。
    */
-  ChannelId?: number
+  ErrCode?: number
 }
 
 /**
@@ -4281,6 +4284,24 @@ export interface PositionSpaceInfo {
   Zoom: number
 }
 
+/**
+ * GenerateSignedVideoURL请求参数结构体
+ */
+export interface GenerateSignedVideoURLRequest {
+  /**
+   * 视频播放原始URL地址
+   */
+  VideoURL: string
+  /**
+   * 播放链接过期时间
+   */
+  ExpireTime: number
+  /**
+   * 通道ID 非NVR设备不填 NVR设备必填 默认为无
+   */
+  ChannelId?: number
+}
+
 /**
  * TWeCall信息
  */
@@ -4547,6 +4568,11 @@ export interface CloudStorageEvent {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   UploadStatus?: string
+  /**
+   * 事件自定义数据	
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Data?: string
 }
 
 /**
@@ -5121,6 +5147,11 @@ export interface UpdateFirmwareRequest {
  * ActivateTWeCallLicense返回参数结构体
  */
 export interface ActivateTWeCallLicenseResponse {
+  /**
+   * 设备激活返回数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DeviceList?: Array<DeviceActiveResult>
   /**
    * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
    */
@@ -6223,7 +6254,7 @@ export interface UpdateDeviceTWeCallAuthorizeStatusResponse {
  */
 export interface ActivateTWeCallLicenseRequest {
   /**
-   * TWecall类型： 1-家庭安防场景； 2-穿戴类场景； 3-生活娱乐场景； 4-对讲及其它场景
+   * TWecall类型： 0-测试激活码； 1-家庭安防场景； 2-穿戴类场景； 3-生活娱乐场景； 4-对讲及其它场景
    */
   PkgType: number
   /**

package/src/services/iotvideo/v20211125/iotvideo_models.ts

@@ -3458,6 +3458,11 @@ export interface CloudStorageEvent {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   UploadStatus?: string
+  /**
+   * 事件自定义数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Data?: string
 }
 
 /**