tencentcloud-sdk-nodejs-iai 4.0.331 → 4.0.334

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -107,6 +107,19 @@ export interface SearchPersonsReturnsByGroupResponse {
107
107
  */
108
108
  RequestId?: string;
109
109
  }
110
+ /**
111
+ * 包含此人员的人员库及描述字段内容列表
112
+ */
113
+ export interface PersonGroupInfo {
114
+ /**
115
+ * 包含此人员的人员库ID
116
+ */
117
+ GroupId: string;
118
+ /**
119
+ * 人员描述字段内容
120
+ */
121
+ PersonExDescriptions: Array<string>;
122
+ }
110
123
  /**
111
124
  * 帽子信息
112
125
  */
@@ -383,20 +396,24 @@ export interface FaceInfo {
383
396
  FaceQualityInfo: FaceQualityInfo;
384
397
  }
385
398
  /**
386
- * CheckSimilarPerson请求参数结构体
399
+ * 眉毛信息
387
400
  */
388
- export interface CheckSimilarPersonRequest {
401
+ export interface Eyebrow {
389
402
  /**
390
- * 待整理的人员库列表。
391
- 人员库总人数不可超过200万,人员库个数不可超过10个。
403
+ * 眉毛浓密。
404
+ AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
392
405
  */
393
- GroupIds: Array<string>;
406
+ EyebrowDensity: AttributeItem;
407
+ /**
408
+ * 眉毛弯曲。
409
+ AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
410
+ */
411
+ EyebrowCurve: AttributeItem;
394
412
  /**
395
- * 人员查重整理力度的控制。
396
- 1:力度较高的人员整理,能够消除更多的重复身份,对应稍高的非重复身份误清除率;
397
- 2:力度较低的人员整理,非重复身份的误清除率较低,对应稍低的重复身份消除率。
413
+ * 眉毛长短。
414
+ AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
398
415
  */
399
- UniquePersonControl: number;
416
+ EyebrowLength: AttributeItem;
400
417
  }
401
418
  /**
402
419
  * AnalyzeDenseLandmarks请求参数结构体
@@ -607,19 +624,6 @@ export interface CopyPersonResponse {
607
624
  */
608
625
  RequestId?: string;
609
626
  }
610
- /**
611
- * EstimateCheckSimilarPersonCostTime返回参数结构体
612
- */
613
- export interface EstimateCheckSimilarPersonCostTimeResponse {
614
- /**
615
- * 人员查重任务预估需要耗费时间。 单位为分钟。
616
- */
617
- EstimatedTimeCost?: number;
618
- /**
619
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
620
- */
621
- RequestId?: string;
622
- }
623
627
  /**
624
628
  * 分组识别结果Item
625
629
  */
@@ -725,25 +729,6 @@ export interface DeleteGroupRequest {
725
729
  */
726
730
  GroupId: string;
727
731
  }
728
- /**
729
- * EstimateCheckSimilarPersonCostTime请求参数结构体
730
- */
731
- export interface EstimateCheckSimilarPersonCostTimeRequest {
732
- /**
733
- * 待整理的人员库列表。
734
- 人员库总人数不可超过200万,人员库个数不可超过10个。
735
- */
736
- GroupIds: Array<string>;
737
- }
738
- /**
739
- * RevertGroupFaceModelVersion返回参数结构体
740
- */
741
- export interface RevertGroupFaceModelVersionResponse {
742
- /**
743
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
744
- */
745
- RequestId?: string;
746
- }
747
732
  /**
748
733
  * UpgradeGroupFaceModelVersion请求参数结构体
749
734
  */
@@ -809,15 +794,6 @@ export interface GetPersonBaseInfoResponse {
809
794
  */
810
795
  RequestId?: string;
811
796
  }
812
- /**
813
- * GetSimilarPersonResult请求参数结构体
814
- */
815
- export interface GetSimilarPersonResultRequest {
816
- /**
817
- * 查重任务ID,用于查询、获取查重的进度和结果。
818
- */
819
- JobId: string;
820
- }
821
797
  /**
822
798
  * SearchPersons返回参数结构体
823
799
  */
