tencentcloud-sdk-nodejs-iai 4.0.330 → 4.0.333

package/src/services/iai/v20180301/iai_models.ts

@@ -143,6 +143,21 @@ export interface SearchPersonsReturnsByGroupResponse {
   RequestId?: string
 }
 
+/**
+ * 包含此人员的人员库及描述字段内容列表
+ */
+export interface PersonGroupInfo {
+  /**
+   * 包含此人员的人员库ID
+   */
+  GroupId: string
+
+  /**
+   * 人员描述字段内容
+   */
+  PersonExDescriptions: Array<string>
+}
+
 /**
  * 帽子信息
  */
@@ -461,21 +476,26 @@ export interface FaceInfo {
 }
 
 /**
- * CheckSimilarPerson请求参数结构体
+ * 眉毛信息
  */
-export interface CheckSimilarPersonRequest {
+export interface Eyebrow {
   /**
-      * 待整理的人员库列表。 
-人员库总人数不可超过200万，人员库个数不可超过10个。
+      * 眉毛浓密。
+AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。
       */
-  GroupIds: Array<string>
+  EyebrowDensity: AttributeItem
 
   /**
-      * 人员查重整理力度的控制。
-1：力度较高的人员整理，能够消除更多的重复身份，对应稍高的非重复身份误清除率；
-2：力度较低的人员整理，非重复身份的误清除率较低，对应稍低的重复身份消除率。
+      * 眉毛弯曲。
+AttributeItem对应的Type为 —— 0：不弯，1：弯眉。
       */
-  UniquePersonControl: number
+  EyebrowCurve: AttributeItem
+
+  /**
+      * 眉毛长短。
+AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
+      */
+  EyebrowLength: AttributeItem
 }
 
 /**
@@ -722,21 +742,6 @@ export interface CopyPersonResponse {
   RequestId?: string
 }
 
-/**
- * EstimateCheckSimilarPersonCostTime返回参数结构体
- */
-export interface EstimateCheckSimilarPersonCostTimeResponse {
-  /**
-   * 人员查重任务预估需要耗费时间。 单位为分钟。
-   */
-  EstimatedTimeCost?: number
-
-  /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-   */
-  RequestId?: string
-}
-
 /**
  * 分组识别结果Item
  */
@@ -859,27 +864,6 @@ export interface DeleteGroupRequest {
   GroupId: string
 }
 
-/**
- * EstimateCheckSimilarPersonCostTime请求参数结构体
- */
-export interface EstimateCheckSimilarPersonCostTimeRequest {
-  /**
-      * 待整理的人员库列表。 
-人员库总人数不可超过200万，人员库个数不可超过10个。
-      */
-  GroupIds: Array<string>
-}
-
-/**
- * RevertGroupFaceModelVersion返回参数结构体
- */
-export interface RevertGroupFaceModelVersionResponse {
-  /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-   */
-  RequestId?: string
-}
-
 /**
  * UpgradeGroupFaceModelVersion请求参数结构体
  */
@@ -954,16 +938,6 @@ export interface GetPersonBaseInfoResponse {
   RequestId?: string
 }
 
-/**
- * GetSimilarPersonResult请求参数结构体
- */
-export interface GetSimilarPersonResultRequest {
-  /**
-   * 查重任务ID，用于查询、获取查重的进度和结果。
-   */
-  JobId: string
-}
-
 /**
  * SearchPersons返回参数结构体
  */
@@ -1196,26 +1170,6 @@ export interface DeletePersonFromGroupResponse {
   RequestId?: string
 }
 
-/**
- * GetCheckSimilarPersonJobIdList返回参数结构体
- */
-export interface GetCheckSimilarPersonJobIdListResponse {
-  /**
-   * 人员查重任务信息列表。
-   */
-  JobIdInfos?: Array<JobIdInfo>
-
-  /**
-   * 查重任务总数量。
-   */
-  JobIdNum?: number
-
-  /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-   */
-  RequestId?: string
-}
-
 /**
  * 稠密关键点详细信息
  */
@@ -1483,16 +1437,6 @@ AttributeItem对应的Type为 —— 0：黑色，1：金色，2：棕色，3：
   Color: AttributeItem
 }
 
