tencentcloud-sdk-nodejs 4.0.223 → 4.0.227

package/src/services/tem/v20210701/tem_models.ts

@@ -238,6 +238,11 @@ export interface DescribeDeployApplicationDetailRequest {
    * 环境id
    */
   EnvironmentId?: string
+
+  /**
+   * 版本部署id
+   */
+  VersionId?: string
 }
 
 /**

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

@@ -20,37 +20,51 @@ import { ClientConfig } from "../../../common/interface"
 import {
   DetectProductBetaResponse,
   DetectDisgustRequest,
-  DetectCelebrityResponse,
+  SearchImageResponse,
+  CreateImageRequest,
+  DeleteImagesResponse,
   CropImageRequest,
   DetectProductRequest,
+  DescribeGroupsRequest,
   AssessQualityResponse,
   DetectDisgustResponse,
+  SearchImageRequest,
+  RecognizeCarResponse,
   DetectLabelRequest,
   DetectLabelResponse,
   EnhanceImageResponse,
   ProductInfo,
   AssessQualityRequest,
+  DeleteImagesRequest,
+  CreateGroupRequest,
+  DescribeImagesRequest,
   DetectProductBetaRequest,
   DetectMisbehaviorResponse,
   RecognizeCarRequest,
   EnhanceImageRequest,
+  GroupInfo,
   CropImageResponse,
   DetectCelebrityRequest,
   Coord,
   Face,
   DetectProductResponse,
   DetectLabelBetaRequest,
+  CreateImageResponse,
   DetectLabelItem,
   Location,
   CarPlateContent,
   DetectLabelBetaResponse,
+  ImageInfo,
+  RegionDetected,
   Labels,
+  DetectCelebrityResponse,
   Product,
-  RegionDetected,
+  DescribeGroupsResponse,
   CarTagItem,
   Threshold,
-  RecognizeCarResponse,
+  DescribeImagesResponse,
   DetectMisbehaviorRequest,
+  CreateGroupResponse,
 } from "./tiia_models"
 
 /**
@@ -62,6 +76,16 @@ export class Client extends AbstractClient {
     super("tiia.tencentcloudapi.com", "2019-05-29", clientConfig)
   }
 
+  /**
+   * 创建图片，并添加对应图片的自定义信息。
+   */
+  async CreateImage(
+    req: CreateImageRequest,
+    cb?: (error: string, rep: CreateImageResponse) => void
+  ): Promise<CreateImageResponse> {
+    return this.request("CreateImage", req, cb)
+  }
+
   /**
      * 商品识别-微信识物版，基于人工智能技术、海量训练图片、亿级商品库，可以实现全覆盖、细粒度、高准确率的商品识别和商品推荐功能。
 本服务可以识别出图片中的主体位置、主体商品类型，覆盖亿级SKU，输出具体商品的价格、型号等详细信息。
@@ -149,6 +173,26 @@ export class Client extends AbstractClient {
     return this.request("DetectDisgust", req, cb)
   }
 
+  /**
+   * 查询所有的图库信息。
+   */
+  async DescribeGroups(
+    req: DescribeGroupsRequest,
+    cb?: (error: string, rep: DescribeGroupsResponse) => void
+  ): Promise<DescribeGroupsResponse> {
+    return this.request("DescribeGroups", req, cb)
+  }
+
+  /**
+   * 删除图片。
+   */
+  async DeleteImages(
+    req: DeleteImagesRequest,
+    cb?: (error: string, rep: DeleteImagesResponse) => void
+  ): Promise<DeleteImagesResponse> {
+    return this.request("DeleteImages", req, cb)
+  }
+
   /**
      * 图像标签测试接口
 
@@ -176,6 +220,16 @@ export class Client extends AbstractClient {
     return this.request("CropImage", req, cb)
   }
 
+  /**
+   * 获取指定图片库中的图片列表。
+   */
+  async DescribeImages(
+    req: DescribeImagesRequest,
+    cb?: (error: string, rep: DescribeImagesResponse) => void
+  ): Promise<DescribeImagesResponse> {
+    return this.request("DescribeImages", req, cb)
+  }
+
   /**
      * 可以识别输入的图片中是否包含不良行为，例如打架斗殴、赌博、抽烟等，可以应用于广告图、直播截图、短视频截图等审核，减少不良行为对平台内容质量的影响，维护健康向上的互联网环境。
 >     
@@ -188,6 +242,17 @@ export class Client extends AbstractClient {
     return this.request("DetectMisbehavior", req, cb)
   }
 
+  /**
+     * 用于创建一个空的图片库，如果图片库已存在则返回错误。
+
+     */
+  async CreateGroup(
+    req: CreateGroupRequest,
+    cb?: (error: string, rep: CreateGroupResponse) => void
+  ): Promise<CreateGroupResponse> {
+    return this.request("CreateGroup", req, cb)
+  }
+
   /**
      * 本接口支持识别图片中包含的商品，能够输出商品的品类名称、类别，还可以输出商品在图片中的位置。支持一张图片多个商品的识别。
 >     
@@ -200,6 +265,16 @@ export class Client extends AbstractClient {
     return this.request("DetectProduct", req, cb)
   }
 
+  /**
+   * 本接口用于对一张待识别的商品图片，在指定图片库中检索出最相似的图片列表。
+   */
+  async SearchImage(
+    req: SearchImageRequest,
+    cb?: (error: string, rep: SearchImageResponse) => void
+  ): Promise<SearchImageResponse> {
+    return this.request("SearchImage", req, cb)
+  }
+
   /**
      * 传入一张图片，输出清晰度提升后的图片。
 

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

@@ -68,22 +68,19 @@ export interface DetectDisgustRequest {
 }
 
 /**
- * DetectCelebrity返回参数结构体
+ * SearchImage返回参数结构体
  */