@@ -1018,23 +994,6 @@ export interface DeletePersonFromGroupResponse {
1018
994
  */
1019
995
  RequestId?: string;
1020
996
  }
1021
- /**
1022
- * GetCheckSimilarPersonJobIdList返回参数结构体
1023
- */
1024
- export interface GetCheckSimilarPersonJobIdListResponse {
1025
- /**
1026
- * 人员查重任务信息列表。
1027
- */
1028
- JobIdInfos?: Array<JobIdInfo>;
1029
- /**
1030
- * 查重任务总数量。
1031
- */
1032
- JobIdNum?: number;
1033
- /**
1034
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1035
- */
1036
- RequestId?: string;
1037
- }
1038
997
  /**
1039
998
  * 稠密关键点详细信息
1040
999
  */
@@ -1261,15 +1220,6 @@ export interface Hair {
1261
1220
  */
1262
1221
  Color: AttributeItem;
1263
1222
  }
1264
- /**
1265
- * GetPersonListNum请求参数结构体
1266
- */
1267
- export interface GetPersonListNumRequest {
1268
- /**
1269
- * 人员库ID
1270
- */
1271
- GroupId: string;
1272
- }
1273
1223
  /**
1274
1224
  * 人脸的识别结果
1275
1225
  */
@@ -1420,24 +1370,6 @@ export interface ModifyPersonBaseInfoResponse {
1420
1370
  */
1421
1371
  RequestId?: string;
1422
1372
  }
1423
- /**
1424
- * GetSimilarPersonResult返回参数结构体
1425
- */
1426
- export interface GetSimilarPersonResultResponse {
1427
- /**
1428
- * 查重任务完成进度。取值[0.0,100.0]。当且仅当值为100时,SimilarPersons才有意义。
1429
- */
1430
- Progress?: number;
1431
- /**
1432
- * 疑似同一人的人员信息文件临时下载链接, 有效时间为5分钟,结果文件实际保存90天。
1433
- 文件内容由 SimilarPerson 的数组组成。
1434
- */
1435
- SimilarPersonsUrl?: string;
1436
- /**
1437
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1438
- */
1439
- RequestId?: string;
1440
- }
1441
1373
  /**
1442
1374
  * ModifyPersonGroupInfo请求参数结构体
1443
1375
  */
@@ -1622,24 +1554,29 @@ export interface ModifyPersonBaseInfoRequest {
1622
1554
  Gender?: number;
1623
1555
  }
1624
1556
  /**
1625
- * 查重任务信息
1557
+ * VerifyFace返回参数结构体
1626
1558
  */
1627
- export interface JobIdInfo {
1559
+ export interface VerifyFaceResponse {
1560
+ /**
1561
+ * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
1562
+
1563
+ 不同算法版本返回的相似度分数不同。
1564
+ 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
1565
+ 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
1566
+ */
1567
+ Score: number;
1628
1568
  /**
1629
- * 查重任务ID,用于查询、获取查重的进度和结果。
1569
+ * 是否为同一人的判断。
1630
1570
  */
1631
- JobId: string;
1571
+ IsMatch: boolean;
1632
1572
  /**
1633
- * 查重起始时间。
1634
- StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
1635
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
1636
- 有关更多信息,请参阅 Unix 时间。
1637
- */
1638
- StartTime: number;
1573
+ * 人脸识别所用的算法模型版本。
1574
+ */
1575
+ FaceModelVersion: string;
1639
1576
  /**
1640
- * 查重任务是否已完成。0: 成功 1: 未完成 2: 失败
1577
+ * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1641
1578
  */
1642
- JobStatus: number;
1579
+ RequestId?: string;
1643
1580
  }
1644
1581
  /**
1645
1582
  * 人脸信息列表。
@@ -1719,19 +1656,6 @@ export interface SearchFacesRequest {
1719
1656
  */
1720
1657
  NeedRotateDetection?: number;
1721
1658
  }