-/**
- * GetPersonListNum请求参数结构体
- */
-export interface GetPersonListNumRequest {
-  /**
-   * 人员库ID
-   */
-  GroupId: string
-}
-
 /**
  * 人脸的识别结果
  */
@@ -1668,27 +1612,6 @@ export interface ModifyPersonBaseInfoResponse {
   RequestId?: string
 }
 
-/**
- * GetSimilarPersonResult返回参数结构体
- */
-export interface GetSimilarPersonResultResponse {
-  /**
-   * 查重任务完成进度。取值[0.0，100.0]。当且仅当值为100时，SimilarPersons才有意义。
-   */
-  Progress?: number
-
-  /**
-      * 疑似同一人的人员信息文件临时下载链接， 有效时间为5分钟，结果文件实际保存90天。
-文件内容由 SimilarPerson 的数组组成。
-      */
-  SimilarPersonsUrl?: string
-
-  /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
-   */
-  RequestId?: string
-}
-
 /**
  * ModifyPersonGroupInfo请求参数结构体
  */
@@ -1903,26 +1826,32 @@ export interface ModifyPersonBaseInfoRequest {
 }
 
 /**
- * 查重任务信息
+ * VerifyFace返回参数结构体
  */
-export interface JobIdInfo {
+export interface VerifyFaceResponse {
   /**
-   * 查重任务ID，用于查询、获取查重的进度和结果。
+      * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。
+
+不同算法版本返回的相似度分数不同。
+若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
+2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
+      */
+  Score: number
+
+  /**
+   * 是否为同一人的判断。
    */
-  JobId: string
+  IsMatch: boolean
 
   /**
-      * 查重起始时间。 
-StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。 
-Unix 纪元时间是 1970 年 1 月 1 日星期四，协调世界时 (UTC) 00:00:00。 
-有关更多信息，请参阅 Unix 时间。
-      */
-  StartTime: number
+   * 人脸识别所用的算法模型版本。
+   */
+  FaceModelVersion: string
 
   /**
-   * 查重任务是否已完成。0: 成功 1: 未完成 2: 失败
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
-  JobStatus: number
+  RequestId?: string
 }
 
 /**
@@ -2015,21 +1944,6 @@ MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要
   NeedRotateDetection?: number
 }
 
-/**
- * GetCheckSimilarPersonJobIdList请求参数结构体
- */
-export interface GetCheckSimilarPersonJobIdListRequest {
-  /**
-   * 起始序号，默认值为0。
-   */
-  Offset?: number
-
-  /**
-   * 返回数量，默认值为10，最大值为1000。
-   */
-  Limit?: number
-}
-
 /**
  * SearchPersons请求参数结构体
  */
@@ -2469,43 +2383,9 @@ AttributeItem对应的Type为 —— 0：不张嘴，1：张嘴。
 }
 
 /**
- * 包含此人员的人员库及描述字段内容列表
- */
-export interface PersonGroupInfo {
-  /**
-   * 包含此人员的人员库ID
-   */
-  GroupId: string
-
-  /**
-   * 人员描述字段内容
-   */
-  PersonExDescriptions: Array<string>
-}
-
-/**
- * VerifyFace返回参数结构体
+ * RevertGroupFaceModelVersion返回参数结构体
  */
-export interface VerifyFaceResponse {
-  /**
-      * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸（Face），返回相似度最大的分数。
-
-不同算法版本返回的相似度分数不同。
-若需要验证两张图片中人脸是否为同一人，3.0版本误识率千分之一对应分数为40分，误识率万分之一对应分数为50分，误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
-2.0版本误识率千分之一对应分数为70分，误识率万分之一对应分数为80分，误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
-      */
-  Score: number
-
-  /**
-   * 是否为同一人的判断。
-   */
-  IsMatch: boolean
-
-  /**
-   * 人脸识别所用的算法模型版本。
-   */
-  FaceModelVersion: string
-
+export interface RevertGroupFaceModelVersionResponse {
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -2705,41 +2585,13 @@ export interface DetectFaceResponse {
 }
 
 /**
- * CheckSimilarPerson返回参数结构体
+ * GetPersonListNum请求参数结构体
  */
-export interface CheckSimilarPersonResponse {
-  /**
-   * 查重任务ID，用于查询、获取查重的进度和结果。
-   */
-  JobId: string
-
+export interface GetPersonListNumRequest {
   /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   * 人员库ID
    */
-  RequestId?: string
-}
-
-/**
- * 眉毛信息
- */
-export interface Eyebrow {
-  /**
-      * 眉毛浓密。
-AttributeItem对应的Type为 —— 0：淡眉，1：浓眉。
-      */
-  EyebrowDensity: AttributeItem
-
-  /**
-      * 眉毛弯曲。
-AttributeItem对应的Type为 —— 0：不弯，1：弯眉。
-      */
-  EyebrowCurve: AttributeItem
-
-  /**
-      * 眉毛长短。
-AttributeItem对应的Type为 —— 0：短眉毛，1：长眉毛。
-      */
-  EyebrowLength: AttributeItem
+  GroupId: string
 }
 
 /**

package/src/services/iai/v20200303/iai_client.ts

@@ -21,6 +21,7 @@ import {
   Candidate,
   DetectFaceAttributesResponse,
   SearchPersonsReturnsByGroupResponse,
+  PersonGroupInfo,
   Hat,
   CreatePersonRequest,
   CreateFaceResponse,
@@ -29,7 +30,7 @@ import {
   CreateGroupRequest,
   GetPersonGroupInfoRequest,
   FaceInfo,
-  CheckSimilarPersonRequest,
+  Eyebrow,
   AnalyzeDenseLandmarksRequest,
   GetGroupListRequest,
   GetUpgradeGroupFaceModelVersionJobListRequest,
@@ -39,7 +40,6 @@ import {
   CreatePersonResponse,
   SearchFacesResponse,
   CopyPersonResponse,
-  EstimateCheckSimilarPersonCostTimeResponse,
   GroupCandidate,
   DeleteFaceResponse,
   DeletePersonRequest,
@@ -47,12 +47,9 @@ import {
   DeleteFaceRequest,
   ModifyGroupRequest,
   DeleteGroupRequest,
-  EstimateCheckSimilarPersonCostTimeRequest,
-  RevertGroupFaceModelVersionResponse,
   UpgradeGroupFaceModelVersionRequest,
   DetectLiveFaceRequest,
   GetPersonBaseInfoResponse,
-  GetSimilarPersonResultRequest,
   SearchPersonsResponse,
   GetUpgradeGroupFaceModelVersionResultRequest,
   GroupInfo,
@@ -61,7 +58,6 @@ import {
   CopyPersonRequest,
   SearchPersonsReturnsByGroupRequest,
   DeletePersonFromGroupResponse,
-  GetCheckSimilarPersonJobIdListResponse,
   DenseFaceShape,
   ResultsReturnsByGroup,
   Point,
@@ -70,14 +66,12 @@ import {
   VerifyFaceRequest,
   GetPersonListResponse,
   Hair,
-  CheckSimilarPersonResponse,
   Result,
   GetPersonGroupInfoResponse,
   UpgradeGroupFaceModelVersionResponse,
   SearchFacesReturnsByGroupRequest,
   AnalyzeDenseLandmarksResponse,
   ModifyPersonBaseInfoResponse,
-  GetSimilarPersonResultResponse,
   ModifyPersonGroupInfoRequest,
   RevertGroupFaceModelVersionRequest,
   FaceQualityCompleteness,
@@ -86,10 +80,9 @@ import {
   CompareMaskFaceResponse,
   ModifyPersonBaseInfoRequest,
   DetectLiveFaceAccurateRequest,
-  JobIdInfo,
+  VerifyFaceResponse,
   FaceDetailInfo,
   SearchFacesRequest,
-  GetCheckSimilarPersonJobIdListRequest,
   SearchPersonsRequest,
   PersonInfo,
   GroupExDescriptionInfo,
@@ -106,15 +99,13 @@ import {
   GetGroupInfoResponse,
   CompareFaceResponse,
   Mouth,
-  PersonGroupInfo,
-  VerifyFaceResponse,
+  RevertGroupFaceModelVersionResponse,
   DeleteGroupResponse,
   FaceShape,
   CompareFaceRequest,
   VerifyPersonResponse,
   DetectFaceResponse,
   GetPersonListNumRequest,
-  Eyebrow,
   GetGroupInfoRequest,
   UpgradeJobInfo,
   ModifyGroupResponse,
@@ -171,25 +162,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
   }
 
   /**
-   * 获取指定人员的信息，包括加入的人员库、描述内容等。
-   */
-  async GetPersonGroupInfo(
-    req: GetPersonGroupInfoRequest,
-    cb?: (error: string, rep: GetPersonGroupInfoResponse) => void
-  ): Promise<GetPersonGroupInfoResponse> {
-    return this.request("GetPersonGroupInfo", req, cb)
-  }
+     * 用于创建一个空的人员库，如果人员库已存在返回错误。
+可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。
 
-  /**
-     * 获取人员查重任务列表，按任务创建时间逆序（最新的在前面）。
+1个APPID下最多创建10万个人员库（Group）、最多包含5000万张人脸（Face）。
 
-只保留最近1年的数据。
+不同算法模型版本（FaceModelVersion）的人员库（Group）最多可包含人脸（Face）数不同。算法模型版本为2.0的人员库最多包含100万张人脸，算法模型版本为3.0的人员库最多可包含300万张人脸。
      */
-  async GetCheckSimilarPersonJobIdList(
-    req: GetCheckSimilarPersonJobIdListRequest,
-    cb?: (error: string, rep: GetCheckSimilarPersonJobIdListResponse) => void
-  ): Promise<GetCheckSimilarPersonJobIdListResponse> {
-    return this.request("GetCheckSimilarPersonJobIdList", req, cb)
+  async CreateGroup(
+    req: CreateGroupRequest,
+    cb?: (error: string, rep: CreateGroupResponse) => void
+  ): Promise<CreateGroupResponse> {
+    return this.request("CreateGroup", req, cb)
   }
 
   /**
@@ -258,18 +242,13 @@ export class Client extends TencentCloudCommon.AbstractClient {
   }
 
   /**
-     * 用于创建一个空的人员库，如果人员库已存在返回错误。
-可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。
-
-1个APPID下最多创建10万个人员库（Group）、最多包含5000万张人脸（Face）。
-
-不同算法模型版本（FaceModelVersion）的人员库（Group）最多可包含人脸（Face）数不同。算法模型版本为2.0的人员库最多包含100万张人脸，算法模型版本为3.0的人员库最多可包含300万张人脸。
-     */
-  async CreateGroup(
-    req: CreateGroupRequest,
-    cb?: (error: string, rep: CreateGroupResponse) => void
-  ): Promise<CreateGroupResponse> {
-    return this.request("CreateGroup", req, cb)
+   * 获取指定人员的信息，包括加入的人员库、描述内容等。
+   */
+  async GetPersonGroupInfo(
+    req: GetPersonGroupInfoRequest,
+    cb?: (error: string, rep: GetPersonGroupInfoResponse) => void
+  ): Promise<GetPersonGroupInfoResponse> {
+    return this.request("GetPersonGroupInfo", req, cb)
   }
 
   /**
@@ -333,23 +312,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
   }
 
   /**
-     * 对指定的人员库进行人员查重，给出疑似相同人的信息。
-
-可以使用本接口对已有的单个人员库进行人员查重，避免同一人在单个人员库中拥有多个身份；也可以使用本接口对已有的多个人员库进行人员查重，查询同一人是否同时存在多个人员库中。
+     * 给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。 
 
-不支持跨算法模型版本查重，且目前仅支持算法模型为3.0的人员库使用查重功能。
+与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是，人脸验证用于判断 “此人是否是此人”，“此人”的信息已存于人员库中，“此人”可能存在多张人脸图片；而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
 
->     
-- 若对完全相同的指定人员库进行查重操作，需等待上次操作完成才可。即，若两次请求输入的 GroupIds 相同，第一次请求若未完成，第二次请求将返回失败。
+与[人员验证](https://cloud.tencent.com/document/product/867/44982)接口不同的是，人脸验证将该人员（Person）下的每个人脸（Face）都作为单独个体进行验证，而[人员验证](https://cloud.tencent.com/document/product/867/44982)会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个 Person下有4张 Face，人员验证接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员验证（确定待识别的人脸图片是某人员）更加准确。
 
 >     
-- 查重的人员库状态为腾讯云开始进行查重任务的那一刻，即您可以理解为当您发起查重请求后，若您的查重任务需要排队，在排队期间您对人员库的增删操作均会会影响查重的结果。腾讯云将以开始进行查重任务的那一刻人员库的状态进行查重。查重任务开始后，您对人员库的任何操作均不影响查重任务的进行。但建议查重任务开始后，请不要对人员库中人员和人脸进行增删操作。
+- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
      */
-  async CheckSimilarPerson(
-    req: CheckSimilarPersonRequest,
-    cb?: (error: string, rep: CheckSimilarPersonResponse) => void
-  ): Promise<CheckSimilarPersonResponse> {
-    return this.request("CheckSimilarPerson", req, cb)
+  async VerifyFace(
+    req: VerifyFaceRequest,
+    cb?: (error: string, rep: VerifyFaceResponse) => void
+  ): Promise<VerifyFaceResponse> {
+    return this.request("VerifyFace", req, cb)
   }
 
   /**
@@ -397,16 +373,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
     return this.request("UpgradeGroupFaceModelVersion", req, cb)
   }
 
-  /**
-   * 获取人员查重接口（CheckSimilarPerson）结果。
-   */
-  async GetSimilarPersonResult(
-    req: GetSimilarPersonResultRequest,
-    cb?: (error: string, rep: GetSimilarPersonResultResponse) => void
-  ): Promise<GetSimilarPersonResultResponse> {
-    return this.request("GetSimilarPersonResult", req, cb)
-  }
-
   /**
      * 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
 
@@ -435,9 +401,9 @@ export class Client extends TencentCloudCommon.AbstractClient {
   /**
      * 对两张图片中的人脸进行相似度比对，返回人脸相似度分数。
 
-戴口罩人脸比对接口可在人脸戴口罩情况下使用，口罩遮挡程度最高可以遮挡鼻尖。
+防疫场景人脸比对接口可在人脸戴口罩情况下使用，口罩遮挡程度最高可以遮挡鼻尖。
 
-如图片人脸不存在戴口罩情况，建议使用人脸比对服务。
+如图片人脸不存在防疫场景下戴口罩的情况，建议使用人脸比对服务。
      */
   async CompareMaskFace(
     req: CompareMaskFaceRequest,
@@ -583,23 +549,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
     return this.request("ModifyPersonGroupInfo", req, cb)
   }
 
-  /**
-     * 给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。 
-
-与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是，人脸验证用于判断 “此人是否是此人”，“此人”的信息已存于人员库中，“此人”可能存在多张人脸图片；而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
-
-与[人员验证](https://cloud.tencent.com/document/product/867/44982)接口不同的是，人脸验证将该人员（Person）下的每个人脸（Face）都作为单独个体进行验证，而[人员验证](https://cloud.tencent.com/document/product/867/44982)会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个 Person下有4张 Face，人员验证接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员验证（确定待识别的人脸图片是某人员）更加准确。
-
->     
-- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
-     */
-  async VerifyFace(
-    req: VerifyFaceRequest,
-    cb?: (error: string, rep: VerifyFaceResponse) => void
-  ): Promise<VerifyFaceResponse> {
-    return this.request("VerifyFace", req, cb)
-  }
-
   /**
      * 用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照相似度从大到小排列。
 
@@ -664,20 +613,6 @@ export class Client extends TencentCloudCommon.AbstractClient {
     return this.request("GetGroupList", req, cb)
   }
 
-  /**
-     * 获取若要开始一个人员查重任务，这个任务结束的预估时间。
-
-若EndTimestamp符合您预期，请您尽快发起人员查重请求，否则导致可能需要更多处理时间。
-
-若预估时间超过5小时，则无法使用人员查重功能。
-     */
-  async EstimateCheckSimilarPersonCostTime(
-    req: EstimateCheckSimilarPersonCostTimeRequest,
-    cb?: (error: string, rep: EstimateCheckSimilarPersonCostTimeResponse) => void
-  ): Promise<EstimateCheckSimilarPersonCostTimeResponse> {
-    return this.request("EstimateCheckSimilarPersonCostTime", req, cb)
-  }
-
   /**
    * 删除一个人员下的人脸图片。如果该人员只有一张人脸图片，则返回错误。
    */