-export interface DetectCelebrityResponse {
+export interface SearchImageResponse {
   /**
-   * 公众人物识别结果数组。如果检测不到人脸，返回为空；最多可以返回10个人脸识别结果。
+   * 返回结果数量。
    */
-  Faces?: Array<Face>
+  Count: number
 
   /**
-      * 本服务在不同误识率水平下（将图片中的人物识别错误的比例）的推荐阈值，可以用于控制识别结果的精度。 
-FalseRate1Percent, FalseRate5Permil, FalseRate1Permil分别代表误识率在百分之一、千分之五、千分之一情况下的推荐阈值。 
-因为阈值会存在变动，请勿将此处输出的固定值处理，而是每次取值与confidence对比，来判断本次的识别结果是否可信。
- 例如，如果您业务中可以接受的误识率是1%，则可以将所有confidence>=FalseRate1Percent的结论认为是正确的。
+      * 图片信息。
 注意：此字段可能返回 null，表示取不到有效值。
       */
-  Threshold?: Threshold
+  ImageInfos: Array<ImageInfo>
 
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -91,6 +88,65 @@ FalseRate1Percent, FalseRate5Permil, FalseRate1Permil分别代表误识率在百
   RequestId?: string
 }
 
+/**
+ * CreateImage请求参数结构体
+ */
+export interface CreateImageRequest {
+  /**
+   * 图库ID。
+   */
+  GroupId: string
+
+  /**
+      * 物品ID，最多支持64个字符。 
+若EntityId已存在，则对其追加图片。
+      */
+  EntityId: string
+
+  /**
+      * 图片名称，最多支持64个字符， 
+同一个EntityId，最大支持5张图。如果图片名称已存在，则会更新库中的图片。
+      */
+  PicName: string
+
+  /**
+      * 图片的 Url 。对应图片 base64 编码后大小不可超过2M。  
+Url、Image必须提供一个，如果都提供，只使用 Url。 
+图片分辨率不超过1920*1080。
+图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+非腾讯云存储的Url速度和稳定性可能受一定影响。 
+支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+      */
+  ImageUrl?: string
+
+  /**
+      * 图片 base64 数据，base64 编码后大小不可超过2M。 
+图片分辨率不超过1920*1080。 
+支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+      */
+  ImageBase64?: string
+
+  /**
+   * 用户自定义的内容，最多支持4096个字符，查询时原样带回。
+   */
+  CustomContent?: string
+
+  /**
+   * 图片自定义标签，最多不超过10个，格式为JSON。
+   */
+  Tags?: string
+}
+
+/**
+ * DeleteImages返回参数结构体
+ */
+export interface DeleteImagesResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * CropImage请求参数结构体
  */
@@ -151,6 +207,26 @@ export interface DetectProductRequest {
   ImageBase64?: string
 }
 
+/**
+ * DescribeGroups请求参数结构体
+ */
+export interface DescribeGroupsRequest {
+  /**
+   * 起始序号，默认值为0。
+   */
+  Offset?: number
+
+  /**
+   * 返回数量，默认值为10，最大值为100。
+   */
+  Limit?: number
+
+  /**
+   * 图库ID，如果不为空，则返回指定库信息。
+   */
+  GroupId?: string
+}
+
 /**
  * AssessQuality返回参数结构体
  */
@@ -216,6 +292,73 @@ export interface DetectDisgustResponse {
   RequestId?: string
 }
 
+/**
+ * SearchImage请求参数结构体
+ */
+export interface SearchImageRequest {
+  /**
+   * 图库名称。
+   */
+  GroupId: string
+
+  /**
+      * 图片的 Url 。对应图片 base64 编码后大小不可超过2M。 
+图片分辨率不超过1920*1080。 
+Url、Image必须提供一个，如果都提供，只使用 Url。 
+图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+非腾讯云存储的Url速度和稳定性可能受一定影响。 
+支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+      */
+  ImageUrl?: string
+
+  /**
+      * 图片 base64 数据，base64 编码后大小不可超过2M。 
+图片分辨率不超过1920*1080。 
+支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+      */
+  ImageBase64?: string
+
+  /**
+   * 出参Score中，只有超过MatchThreshold值的结果才会返回。默认为0
+   */
+  MatchThreshold?: number
+
+  /**
+   * 起始序号，默认值为0。
+   */
+  Offset?: number
+
+  /**
+   * 返回数量，默认值为10，最大值为100。
+   */
+  Limit?: number
+
+  /**
+   * 针对入库时提交的Tags信息进行条件过滤。支持>、>=、 <、 <=、=，!=，多个条件之间支持AND和OR进行连接。
+   */
+  Filter?: string
+}
+
+/**
+ * RecognizeCar返回参数结构体
+ */
+export interface RecognizeCarResponse {
+  /**
+   * 汽车的四个矩形顶点坐标，如果图片中存在多辆车，则输出最大车辆的坐标。
+   */
+  CarCoords?: Array<Coord>
+
+  /**
+   * 车辆属性识别的结果数组，如果识别到多辆车，则会输出每辆车的top1结果。
+   */
+  CarTags?: Array<CarTagItem>
+
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * DetectLabel请求参数结构体
  */
@@ -374,6 +517,84 @@ export interface AssessQualityRequest {
   ImageBase64?: string
 }
 
+/**
+ * DeleteImages请求参数结构体
+ */
+export interface DeleteImagesRequest {
+  /**
+   * 图库名称。
+   */
+  GroupId: string
+
+  /**
+   * 物品ID。
+   */
+  EntityId: string
+
+  /**
+   * 图片名称，如果不指定本参数，则删除EntityId下所有的图片；否则删除指定的图。
+   */
+  PicName?: string
+}
+
+/**
+ * CreateGroup请求参数结构体
+ */
+export interface CreateGroupRequest {
+  /**
+   * 图库ID，不可重复，仅支持字母、数字和下划线。
+   */
+  GroupId: string
+
+  /**
+   * 图库名称描述。
+   */
+  GroupName: string
+
+  /**
+   * 该库的容量限制。
+   */
+  MaxCapacity: number
+
+  /**
+   * 简介。
+   */
+  Brief?: string
+
+  /**
+   * 该库的访问限频 ，默认10。
+   */
+  MaxQps?: number
+
+  /**
+      * 图库类型， 默认为通用。
+类型： 
+1: 通用图库，以用户输入图提取特征。
+2: 灰度图库，输入图和搜索图均转为灰度图提取特征。
+      */
+  GroupType?: number
+}
+
+/**
+ * DescribeImages请求参数结构体
+ */
+export interface DescribeImagesRequest {
+  /**
+   * 图库名称。
+   */
+  GroupId: string
+
+  /**
+   * 物品ID。
+   */
+  EntityId: string
+
+  /**
+   * 图片名称。
+   */
+  PicName?: string
+}
+
 /**
  * DetectProductBeta请求参数结构体
  */
@@ -458,6 +679,58 @@ export interface EnhanceImageRequest {
   ImageBase64?: string
 }
 
+/**
+ * 图库信息。
+ */
+export interface GroupInfo {
+  /**
+   * 图库Id。
+   */
+  GroupId: string
+
+  /**
+   * 图库名称。
+   */
+  GroupName: string
+
+  /**
+   * 图库简介。
+   */
+  Brief: string
+
+  /**
+   * 图库容量。
+   */
+  MaxCapacity: number
+
+  /**
+   * 该库的访问限频 。
+   */
+  MaxQps: number
+
+  /**
+      * 图库类型： 
+1: 通用图库，以用户输入图提取特征。
+2: 灰度图库，输入图和搜索图均转为灰度图提取特征。
+      */
+  GroupType: number
+
+  /**
+   * 图库图片数量。
+   */
+  PicCount: number
+
+  /**
+   * 图库创建时间。
+   */
+  CreateTime: string
+
+  /**
+   * 图库更新时间。
+   */
+  UpdateTime: string
+}
+
 /**
  * CropImage返回参数结构体
  */
@@ -652,6 +925,16 @@ LOCATION，主体位置识别；
   Scenes?: Array<string>
 }
 
+/**
+ * CreateImage返回参数结构体
+ */
+export interface CreateImageResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * 图像标签检测结果。
  */
@@ -778,6 +1061,59 @@ export interface DetectLabelBetaResponse {
   RequestId?: string
 }
 
+/**
+ * 图片信息
+ */
+export interface ImageInfo {
+  /**
+   * 图片名称。
+   */
+  EntityId: string
+
+  /**
+   * 用户自定义的内容。
+   */
+  CustomContent: string
+
+  /**
+   * 图片自定义标签，JSON格式。
+   */
+  Tags: string
+
+  /**
+   * 图片名称。
+   */
+  PicName: string
+
+  /**
+   * 相似度。
+   */
+  Score: number
+}
+
+/**
+ * 检测到的图片中的商品位置和品类预测。 
+当图片中存在多个商品时，输出多组坐标，按照__显著性__排序（综合考虑面积、是否在中心、检测算法置信度）。 
+最多可以输出__3组__检测结果。
+ */
+export interface RegionDetected {
+  /**
+      * 商品的品类预测结果。 
+包含：鞋、图书音像、箱包、美妆个护、服饰、家电数码、玩具乐器、食品饮料、珠宝、家居家装、药品、酒水、绿植园艺、其他商品、非商品等。
+      */
+  Category: string
+
+  /**
+   * 商品品类预测的置信度
+   */
+  CategoryScore: number
+
+  /**
+   * 检测到的主体在图片中的坐标，表示为矩形框的四个顶点坐标
+   */
+  Location: Location
+}
+
 /**
  * 名人识别的标签
  */
@@ -795,6 +1131,30 @@ export interface Labels {
   SecondLabel: string
 }
 
+/**
+ * DetectCelebrity返回参数结构体
+ */
+export interface DetectCelebrityResponse {
+  /**
+   * 公众人物识别结果数组。如果检测不到人脸，返回为空；最多可以返回10个人脸识别结果。
+   */
+  Faces?: Array<Face>
+
+  /**
+      * 本服务在不同误识率水平下（将图片中的人物识别错误的比例）的推荐阈值，可以用于控制识别结果的精度。 
+FalseRate1Percent, FalseRate5Permil, FalseRate1Permil分别代表误识率在百分之一、千分之五、千分之一情况下的推荐阈值。 
+因为阈值会存在变动，请勿将此处输出的固定值处理，而是每次取值与confidence对比，来判断本次的识别结果是否可信。
+ 例如，如果您业务中可以接受的误识率是1%，则可以将所有confidence>=FalseRate1Percent的结论认为是正确的。
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  Threshold?: Threshold
+
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * 检测到的单个商品结构体
  */
@@ -836,26 +1196,19 @@ export interface Product {
 }
 
 /**
- * 检测到的图片中的商品位置和品类预测。 
-当图片中存在多个商品时，输出多组坐标，按照__显著性__排序（综合考虑面积、是否在中心、检测算法置信度）。 
-最多可以输出__3组__检测结果。
+ * DescribeGroups返回参数结构体
  */
-export interface RegionDetected {
+export interface DescribeGroupsResponse {
   /**
-      * 商品的品类预测结果。 
-包含：鞋、图书音像、箱包、美妆个护、服饰、家电数码、玩具乐器、食品饮料、珠宝、家居家装、药品、酒水、绿植园艺、其他商品、非商品等。
+      * 图库信息
+注意：此字段可能返回 null，表示取不到有效值。
       */
-  Category: string
+  Groups: Array<GroupInfo>
 
   /**
-   * 商品品类预测的置信度
-   */
-  CategoryScore: number
-
-  /**
-   * 检测到的主体在图片中的坐标，表示为矩形框的四个顶点坐标
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
-  Location: Location
+  RequestId?: string
 }
 
 /**
@@ -928,18 +1281,23 @@ export interface Threshold {
 }
 
 /**
- * RecognizeCar返回参数结构体
+ * DescribeImages返回参数结构体
  */
-export interface RecognizeCarResponse {
+export interface DescribeImagesResponse {
   /**
-   * 汽车的四个矩形顶点坐标，如果图片中存在多辆车，则输出最大车辆的坐标。
+   * 图库名称。
    */
-  CarCoords?: Array<Coord>
+  GroupId: string
 
   /**
-   * 车辆属性识别的结果数组，如果识别到多辆车，则会输出每辆车的top1结果。
+   * 物品ID。
    */
-  CarTags?: Array<CarTagItem>
+  EntityId: string
+
+  /**
+   * 图片信息。
+   */
+  ImageInfos: Array<ImageInfo>
 
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
@@ -969,3 +1327,13 @@ export interface DetectMisbehaviorRequest {
    */
   ImageBase64?: string
 }
+
+/**
+ * CreateGroup返回参数结构体
+ */
+export interface CreateGroupResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}