1722
- /**
1723
- * GetCheckSimilarPersonJobIdList请求参数结构体
1724
- */
1725
- export interface GetCheckSimilarPersonJobIdListRequest {
1726
- /**
1727
- * 起始序号,默认值为0。
1728
- */
1729
- Offset?: number;
1730
- /**
1731
- * 返回数量,默认值为10,最大值为1000。
1732
- */
1733
- Limit?: number;
1734
- }
1735
1659
  /**
1736
1660
  * SearchPersons请求参数结构体
1737
1661
  */
@@ -2110,38 +2034,9 @@ export interface Mouth {
2110
2034
  MouthOpen: AttributeItem;
2111
2035
  }
2112
2036
  /**
2113
- * 包含此人员的人员库及描述字段内容列表
2114
- */
2115
- export interface PersonGroupInfo {
2116
- /**
2117
- * 包含此人员的人员库ID
2118
- */
2119
- GroupId: string;
2120
- /**
2121
- * 人员描述字段内容
2122
- */
2123
- PersonExDescriptions: Array<string>;
2124
- }
2125
- /**
2126
- * VerifyFace返回参数结构体
2037
+ * RevertGroupFaceModelVersion返回参数结构体
2127
2038
  */
2128
- export interface VerifyFaceResponse {
2129
- /**
2130
- * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
2131
-
2132
- 不同算法版本返回的相似度分数不同。
2133
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
2134
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
2135
- */
2136
- Score: number;
2137
- /**
2138
- * 是否为同一人的判断。
2139
- */
2140
- IsMatch: boolean;
2141
- /**
2142
- * 人脸识别所用的算法模型版本。
2143
- */
2144
- FaceModelVersion: string;
2039
+ export interface RevertGroupFaceModelVersionResponse {
2145
2040
  /**
2146
2041
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2147
2042
  */
@@ -2314,37 +2209,13 @@ export interface DetectFaceResponse {
2314
2209
  RequestId?: string;
2315
2210
  }
2316
2211
  /**
2317
- * CheckSimilarPerson返回参数结构体
2212
+ * GetPersonListNum请求参数结构体
2318
2213
  */
2319
- export interface CheckSimilarPersonResponse {
2320
- /**
2321
- * 查重任务ID,用于查询、获取查重的进度和结果。
2322
- */
2323
- JobId: string;
2214
+ export interface GetPersonListNumRequest {
2324
2215
  /**
2325
- * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2216
+ * 人员库ID
2326
2217
  */
2327
- RequestId?: string;
2328
- }
2329
- /**
2330
- * 眉毛信息
2331
- */
2332
- export interface Eyebrow {
2333
- /**
2334
- * 眉毛浓密。
2335
- AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
2336
- */
2337
- EyebrowDensity: AttributeItem;
2338
- /**
2339
- * 眉毛弯曲。
2340
- AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
2341
- */
2342
- EyebrowCurve: AttributeItem;
2343
- /**
2344
- * 眉毛长短。
2345
- AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
2346
- */
2347
- EyebrowLength: AttributeItem;
2218
+ GroupId: string;
2348
2219
  }
2349
2220
  /**
2350
2221
  * GetGroupInfo请求参数结构体
@@ -1,5 +1,5 @@
1
1
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
2
- import { DetectFaceAttributesResponse, SearchPersonsReturnsByGroupResponse, CreatePersonRequest, CreateFaceResponse, CreateFaceRequest, CreateGroupRequest, GetPersonGroupInfoRequest, CheckSimilarPersonRequest, AnalyzeDenseLandmarksRequest, GetGroupListRequest, GetUpgradeGroupFaceModelVersionJobListRequest, GetUpgradeGroupFaceModelVersionResultResponse, DetectLiveFaceAccurateResponse, AnalyzeFaceRequest, CreatePersonResponse, SearchFacesResponse, CopyPersonResponse, EstimateCheckSimilarPersonCostTimeResponse, DeleteFaceResponse, DeletePersonRequest, DetectLiveFaceResponse, DeleteFaceRequest, ModifyGroupRequest, DeleteGroupRequest, EstimateCheckSimilarPersonCostTimeRequest, RevertGroupFaceModelVersionResponse, UpgradeGroupFaceModelVersionRequest, DetectLiveFaceRequest, GetPersonBaseInfoResponse, GetSimilarPersonResultRequest, SearchPersonsResponse, GetUpgradeGroupFaceModelVersionResultRequest, SearchFacesReturnsByGroupResponse, CopyPersonRequest, SearchPersonsReturnsByGroupRequest, DeletePersonFromGroupResponse, GetCheckSimilarPersonJobIdListResponse, GetPersonListNumResponse, DeletePersonFromGroupRequest, VerifyFaceRequest, GetPersonListResponse, CheckSimilarPersonResponse, GetPersonGroupInfoResponse, UpgradeGroupFaceModelVersionResponse, SearchFacesReturnsByGroupRequest, AnalyzeDenseLandmarksResponse, ModifyPersonBaseInfoResponse, GetSimilarPersonResultResponse, ModifyPersonGroupInfoRequest, RevertGroupFaceModelVersionRequest, VerifyPersonRequest, CompareMaskFaceResponse, ModifyPersonBaseInfoRequest, DetectLiveFaceAccurateRequest, SearchFacesRequest, GetCheckSimilarPersonJobIdListRequest, SearchPersonsRequest, CompareMaskFaceRequest, AnalyzeFaceResponse, DetectFaceRequest, GetPersonBaseInfoRequest, DeletePersonResponse, GetUpgradeGroupFaceModelVersionJobListResponse, GetGroupListResponse, DetectFaceAttributesRequest, GetGroupInfoResponse, CompareFaceResponse, VerifyFaceResponse, DeleteGroupResponse, CompareFaceRequest, VerifyPersonResponse, DetectFaceResponse, GetPersonListNumRequest, GetGroupInfoRequest, ModifyGroupResponse, GetPersonListRequest, ModifyPersonGroupInfoResponse, CreateGroupResponse } from "./iai_models";
2
+ import { DetectFaceAttributesResponse, SearchPersonsReturnsByGroupResponse, CreatePersonRequest, CreateFaceResponse, CreateFaceRequest, CreateGroupRequest, GetPersonGroupInfoRequest, AnalyzeDenseLandmarksRequest, GetGroupListRequest, GetUpgradeGroupFaceModelVersionJobListRequest, GetUpgradeGroupFaceModelVersionResultResponse, DetectLiveFaceAccurateResponse, AnalyzeFaceRequest, CreatePersonResponse, SearchFacesResponse, CopyPersonResponse, DeleteFaceResponse, DeletePersonRequest, DetectLiveFaceResponse, DeleteFaceRequest, ModifyGroupRequest, DeleteGroupRequest, UpgradeGroupFaceModelVersionRequest, DetectLiveFaceRequest, GetPersonBaseInfoResponse, SearchPersonsResponse, GetUpgradeGroupFaceModelVersionResultRequest, SearchFacesReturnsByGroupResponse, CopyPersonRequest, SearchPersonsReturnsByGroupRequest, DeletePersonFromGroupResponse, GetPersonListNumResponse, DeletePersonFromGroupRequest, VerifyFaceRequest, GetPersonListResponse, GetPersonGroupInfoResponse, UpgradeGroupFaceModelVersionResponse, SearchFacesReturnsByGroupRequest, AnalyzeDenseLandmarksResponse, ModifyPersonBaseInfoResponse, ModifyPersonGroupInfoRequest, RevertGroupFaceModelVersionRequest, VerifyPersonRequest, CompareMaskFaceResponse, ModifyPersonBaseInfoRequest, DetectLiveFaceAccurateRequest, VerifyFaceResponse, SearchFacesRequest, SearchPersonsRequest, CompareMaskFaceRequest, AnalyzeFaceResponse, DetectFaceRequest, GetPersonBaseInfoRequest, DeletePersonResponse, GetUpgradeGroupFaceModelVersionJobListResponse, GetGroupListResponse, DetectFaceAttributesRequest, GetGroupInfoResponse, CompareFaceResponse, RevertGroupFaceModelVersionResponse, DeleteGroupResponse, CompareFaceRequest, VerifyPersonResponse, DetectFaceResponse, GetPersonListNumRequest, GetGroupInfoRequest, ModifyGroupResponse, GetPersonListRequest, ModifyPersonGroupInfoResponse, CreateGroupResponse } from "./iai_models";
3
3
  /**
4
4
  * iai client
5
5
  * @class
@@ -30,15 +30,14 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
30
30
  */
31
31
  SearchFacesReturnsByGroup(req: SearchFacesReturnsByGroupRequest, cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void): Promise<SearchFacesReturnsByGroupResponse>;
32
32
  /**
33
- * 获取指定人员的信息,包括加入的人员库、描述内容等。
34
- */
35
- GetPersonGroupInfo(req: GetPersonGroupInfoRequest, cb?: (error: string, rep: GetPersonGroupInfoResponse) => void): Promise<GetPersonGroupInfoResponse>;
36
- /**
37
- * 获取人员查重任务列表,按任务创建时间逆序(最新的在前面)。
33
+ * 用于创建一个空的人员库,如果人员库已存在返回错误。
34
+ 可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
38
35
 
39
- 只保留最近1年的数据。
36
+ 1个APPID下最多创建10万个人员库(Group)、最多包含5000万张人脸(Face)。
37
+
38
+ 不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
40
39
  */
41
- GetCheckSimilarPersonJobIdList(req: GetCheckSimilarPersonJobIdListRequest, cb?: (error: string, rep: GetCheckSimilarPersonJobIdListResponse) => void): Promise<GetCheckSimilarPersonJobIdListResponse>;
40
+ CreateGroup(req: CreateGroupRequest, cb?: (error: string, rep: CreateGroupResponse) => void): Promise<CreateGroupResponse>;
42
41
  /**
43
42
  * 获取指定人员的信息,包括姓名、性别、人脸等。
44
43
  */
@@ -75,14 +74,9 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
75
74
  */
76
75
  GetPersonListNum(req: GetPersonListNumRequest, cb?: (error: string, rep: GetPersonListNumResponse) => void): Promise<GetPersonListNumResponse>;
77
76
  /**
78
- * 用于创建一个空的人员库,如果人员库已存在返回错误。
79
- 可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
80
-
81
- 1个APPID下最多创建10万个人员库(Group)、最多包含5000万张人脸(Face)。
82
-
83
- 不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
84
- */
85
- CreateGroup(req: CreateGroupRequest, cb?: (error: string, rep: CreateGroupResponse) => void): Promise<CreateGroupResponse>;
77
+ * 获取指定人员的信息,包括加入的人员库、描述内容等。
78
+ */
79
+ GetPersonGroupInfo(req: GetPersonGroupInfoRequest, cb?: (error: string, rep: GetPersonGroupInfoResponse) => void): Promise<GetPersonGroupInfoResponse>;
86
80
  /**
87
81
  * 对请求图片进行五官定位(也称人脸关键点定位),计算构成人脸轮廓的 90 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子(13 点)、嘴巴(22 点)、脸型轮廓(21 点)、眼珠[或瞳孔](2点)。
88
82
 
@@ -120,19 +114,16 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
120
114
  */
121
115
  CopyPerson(req: CopyPersonRequest, cb?: (error: string, rep: CopyPersonResponse) => void): Promise<CopyPersonResponse>;
122
116
  /**
123
- * 对指定的人员库进行人员查重,给出疑似相同人的信息。
124
-
125
- 可以使用本接口对已有的单个人员库进行人员查重,避免同一人在单个人员库中拥有多个身份;也可以使用本接口对已有的多个人员库进行人员查重,查询同一人是否同时存在多个人员库中。
117
+ * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
126
118
 
127
- 不支持跨算法模型版本查重,且目前仅支持算法模型为3.0的人员库使用查重功能。
119
+ 与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
128
120
 
129
- >
130
- - 若对完全相同的指定人员库进行查重操作,需等待上次操作完成才可。即,若两次请求输入的 GroupIds 相同,第一次请求若未完成,第二次请求将返回失败。
121
+ 与[人员验证](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 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
131
122
 
132
123
  >
133
- - 查重的人员库状态为腾讯云开始进行查重任务的那一刻,即您可以理解为当您发起查重请求后,若您的查重任务需要排队,在排队期间您对人员库的增删操作均会会影响查重的结果。腾讯云将以开始进行查重任务的那一刻人员库的状态进行查重。查重任务开始后,您对人员库的任何操作均不影响查重任务的进行。但建议查重任务开始后,请不要对人员库中人员和人脸进行增删操作。
124
+ - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
134
125
  */
135
- CheckSimilarPerson(req: CheckSimilarPersonRequest, cb?: (error: string, rep: CheckSimilarPersonResponse) => void): Promise<CheckSimilarPersonResponse>;
126
+ VerifyFace(req: VerifyFaceRequest, cb?: (error: string, rep: VerifyFaceResponse) => void): Promise<VerifyFaceResponse>;
136
127
  /**
137
128
  * 对请求图片进行五官定位(也称人脸关键点定位),获得人脸的精准信息,返回多达888点关键信息,对五官和脸部轮廓进行精确定位。
138
129
  */
@@ -154,10 +145,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
154
145
  注:某些接口无法进行跨人员库版本操作,例如SearchFaces,SearchPersons和CopyPerson等。当业务有多个Group操作的场景时,如同时搜索Group1和Group2,如果升级了Group1,此时Group1和Group2版本不同,造成了跨版本操作,将导致Search接口无法正常执行,返回不允许执行跨版本操作错误,升级前需考虑业务是否有多库操作的场景,否则会影响线上接口表现。
155
146
  */
156
147
  UpgradeGroupFaceModelVersion(req: UpgradeGroupFaceModelVersionRequest, cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void): Promise<UpgradeGroupFaceModelVersionResponse>;
157
- /**
158
- * 获取人员查重接口(CheckSimilarPerson)结果。
159
- */
160
- GetSimilarPersonResult(req: GetSimilarPersonResultRequest, cb?: (error: string, rep: GetSimilarPersonResultResponse) => void): Promise<GetSimilarPersonResultResponse>;
161
148
  /**
162
149
  * 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
163
150
 
@@ -174,9 +161,9 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
174
161
  /**
175
162
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
176
163
 
177
- 戴口罩人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
164
+ 防疫场景人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
178
165
 
179
- 如图片人脸不存在戴口罩情况,建议使用人脸比对服务。
166
+ 如图片人脸不存在防疫场景下戴口罩的情况,建议使用人脸比对服务。
180
167
  */
181
168
  CompareMaskFace(req: CompareMaskFaceRequest, cb?: (error: string, rep: CompareMaskFaceResponse) => void): Promise<CompareMaskFaceResponse>;
182
169
  /**
@@ -262,17 +249,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
262
249
  * 修改指定人员库人员描述内容。
263
250
  */
264
251
  ModifyPersonGroupInfo(req: ModifyPersonGroupInfoRequest, cb?: (error: string, rep: ModifyPersonGroupInfoResponse) => void): Promise<ModifyPersonGroupInfoResponse>;
265
- /**
266
- * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
267
-
268
- 与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
269
-
270
- 与[人员验证](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 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
271
-
272
- >
273
- - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
274
- */
275
- VerifyFace(req: VerifyFaceRequest, cb?: (error: string, rep: VerifyFaceResponse) => void): Promise<VerifyFaceResponse>;
276
252
  /**
277
253
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照相似度从大到小排列。
278
254
 
@@ -313,14 +289,6 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
313
289
  * 获取人员库列表。
314
290
  */
315
291
  GetGroupList(req: GetGroupListRequest, cb?: (error: string, rep: GetGroupListResponse) => void): Promise<GetGroupListResponse>;
316
- /**
317
- * 获取若要开始一个人员查重任务,这个任务结束的预估时间。
318
-
319
- 若EndTimestamp符合您预期,请您尽快发起人员查重请求,否则导致可能需要更多处理时间。
320
-
321
- 若预估时间超过5小时,则无法使用人员查重功能。
322
- */
323
- EstimateCheckSimilarPersonCostTime(req: EstimateCheckSimilarPersonCostTimeRequest, cb?: (error: string, rep: EstimateCheckSimilarPersonCostTimeResponse) => void): Promise<EstimateCheckSimilarPersonCostTimeResponse>;
324
292
  /**
325
293
  * 删除一个人员下的人脸图片。如果该人员只有一张人脸图片,则返回错误。
326
294
  */
@@ -55,18 +55,15 @@ class Client extends TencentCloudCommon.AbstractClient {
55
55
  return this.request("SearchFacesReturnsByGroup", req, cb);
56
56
  }
57
57
  /**
58
- * 获取指定人员的信息,包括加入的人员库、描述内容等。
59
- */
60
- async GetPersonGroupInfo(req, cb) {
61
- return this.request("GetPersonGroupInfo", req, cb);
62
- }
63
- /**
64
- * 获取人员查重任务列表,按任务创建时间逆序(最新的在前面)。
58
+ * 用于创建一个空的人员库,如果人员库已存在返回错误。
59
+ 可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
60
+
61
+ 1个APPID下最多创建10万个人员库(Group)、最多包含5000万张人脸(Face)。
65
62
 
66
- 只保留最近1年的数据。
63
+ 不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
67
64
  */
68
- async GetCheckSimilarPersonJobIdList(req, cb) {
69
- return this.request("GetCheckSimilarPersonJobIdList", req, cb);
65
+ async CreateGroup(req, cb) {
66
+ return this.request("CreateGroup", req, cb);
70
67
  }
71
68
  /**
72
69
  * 获取指定人员的信息,包括姓名、性别、人脸等。
@@ -114,15 +111,10 @@ class Client extends TencentCloudCommon.AbstractClient {
114
111
  return this.request("GetPersonListNum", req, cb);
115
112
  }
116
113
  /**
117
- * 用于创建一个空的人员库,如果人员库已存在返回错误。
118
- 可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
119
-
120
- 1个APPID下最多创建10万个人员库(Group)、最多包含5000万张人脸(Face)。
121
-
122
- 不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
123
- */
124
- async CreateGroup(req, cb) {
125
- return this.request("CreateGroup", req, cb);
114
+ * 获取指定人员的信息,包括加入的人员库、描述内容等。
115
+ */
116
+ async GetPersonGroupInfo(req, cb) {
117
+ return this.request("GetPersonGroupInfo", req, cb);
126
118
  }
127
119
  /**
128
120
  * 对请求图片进行五官定位(也称人脸关键点定位),计算构成人脸轮廓的 90 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子(13 点)、嘴巴(22 点)、脸型轮廓(21 点)、眼珠[或瞳孔](2点)。
@@ -169,20 +161,17 @@ class Client extends TencentCloudCommon.AbstractClient {
169
161
  return this.request("CopyPerson", req, cb);
170
162
  }
171
163
  /**
172
- * 对指定的人员库进行人员查重,给出疑似相同人的信息。
173
-
174
- 可以使用本接口对已有的单个人员库进行人员查重,避免同一人在单个人员库中拥有多个身份;也可以使用本接口对已有的多个人员库进行人员查重,查询同一人是否同时存在多个人员库中。
164
+ * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
175
165
 
176
- 不支持跨算法模型版本查重,且目前仅支持算法模型为3.0的人员库使用查重功能。
166
+ 与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
177
167
 
178
- >
179
- - 若对完全相同的指定人员库进行查重操作,需等待上次操作完成才可。即,若两次请求输入的 GroupIds 相同,第一次请求若未完成,第二次请求将返回失败。
168
+ 与[人员验证](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 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
180
169
 
181
170
  >
182
- - 查重的人员库状态为腾讯云开始进行查重任务的那一刻,即您可以理解为当您发起查重请求后,若您的查重任务需要排队,在排队期间您对人员库的增删操作均会会影响查重的结果。腾讯云将以开始进行查重任务的那一刻人员库的状态进行查重。查重任务开始后,您对人员库的任何操作均不影响查重任务的进行。但建议查重任务开始后,请不要对人员库中人员和人脸进行增删操作。
171
+ - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
183
172
  */
184
- async CheckSimilarPerson(req, cb) {
185
- return this.request("CheckSimilarPerson", req, cb);
173
+ async VerifyFace(req, cb) {
174
+ return this.request("VerifyFace", req, cb);
186
175
  }
187
176
  /**
188
177
  * 对请求图片进行五官定位(也称人脸关键点定位),获得人脸的精准信息,返回多达888点关键信息,对五官和脸部轮廓进行精确定位。
@@ -213,12 +202,6 @@ class Client extends TencentCloudCommon.AbstractClient {
213
202
  async UpgradeGroupFaceModelVersion(req, cb) {
214
203
  return this.request("UpgradeGroupFaceModelVersion", req, cb);
215
204
  }
216
- /**
217
- * 获取人员查重接口(CheckSimilarPerson)结果。
218
- */
219
- async GetSimilarPersonResult(req, cb) {
220
- return this.request("GetSimilarPersonResult", req, cb);
221
- }
222
205
  /**
223
206
  * 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
224
207
 
@@ -239,9 +222,9 @@ class Client extends TencentCloudCommon.AbstractClient {
239
222
  /**
240
223
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
241
224
 
242
- 戴口罩人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
225
+ 防疫场景人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
243
226
 
244
- 如图片人脸不存在戴口罩情况,建议使用人脸比对服务。
227
+ 如图片人脸不存在防疫场景下戴口罩的情况,建议使用人脸比对服务。
245
228
  */
246
229
  async CompareMaskFace(req, cb) {
247
230
  return this.request("CompareMaskFace", req, cb);
@@ -347,19 +330,6 @@ class Client extends TencentCloudCommon.AbstractClient {
347
330
  async ModifyPersonGroupInfo(req, cb) {
348
331
  return this.request("ModifyPersonGroupInfo", req, cb);
349
332
  }
350
- /**
351
- * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
352
-
353
- 与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
354
-
355
- 与[人员验证](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 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
356
-
357
- >
358
- - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
359
- */
360
- async VerifyFace(req, cb) {
361
- return this.request("VerifyFace", req, cb);
362
- }
363
333
  /**
364
334
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照相似度从大到小排列。
365
335
 
@@ -408,16 +378,6 @@ class Client extends TencentCloudCommon.AbstractClient {
408
378
  async GetGroupList(req, cb) {
409
379
  return this.request("GetGroupList", req, cb);
410
380
  }
411
- /**
412
- * 获取若要开始一个人员查重任务,这个任务结束的预估时间。
413
-
414
- 若EndTimestamp符合您预期,请您尽快发起人员查重请求,否则导致可能需要更多处理时间。
415
-
416
- 若预估时间超过5小时,则无法使用人员查重功能。
417
- */
418
- async EstimateCheckSimilarPersonCostTime(req, cb) {
419
- return this.request("EstimateCheckSimilarPersonCostTime", req, cb);
420
- }
421
381
  /**
422
382
  * 删除一个人员下的人脸图片。如果该人员只有一张人脸图片,则返回错误。
423
383
  */