tencentcloud-sdk-nodejs 4.0.889 → 4.0.890

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信息
  */
@@ -5121,6 +5142,11 @@ export interface UpdateFirmwareRequest {
  * ActivateTWeCallLicense返回参数结构体
  */
 export interface ActivateTWeCallLicenseResponse {
+  /**
+   * 设备激活返回数据
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  DeviceList?: Array<DeviceActiveResult>
   /**
    * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
    */
@@ -6223,7 +6249,7 @@ export interface UpdateDeviceTWeCallAuthorizeStatusResponse {
  */
 export interface ActivateTWeCallLicenseRequest {
   /**
-   * TWecall类型： 1-家庭安防场景； 2-穿戴类场景； 3-生活娱乐场景； 4-对讲及其它场景
+   * TWecall类型： 0-测试激活码； 1-家庭安防场景； 2-穿戴类场景； 3-生活娱乐场景； 4-对讲及其它场景
    */
   PkgType: number
   /**

package/src/services/ocr/v20181119/ocr_models.ts

@@ -10608,8 +10608,8 @@ export interface RecognizeGeneralTextImageWarnRequest {
   PdfPageNumber?: number
   /**
    * 支持的模板类型
-- General 通用告警
-- LicensePlate 车牌告警
+- General 通用告警（支持所有类型告警）
+- LicensePlate 车牌告警（支持翻拍告警）
    */
   Type?: string
 }

package/src/services/postgres/v20170312/postgres_models.ts

@@ -201,7 +201,7 @@ export interface DescribeAccountsRequest {
    */
   DBInstanceId: string
   /**
-   * 分页返回，每页最大返回数目，默认10，取值范围为1-100
+   * 分页返回，每页最大返回数目，默认20，取值范围为1-100
    */
   Limit?: number
   /**
@@ -209,7 +209,7 @@ export interface DescribeAccountsRequest {
    */
   Offset?: number
   /**
-   * 返回数据按照创建时间或者用户名排序。取值只能为createTime或者name。createTime-按照创建时间排序；name-按照用户名排序
+   * 返回数据按照创建时间或者用户名排序。取值支持createTime、name、updateTime。createTime-按照创建时间排序；name-按照用户名排序; updateTime-按照更新时间排序。
    */
   OrderBy?: string
   /**
@@ -4604,27 +4604,31 @@ export interface AccountInfo {
   /**
    * 实例ID，形如postgres-lnp6j617
    */
-  DBInstanceId: string
+  DBInstanceId?: string
   /**
-   * 帐号
+   * 账号
    */
-  UserName: string
+  UserName?: string
   /**
-   * 帐号备注
+   * 账号备注
    */
-  Remark: string
+  Remark?: string
+  /**
+   * 账号状态。 1-创建中，2-正常，3-修改中，4-密码重置中，5-锁定中，-1-删除中
+   */
+  Status?: number
   /**
-   * 帐号状态。 1-创建中，2-正常，3-修改中，4-密码重置中，-1-删除中
+   * 账号创建时间
    */
-  Status: number
+  CreateTime?: string
   /**
-   * 帐号创建时间
+   * 账号最后一次更新时间
    */
-  CreateTime: string
+  UpdateTime?: string
   /**
-   * 帐号最后一次更新时间
+   * 账号类型
    */
-  UpdateTime: string
+  UserType?: string
 }
 
 /**
@@ -5132,7 +5136,7 @@ export interface DescribeAccountsResponse {
    */
   TotalCount?: number
   /**
-   * 账号列表详细信息。
+   * 账号列表详细信息。当CreateTime项为0000-00-00 00:00:00时，意味着对应账号是直连数据库创建的，并非通过CreateAccount接口创建。
    */
   Details?: Array<AccountInfo>
   /**

package/src/services/ssl/v20191205/ssl_models.ts

@@ -372,6 +372,11 @@ export interface DeployRecordDetail {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   Region?: string
+  /**
+   * 部署CLB监听器的Url
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Url?: Array<string>
 }
 
 /**
@@ -1144,6 +1149,11 @@ export interface ClbListenerRule {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   NoMatchDomains?: Array<string>
+  /**
+   * 规则绑定的路径
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Url?: string
 }
 
 /**
@@ -1739,6 +1749,11 @@ export interface UpdateRecordDetail {
 注意：此字段可能返回 null，表示取不到有效值。
    */
   TCBType?: string
+  /**
+   * 监听器Url(clb专属)
+注意：此字段可能返回 null，表示取不到有效值。
+   */
+  Url?: string
 }
 
 /**

package/src/services/tiia/v20190529/tiia_client.ts

@@ -124,7 +124,9 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 商品识别-微信识物版，基于人工智能技术、海量训练图片、亿级商品库，可以实现全覆盖、细粒度、高准确率的商品识别和商品推荐功能。
+     * 产品不再维护，准备下线。
+
+商品识别-微信识物版，基于人工智能技术、海量训练图片、亿级商品库，可以实现全覆盖、细粒度、高准确率的商品识别和商品推荐功能。
 本服务可以识别出图片中的主体位置、主体商品类型，覆盖亿级SKU，输出具体商品的价格、型号等详细信息。
 客户无需自建商品库，即可快速实现商品识别、拍照搜商品等功能。
 >?   

package/src/services/trocket/v20230308/trocket_client.ts

@@ -564,11 +564,11 @@ export class Client extends AbstractClient {
   }
 
   /**
-     * 获取实例列表，Filters参数使用说明如下：
+     * 获取集群列表，仅支持 5.x 集群，Filters参数使用说明如下：
 1. InstanceName, 名称模糊查询
-2. InstanceId，实例ID查询
-3. InstanceType, 实例类型查询，支持多选
-3. InstanceStatus，实例状态查询，支持多选
+2. InstanceId，集群ID查询
+3. InstanceType, 集群类型查询，支持多选
+3. InstanceStatus，集群状态查询，支持多选
 
 当使用TagFilters查询时，Filters参数失效。
      */