tencentcloud-sdk-nodejs-iai 4.0.388 → 4.0.431

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.
@@ -17,104 +17,105 @@
17
17
  */
18
18
  import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common"
19
19
  import {
20
- Eye,
21
- Candidate,
22
- DetectFaceAttributesResponse,
23
- SearchPersonsReturnsByGroupResponse,
24
- PersonGroupInfo,
25
- Hat,
26
- CreatePersonRequest,
27
- CreateFaceResponse,
28
- FaceHairAttributesInfo,
29
- CreateFaceRequest,
30
- CreateGroupRequest,
31
- GetPersonGroupInfoRequest,
32
- FaceInfo,
33
- Eyebrow,
34
- AnalyzeDenseLandmarksRequest,
35
- GetGroupListRequest,
36
- GetUpgradeGroupFaceModelVersionJobListRequest,
37
- GetUpgradeGroupFaceModelVersionResultResponse,
38
- DetectLiveFaceAccurateResponse,
39
- AnalyzeFaceRequest,
40
- CreatePersonResponse,
41
- SearchFacesResponse,
42
- CopyPersonResponse,
43
- GroupCandidate,
44
- DeleteFaceResponse,
45
- DeletePersonRequest,
46
- DetectLiveFaceResponse,
47
- DeleteFaceRequest,
48
- ModifyGroupRequest,
49
- DeleteGroupRequest,
50
- UpgradeGroupFaceModelVersionRequest,
51
- DetectLiveFaceRequest,
52
- GetPersonBaseInfoResponse,
53
- SearchPersonsResponse,
54
- GetUpgradeGroupFaceModelVersionResultRequest,
55
- GroupInfo,
56
- FaceQualityInfo,
57
- SearchFacesReturnsByGroupResponse,
58
- CopyPersonRequest,
59
- SearchPersonsReturnsByGroupRequest,
60
- DeletePersonFromGroupResponse,
61
- DenseFaceShape,
62
- ResultsReturnsByGroup,
63
- Point,
64
- GetPersonListNumResponse,
65
- DeletePersonFromGroupRequest,
66
- VerifyFaceRequest,
67
- GetPersonListResponse,
68
- Hair,
69
- Result,
70
- GetPersonGroupInfoResponse,
71
- UpgradeGroupFaceModelVersionResponse,
72
- SearchFacesReturnsByGroupRequest,
73
- AnalyzeDenseLandmarksResponse,
74
- ModifyPersonBaseInfoResponse,
75
- ModifyPersonGroupInfoRequest,
76
- RevertGroupFaceModelVersionRequest,
77
- FaceQualityCompleteness,
78
- FaceAttributesInfo,
79
- VerifyPersonRequest,
80
- CompareMaskFaceResponse,
81
- ModifyPersonBaseInfoRequest,
82
- DetectLiveFaceAccurateRequest,
83
- VerifyFaceResponse,
84
- FaceDetailInfo,
85
- SearchFacesRequest,
86
- SearchPersonsRequest,
87
- PersonInfo,
88
- GroupExDescriptionInfo,
89
- CompareMaskFaceRequest,
90
- AnalyzeFaceResponse,
91
- DetectFaceRequest,
92
- GetPersonBaseInfoRequest,
93
- DeletePersonResponse,
94
- PersonExDescriptionInfo,
95
- GetUpgradeGroupFaceModelVersionJobListResponse,
96
- HeadPose,
97
- GetGroupListResponse,
98
- DetectFaceAttributesRequest,
99
- GetGroupInfoResponse,
100
- CompareFaceResponse,
101
- Mouth,
102
- RevertGroupFaceModelVersionResponse,
103
- DeleteGroupResponse,
104
- FaceShape,
105
- CompareFaceRequest,
106
- VerifyPersonResponse,
107
- DetectFaceResponse,
108
- GetPersonListNumRequest,
109
- GetGroupInfoRequest,
110
- UpgradeJobInfo,
111
- ModifyGroupResponse,
112
- GetPersonListRequest,
113
- FaceDetailAttributesInfo,
114
- AttributeItem,
115
- FaceRect,
116
- ModifyPersonGroupInfoResponse,
117
- CreateGroupResponse,
20
+ Eye,
21
+ Candidate,
22
+ DetectFaceAttributesResponse,
23
+ SearchPersonsReturnsByGroupResponse,
24
+ PersonGroupInfo,
25
+ Hat,
26
+ CreatePersonRequest,
27
+ CreateFaceResponse,
28
+ FaceHairAttributesInfo,
29
+ CreateFaceRequest,
30
+ CreateGroupRequest,
31
+ GetPersonGroupInfoRequest,
32
+ FaceInfo,
33
+ Eyebrow,
34
+ AnalyzeDenseLandmarksRequest,
35
+ GetGroupListRequest,
36
+ GetUpgradeGroupFaceModelVersionJobListRequest,
37
+ GetUpgradeGroupFaceModelVersionResultResponse,
38
+ DetectLiveFaceAccurateResponse,
39
+ AnalyzeFaceRequest,
40
+ CreatePersonResponse,
41
+ SearchFacesResponse,
42
+ CopyPersonResponse,
43
+ GroupCandidate,
44
+ DeleteFaceResponse,
45
+ DeletePersonRequest,
46
+ DetectLiveFaceResponse,
47
+ DeleteFaceRequest,
48
+ ModifyGroupRequest,
49
+ DeleteGroupRequest,
50
+ UpgradeGroupFaceModelVersionRequest,
51
+ DetectLiveFaceRequest,
52
+ GetPersonBaseInfoResponse,
53
+ SearchPersonsResponse,
54
+ GetUpgradeGroupFaceModelVersionResultRequest,
55
+ GroupInfo,
56
+ FaceQualityInfo,
57
+ SearchFacesReturnsByGroupResponse,
58
+ CopyPersonRequest,
59
+ SearchPersonsReturnsByGroupRequest,
60
+ DeletePersonFromGroupResponse,
61
+ DenseFaceShape,
62
+ ResultsReturnsByGroup,
63
+ Point,
64
+ GetPersonListNumResponse,
65
+ DeletePersonFromGroupRequest,
66
+ VerifyFaceRequest,
67
+ GetPersonListResponse,
68
+ Hair,
69
+ Result,
70
+ GetPersonGroupInfoResponse,
71
+ UpgradeGroupFaceModelVersionResponse,
72
+ SearchFacesReturnsByGroupRequest,
73
+ AnalyzeDenseLandmarksResponse,
74
+ ModifyPersonBaseInfoResponse,
75
+ ModifyPersonGroupInfoRequest,
76
+ RevertGroupFaceModelVersionRequest,
77
+ FaceQualityCompleteness,
78
+ FaceAttributesInfo,
79
+ VerifyPersonRequest,
80
+ CompareMaskFaceResponse,
81
+ ModifyPersonBaseInfoRequest,
82
+ DetectLiveFaceAccurateRequest,
83
+ VerifyFaceResponse,
84
+ FaceDetailInfo,
85
+ SearchFacesRequest,
86
+ SearchPersonsRequest,
87
+ PersonInfo,
88
+ GroupExDescriptionInfo,
89
+ CompareMaskFaceRequest,
90
+ AnalyzeFaceResponse,
91
+ DetectFaceRequest,
92
+ GetPersonBaseInfoRequest,
93
+ DeletePersonResponse,
94
+ PersonExDescriptionInfo,
95
+ GetUpgradeGroupFaceModelVersionJobListResponse,
96
+ HeadPose,
97
+ GetGroupListResponse,
98
+ DetectFaceAttributesRequest,
99
+ GetGroupInfoResponse,
100
+ CompareFaceResponse,
101
+ Mouth,
102
+ RevertGroupFaceModelVersionResponse,
103
+ DeleteGroupResponse,
104
+ FaceShape,
105
+ CompareFaceRequest,
106
+ VerifyPersonResponse,
107
+ DetectFaceResponse,
108
+ GetPersonListNumRequest,
109
+ GetGroupInfoRequest,
110
+ UpgradeJobInfo,
111
+ ModifyGroupResponse,
112
+ GetPersonListRequest,
113
+ FaceDetailAttributesInfo,
114
+ AttributeItem,
115
+ FaceRect,
116
+ ModifyPersonGroupInfoResponse,
117
+ CreateGroupResponse,
118
+
118
119
  } from "./iai_models"
119
120
 
120
121
  /**
@@ -122,21 +123,19 @@ import {
122
123
  * @class
123
124
  */
124
125
  export class Client extends TencentCloudCommon.AbstractClient {
125
- constructor(clientConfig: TencentCloudCommon.ClientConfig) {
126
- super("iai.tencentcloudapi.com", "2020-03-03", clientConfig)
127
- }
128
-
129
- /**
130
- * 从某人员库中删除人员,此操作仅影响该人员库。若该人员仅存在于指定的人员库中,该人员将被删除,其所有的人脸信息也将被删除。
131
- */
132
- async DeletePersonFromGroup(
133
- req: DeletePersonFromGroupRequest,
134
- cb?: (error: string, rep: DeletePersonFromGroupResponse) => void
135
- ): Promise<DeletePersonFromGroupResponse> {
136
- return this.request("DeletePersonFromGroup", req, cb)
137
- }
138
-
139
- /**
126
+
127
+ constructor(clientConfig: TencentCloudCommon.ClientConfig) {
128
+ super("iai.tencentcloudapi.com", "2020-03-03", clientConfig);
129
+ }
130
+
131
+ /**
132
+ * 从某人员库中删除人员,此操作仅影响该人员库。若该人员仅存在于指定的人员库中,该人员将被删除,其所有的人脸信息也将被删除。
133
+ */
134
+ async DeletePersonFromGroup(req: DeletePersonFromGroupRequest, cb?: (error: string, rep: DeletePersonFromGroupResponse) => void): Promise<DeletePersonFromGroupResponse> {
135
+ return this.request("DeletePersonFromGroup", req, cb);
136
+ }
137
+
138
+ /**
140
139
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
141
140
 
142
141
  支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
@@ -154,14 +153,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
154
153
  - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
155
154
 
156
155
  */
157
- async SearchFacesReturnsByGroup(
158
- req: SearchFacesReturnsByGroupRequest,
159
- cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void
160
- ): Promise<SearchFacesReturnsByGroupResponse> {
161
- return this.request("SearchFacesReturnsByGroup", req, cb)
162
- }
156
+ async SearchFacesReturnsByGroup(req: SearchFacesReturnsByGroupRequest, cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void): Promise<SearchFacesReturnsByGroupResponse> {
157
+ return this.request("SearchFacesReturnsByGroup", req, cb);
158
+ }
163
159
 
164
- /**
160
+ /**
165
161
  * 用于创建一个空的人员库,如果人员库已存在返回错误。
166
162
  可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
167
163
 
@@ -169,24 +165,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
169
165
 
170
166
  不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
171
167
  */
172
- async CreateGroup(
173
- req: CreateGroupRequest,
174
- cb?: (error: string, rep: CreateGroupResponse) => void
175
- ): Promise<CreateGroupResponse> {
176
- return this.request("CreateGroup", req, cb)
177
- }
178
-
179
- /**
180
- * 获取指定人员的信息,包括姓名、性别、人脸等。
181
- */
182
- async GetPersonBaseInfo(
183
- req: GetPersonBaseInfoRequest,
184
- cb?: (error: string, rep: GetPersonBaseInfoResponse) => void
185
- ): Promise<GetPersonBaseInfoResponse> {
186
- return this.request("GetPersonBaseInfo", req, cb)
187
- }
188
-
189
- /**
168
+ async CreateGroup(req: CreateGroupRequest, cb?: (error: string, rep: CreateGroupResponse) => void): Promise<CreateGroupResponse> {
169
+ return this.request("CreateGroup", req, cb);
170
+ }
171
+
172
+ /**
173
+ * 获取指定人员的信息,包括姓名、性别、人脸等。
174
+ */
175
+ async GetPersonBaseInfo(req: GetPersonBaseInfoRequest, cb?: (error: string, rep: GetPersonBaseInfoResponse) => void): Promise<GetPersonBaseInfoResponse> {
176
+ return this.request("GetPersonBaseInfo", req, cb);
177
+ }
178
+
179
+ /**
190
180
  * 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是:静态活体检测中,用户不需要通过唇语或摇头眨眼等动作来识别。
191
181
 
192
182
  静态活体检测适用于手机自拍的场景,或对防攻击要求不高的场景。如果对活体检测有更高安全性要求,请使用[人脸核身·云智慧眼](https://cloud.tencent.com/product/faceid)产品。
@@ -200,81 +190,60 @@ export class Client extends TencentCloudCommon.AbstractClient {
200
190
  >
201
191
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
202
192
  */
203
- async DetectLiveFace(
204
- req: DetectLiveFaceRequest,
205
- cb?: (error: string, rep: DetectLiveFaceResponse) => void
206
- ): Promise<DetectLiveFaceResponse> {
207
- return this.request("DetectLiveFace", req, cb)
208
- }
193
+ async DetectLiveFace(req: DetectLiveFaceRequest, cb?: (error: string, rep: DetectLiveFaceResponse) => void): Promise<DetectLiveFaceResponse> {
194
+ return this.request("DetectLiveFace", req, cb);
195
+ }
209
196
 
210
- /**
197
+ /**
211
198
  * 将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中,所有人员库中该人员图片均会增加。
212
199
 
213
200
  >
214
201
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
215
202
  */
216
- async CreateFace(
217
- req: CreateFaceRequest,
218
- cb?: (error: string, rep: CreateFaceResponse) => void
219
- ): Promise<CreateFaceResponse> {
220
- return this.request("CreateFace", req, cb)
221
- }
203
+ async CreateFace(req: CreateFaceRequest, cb?: (error: string, rep: CreateFaceResponse) => void): Promise<CreateFaceResponse> {
204
+ return this.request("CreateFace", req, cb);
205
+ }
222
206
 
223
- /**
207
+ /**
224
208
  * 删除该人员库及包含的所有的人员。同时,人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中,该人员不会被删除,但属于该人员库中的自定义描述字段信息会被删除,属于其他人员库的自定义描述字段信息不受影响。
225
209
 
226
210
  */
227
- async DeleteGroup(
228
- req: DeleteGroupRequest,
229
- cb?: (error: string, rep: DeleteGroupResponse) => void
230
- ): Promise<DeleteGroupResponse> {
231
- return this.request("DeleteGroup", req, cb)
232
- }
233
-
234
- /**
235
- * 获取指定人员库中人员数量。
236
- */
237
- async GetPersonListNum(
238
- req: GetPersonListNumRequest,
239
- cb?: (error: string, rep: GetPersonListNumResponse) => void
240
- ): Promise<GetPersonListNumResponse> {
241
- return this.request("GetPersonListNum", req, cb)
242
- }
243
-
244
- /**
245
- * 获取指定人员的信息,包括加入的人员库、描述内容等。
246
- */
247
- async GetPersonGroupInfo(
248
- req: GetPersonGroupInfoRequest,
249
- cb?: (error: string, rep: GetPersonGroupInfoResponse) => void
250
- ): Promise<GetPersonGroupInfoResponse> {
251
- return this.request("GetPersonGroupInfo", req, cb)
252
- }
253
-
254
- /**
211
+ async DeleteGroup(req: DeleteGroupRequest, cb?: (error: string, rep: DeleteGroupResponse) => void): Promise<DeleteGroupResponse> {
212
+ return this.request("DeleteGroup", req, cb);
213
+ }
214
+
215
+ /**
216
+ * 获取指定人员库中人员数量。
217
+ */
218
+ async GetPersonListNum(req: GetPersonListNumRequest, cb?: (error: string, rep: GetPersonListNumResponse) => void): Promise<GetPersonListNumResponse> {
219
+ return this.request("GetPersonListNum", req, cb);
220
+ }
221
+
222
+ /**
223
+ * 获取指定人员的信息,包括加入的人员库、描述内容等。
224
+ */
225
+ async GetPersonGroupInfo(req: GetPersonGroupInfoRequest, cb?: (error: string, rep: GetPersonGroupInfoResponse) => void): Promise<GetPersonGroupInfoResponse> {
226
+ return this.request("GetPersonGroupInfo", req, cb);
227
+ }
228
+
229
+ /**
255
230
  * 对请求图片进行五官定位(也称人脸关键点定位),计算构成人脸轮廓的 90 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子(13 点)、嘴巴(22 点)、脸型轮廓(21 点)、眼珠[或瞳孔](2点)。
256
231
 
257
232
  >
258
233
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
259
234
  */
260
- async AnalyzeFace(
261
- req: AnalyzeFaceRequest,
262
- cb?: (error: string, rep: AnalyzeFaceResponse) => void
263
- ): Promise<AnalyzeFaceResponse> {
264
- return this.request("AnalyzeFace", req, cb)
265
- }
266
-
267
- /**
268
- * 修改人员信息,包括名称、性别等。人员名称和性别修改会同步到包含该人员的所有人员库。
269
- */
270
- async ModifyPersonBaseInfo(
271
- req: ModifyPersonBaseInfoRequest,
272
- cb?: (error: string, rep: ModifyPersonBaseInfoResponse) => void
273
- ): Promise<ModifyPersonBaseInfoResponse> {
274
- return this.request("ModifyPersonBaseInfo", req, cb)
275
- }
276
-
277
- /**
235
+ async AnalyzeFace(req: AnalyzeFaceRequest, cb?: (error: string, rep: AnalyzeFaceResponse) => void): Promise<AnalyzeFaceResponse> {
236
+ return this.request("AnalyzeFace", req, cb);
237
+ }
238
+
239
+ /**
240
+ * 修改人员信息,包括名称、性别等。人员名称和性别修改会同步到包含该人员的所有人员库。
241
+ */
242
+ async ModifyPersonBaseInfo(req: ModifyPersonBaseInfoRequest, cb?: (error: string, rep: ModifyPersonBaseInfoResponse) => void): Promise<ModifyPersonBaseInfoResponse> {
243
+ return this.request("ModifyPersonBaseInfo", req, cb);
244
+ }
245
+
246
+ /**
278
247
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,识别结果按照相似度从大到小排序。
279
248
 
280
249
  支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
@@ -292,26 +261,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
292
261
  >
293
262
  - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
294
263
  */
295
- async SearchFaces(
296
- req: SearchFacesRequest,
297
- cb?: (error: string, rep: SearchFacesResponse) => void
298
- ): Promise<SearchFacesResponse> {
299
- return this.request("SearchFaces", req, cb)
300
- }
264
+ async SearchFaces(req: SearchFacesRequest, cb?: (error: string, rep: SearchFacesResponse) => void): Promise<SearchFacesResponse> {
265
+ return this.request("SearchFaces", req, cb);
266
+ }
301
267
 
302
- /**
268
+ /**
303
269
  * 将已存在于某人员库的人员复制到其他人员库,该人员的描述信息不会被复制。单个人员最多只能同时存在100个人员库中。
304
270
  >
305
271
  - 注:若该人员创建时算法模型版本为2.0,复制到非2.0算法模型版本的Group中时,复制操作将会失败。
306
272
  */
307
- async CopyPerson(
308
- req: CopyPersonRequest,
309
- cb?: (error: string, rep: CopyPersonResponse) => void
310
- ): Promise<CopyPersonResponse> {
311
- return this.request("CopyPerson", req, cb)
312
- }
273
+ async CopyPerson(req: CopyPersonRequest, cb?: (error: string, rep: CopyPersonResponse) => void): Promise<CopyPersonResponse> {
274
+ return this.request("CopyPerson", req, cb);
275
+ }
313
276
 
314
- /**
277
+ /**
315
278
  * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
316
279
 
317
280
  与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
@@ -321,44 +284,32 @@ export class Client extends TencentCloudCommon.AbstractClient {
321
284
  >
322
285
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
323
286
  */
324
- async VerifyFace(
325
- req: VerifyFaceRequest,
326
- cb?: (error: string, rep: VerifyFaceResponse) => void
327
- ): Promise<VerifyFaceResponse> {
328
- return this.request("VerifyFace", req, cb)
329
- }
330
-
331
- /**
332
- * 对请求图片进行五官定位(也称人脸关键点定位),获得人脸的精准信息,返回多达888点关键信息,对五官和脸部轮廓进行精确定位。
333
- */
334
- async AnalyzeDenseLandmarks(
335
- req: AnalyzeDenseLandmarksRequest,
336
- cb?: (error: string, rep: AnalyzeDenseLandmarksResponse) => void
337
- ): Promise<AnalyzeDenseLandmarksResponse> {
338
- return this.request("AnalyzeDenseLandmarks", req, cb)
339
- }
340
-
341
- /**
342
- * 删除该人员信息,此操作会导致所有人员库均删除此人员。同时,该人员的所有人脸信息将被删除。
343
- */
344
- async DeletePerson(
345
- req: DeletePersonRequest,
346
- cb?: (error: string, rep: DeletePersonResponse) => void
347
- ): Promise<DeletePersonResponse> {
348
- return this.request("DeletePerson", req, cb)
349
- }
350
-
351
- /**
352
- * 修改人员库名称、备注、自定义描述字段名称。
353
- */
354
- async ModifyGroup(
355
- req: ModifyGroupRequest,
356
- cb?: (error: string, rep: ModifyGroupResponse) => void
357
- ): Promise<ModifyGroupResponse> {
358
- return this.request("ModifyGroup", req, cb)
359
- }
360
-
361
- /**
287
+ async VerifyFace(req: VerifyFaceRequest, cb?: (error: string, rep: VerifyFaceResponse) => void): Promise<VerifyFaceResponse> {
288
+ return this.request("VerifyFace", req, cb);
289
+ }
290
+
291
+ /**
292
+ * 对请求图片进行五官定位(也称人脸关键点定位),获得人脸的精准信息,返回多达888点关键信息,对五官和脸部轮廓进行精确定位。
293
+ */
294
+ async AnalyzeDenseLandmarks(req: AnalyzeDenseLandmarksRequest, cb?: (error: string, rep: AnalyzeDenseLandmarksResponse) => void): Promise<AnalyzeDenseLandmarksResponse> {
295
+ return this.request("AnalyzeDenseLandmarks", req, cb);
296
+ }
297
+
298
+ /**
299
+ * 删除该人员信息,此操作会导致所有人员库均删除此人员。同时,该人员的所有人脸信息将被删除。
300
+ */
301
+ async DeletePerson(req: DeletePersonRequest, cb?: (error: string, rep: DeletePersonResponse) => void): Promise<DeletePersonResponse> {
302
+ return this.request("DeletePerson", req, cb);
303
+ }
304
+
305
+ /**
306
+ * 修改人员库名称、备注、自定义描述字段名称。
307
+ */
308
+ async ModifyGroup(req: ModifyGroupRequest, cb?: (error: string, rep: ModifyGroupResponse) => void): Promise<ModifyGroupResponse> {
309
+ return this.request("ModifyGroup", req, cb);
310
+ }
311
+
312
+ /**
362
313
  * 升级人员库。升级过程中,人员库仍然为原算法版本,人员库相关操作仍然支持。升级完成后,人员库为新算法版本。
363
314
  单个人员库有且仅支持一次回滚操作。
364
315
 
@@ -366,74 +317,56 @@ export class Client extends TencentCloudCommon.AbstractClient {
366
317
 
367
318
  注:某些接口无法进行跨人员库版本操作,例如SearchFaces,SearchPersons和CopyPerson等。当业务有多个Group操作的场景时,如同时搜索Group1和Group2,如果升级了Group1,此时Group1和Group2版本不同,造成了跨版本操作,将导致Search接口无法正常执行,返回不允许执行跨版本操作错误,升级前需考虑业务是否有多库操作的场景,否则会影响线上接口表现。
368
319
  */
369
- async UpgradeGroupFaceModelVersion(
370
- req: UpgradeGroupFaceModelVersionRequest,
371
- cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void
372
- ): Promise<UpgradeGroupFaceModelVersionResponse> {
373
- return this.request("UpgradeGroupFaceModelVersion", req, cb)
374
- }
320
+ async UpgradeGroupFaceModelVersion(req: UpgradeGroupFaceModelVersionRequest, cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void): Promise<UpgradeGroupFaceModelVersionResponse> {
321
+ return this.request("UpgradeGroupFaceModelVersion", req, cb);
322
+ }
375
323
 
376
- /**
324
+ /**
377
325
  * 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
378
326
 
379
327
  回滚操作会在10s内生效,回滚操作中,您对人员库的操作可能会失效。
380
328
  */
381
- async RevertGroupFaceModelVersion(
382
- req: RevertGroupFaceModelVersionRequest,
383
- cb?: (error: string, rep: RevertGroupFaceModelVersionResponse) => void
384
- ): Promise<RevertGroupFaceModelVersionResponse> {
385
- return this.request("RevertGroupFaceModelVersion", req, cb)
386
- }
329
+ async RevertGroupFaceModelVersion(req: RevertGroupFaceModelVersionRequest, cb?: (error: string, rep: RevertGroupFaceModelVersionResponse) => void): Promise<RevertGroupFaceModelVersionResponse> {
330
+ return this.request("RevertGroupFaceModelVersion", req, cb);
331
+ }
387
332
 
388
- /**
333
+ /**
389
334
  * 创建人员,添加人脸、姓名、性别及其他相关信息。
390
335
 
391
336
  >
392
337
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
393
338
  */
394
- async CreatePerson(
395
- req: CreatePersonRequest,
396
- cb?: (error: string, rep: CreatePersonResponse) => void
397
- ): Promise<CreatePersonResponse> {
398
- return this.request("CreatePerson", req, cb)
399
- }
339
+ async CreatePerson(req: CreatePersonRequest, cb?: (error: string, rep: CreatePersonResponse) => void): Promise<CreatePersonResponse> {
340
+ return this.request("CreatePerson", req, cb);
341
+ }
400
342
 
401
- /**
343
+ /**
402
344
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
403
345
 
404
346
  防疫场景人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
405
347
 
406
348
  如图片人脸不存在防疫场景下戴口罩的情况,建议使用人脸比对服务。
407
349
  */
408
- async CompareMaskFace(
409
- req: CompareMaskFaceRequest,
410
- cb?: (error: string, rep: CompareMaskFaceResponse) => void
411
- ): Promise<CompareMaskFaceResponse> {
412
- return this.request("CompareMaskFace", req, cb)
413
- }
350
+ async CompareMaskFace(req: CompareMaskFaceRequest, cb?: (error: string, rep: CompareMaskFaceResponse) => void): Promise<CompareMaskFaceResponse> {
351
+ return this.request("CompareMaskFace", req, cb);
352
+ }
414
353
 
415
- /**
354
+ /**
416
355
  * 获取人员库升级任务列表
417
356
 
418
357
  */
419
- async GetUpgradeGroupFaceModelVersionJobList(
420
- req: GetUpgradeGroupFaceModelVersionJobListRequest,
421
- cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionJobListResponse) => void
422
- ): Promise<GetUpgradeGroupFaceModelVersionJobListResponse> {
423
- return this.request("GetUpgradeGroupFaceModelVersionJobList", req, cb)
424
- }
425
-
426
- /**
427
- * 获取人员库信息。
428
- */
429
- async GetGroupInfo(
430
- req: GetGroupInfoRequest,
431
- cb?: (error: string, rep: GetGroupInfoResponse) => void
432
- ): Promise<GetGroupInfoResponse> {
433
- return this.request("GetGroupInfo", req, cb)
434
- }
435
-
436
- /**
358
+ async GetUpgradeGroupFaceModelVersionJobList(req: GetUpgradeGroupFaceModelVersionJobListRequest, cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionJobListResponse) => void): Promise<GetUpgradeGroupFaceModelVersionJobListResponse> {
359
+ return this.request("GetUpgradeGroupFaceModelVersionJobList", req, cb);
360
+ }
361
+
362
+ /**
363
+ * 获取人员库信息。
364
+ */
365
+ async GetGroupInfo(req: GetGroupInfoRequest, cb?: (error: string, rep: GetGroupInfoResponse) => void): Promise<GetGroupInfoResponse> {
366
+ return this.request("GetGroupInfo", req, cb);
367
+ }
368
+
369
+ /**
437
370
  * 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
438
371
 
439
372
 
@@ -452,24 +385,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
452
385
 
453
386
 
454
387
  */
455
- async DetectFace(
456
- req: DetectFaceRequest,
457
- cb?: (error: string, rep: DetectFaceResponse) => void
458
- ): Promise<DetectFaceResponse> {
459
- return this.request("DetectFace", req, cb)
460
- }
388
+ async DetectFace(req: DetectFaceRequest, cb?: (error: string, rep: DetectFaceResponse) => void): Promise<DetectFaceResponse> {
389
+ return this.request("DetectFace", req, cb);
390
+ }
461
391
 
462
- /**
463
- * 获取指定人员库中的人员列表。
464
- */
465
- async GetPersonList(
466
- req: GetPersonListRequest,
467
- cb?: (error: string, rep: GetPersonListResponse) => void
468
- ): Promise<GetPersonListResponse> {
469
- return this.request("GetPersonList", req, cb)
470
- }
392
+ /**
393
+ * 获取指定人员库中的人员列表。
394
+ */
395
+ async GetPersonList(req: GetPersonListRequest, cb?: (error: string, rep: GetPersonListResponse) => void): Promise<GetPersonListResponse> {
396
+ return this.request("GetPersonList", req, cb);
397
+ }
471
398
 
472
- /**
399
+ /**
473
400
  * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
474
401
  本接口会将该人员(Person)下的所有人脸(Face)进行融合特征处理,即若某个Person下有4张 Face,本接口会将4张 Face 的特征进行融合处理,生成对应这个 Person 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
475
402
 
@@ -480,14 +407,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
480
407
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
481
408
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
482
409
  */
483
- async VerifyPerson(
484
- req: VerifyPersonRequest,
485
- cb?: (error: string, rep: VerifyPersonResponse) => void
486
- ): Promise<VerifyPersonResponse> {
487
- return this.request("VerifyPerson", req, cb)
488
- }
410
+ async VerifyPerson(req: VerifyPersonRequest, cb?: (error: string, rep: VerifyPersonResponse) => void): Promise<VerifyPersonResponse> {
411
+ return this.request("VerifyPerson", req, cb);
412
+ }
489
413
 
490
- /**
414
+ /**
491
415
  * 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
492
416
 
493
417
 
@@ -510,46 +434,34 @@ export class Client extends TencentCloudCommon.AbstractClient {
510
434
  >
511
435
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
512
436
  */
513
- async DetectFaceAttributes(
514
- req: DetectFaceAttributesRequest,
515
- cb?: (error: string, rep: DetectFaceAttributesResponse) => void
516
- ): Promise<DetectFaceAttributesResponse> {
517
- return this.request("DetectFaceAttributes", req, cb)
518
- }
437
+ async DetectFaceAttributes(req: DetectFaceAttributesRequest, cb?: (error: string, rep: DetectFaceAttributesResponse) => void): Promise<DetectFaceAttributesResponse> {
438
+ return this.request("DetectFaceAttributes", req, cb);
439
+ }
519
440
 
520
- /**
441
+ /**
521
442
  * 人脸静态活体检测(高精度版)可用于对用户上传的静态图片进行防翻拍活体检测,以判断是否是翻拍图片。
522
443
 
523
444
  相比现有静态活体检测服务,高精度版在维持高真人通过率的前提下,增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力,攻击拦截率约为业内同类型产品形态4-5倍。同时支持多场景人脸核验,满足移动端、PC端各类型场景的图片活体检验需求,适用于各个行业不同的活体检验应用。
524
445
  */
525
- async DetectLiveFaceAccurate(
526
- req: DetectLiveFaceAccurateRequest,
527
- cb?: (error: string, rep: DetectLiveFaceAccurateResponse) => void
528
- ): Promise<DetectLiveFaceAccurateResponse> {
529
- return this.request("DetectLiveFaceAccurate", req, cb)
530
- }
531
-
532
- /**
533
- * 人员库升级结果查询
534
- */
535
- async GetUpgradeGroupFaceModelVersionResult(
536
- req: GetUpgradeGroupFaceModelVersionResultRequest,
537
- cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionResultResponse) => void
538
- ): Promise<GetUpgradeGroupFaceModelVersionResultResponse> {
539
- return this.request("GetUpgradeGroupFaceModelVersionResult", req, cb)
540
- }
541
-
542
- /**
543
- * 修改指定人员库人员描述内容。
544
- */
545
- async ModifyPersonGroupInfo(
546
- req: ModifyPersonGroupInfoRequest,
547
- cb?: (error: string, rep: ModifyPersonGroupInfoResponse) => void
548
- ): Promise<ModifyPersonGroupInfoResponse> {
549
- return this.request("ModifyPersonGroupInfo", req, cb)
550
- }
551
-
552
- /**
446
+ async DetectLiveFaceAccurate(req: DetectLiveFaceAccurateRequest, cb?: (error: string, rep: DetectLiveFaceAccurateResponse) => void): Promise<DetectLiveFaceAccurateResponse> {
447
+ return this.request("DetectLiveFaceAccurate", req, cb);
448
+ }
449
+
450
+ /**
451
+ * 人员库升级结果查询
452
+ */
453
+ async GetUpgradeGroupFaceModelVersionResult(req: GetUpgradeGroupFaceModelVersionResultRequest, cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionResultResponse) => void): Promise<GetUpgradeGroupFaceModelVersionResultResponse> {
454
+ return this.request("GetUpgradeGroupFaceModelVersionResult", req, cb);
455
+ }
456
+
457
+ /**
458
+ * 修改指定人员库人员描述内容。
459
+ */
460
+ async ModifyPersonGroupInfo(req: ModifyPersonGroupInfoRequest, cb?: (error: string, rep: ModifyPersonGroupInfoResponse) => void): Promise<ModifyPersonGroupInfoResponse> {
461
+ return this.request("ModifyPersonGroupInfo", req, cb);
462
+ }
463
+
464
+ /**
553
465
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照相似度从大到小排列。
554
466
 
555
467
  支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
@@ -562,14 +474,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
562
474
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
563
475
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
564
476
  */
565
- async SearchPersons(
566
- req: SearchPersonsRequest,
567
- cb?: (error: string, rep: SearchPersonsResponse) => void
568
- ): Promise<SearchPersonsResponse> {
569
- return this.request("SearchPersons", req, cb)
570
- }
477
+ async SearchPersons(req: SearchPersonsRequest, cb?: (error: string, rep: SearchPersonsResponse) => void): Promise<SearchPersonsResponse> {
478
+ return this.request("SearchPersons", req, cb);
479
+ }
571
480
 
572
- /**
481
+ /**
573
482
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
574
483
 
575
484
  若您需要判断 “此人是否是某人”,即验证某张图片中的人是否是已知身份的某人,如常见的人脸登录场景,建议使用[人脸验证](https://cloud.tencent.com/document/product/867/44983)或[人员验证](https://cloud.tencent.com/document/product/867/44982)接口。
@@ -577,14 +486,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
577
486
  >
578
487
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
579
488
  */
580
- async CompareFace(
581
- req: CompareFaceRequest,
582
- cb?: (error: string, rep: CompareFaceResponse) => void
583
- ): Promise<CompareFaceResponse> {
584
- return this.request("CompareFace", req, cb)
585
- }
489
+ async CompareFace(req: CompareFaceRequest, cb?: (error: string, rep: CompareFaceResponse) => void): Promise<CompareFaceResponse> {
490
+ return this.request("CompareFace", req, cb);
491
+ }
586
492
 
587
- /**
493
+ /**
588
494
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
589
495
 
590
496
  支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
@@ -596,30 +502,23 @@ export class Client extends TencentCloudCommon.AbstractClient {
596
502
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
597
503
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
598
504
  */
599
- async SearchPersonsReturnsByGroup(
600
- req: SearchPersonsReturnsByGroupRequest,
601
- cb?: (error: string, rep: SearchPersonsReturnsByGroupResponse) => void
602
- ): Promise<SearchPersonsReturnsByGroupResponse> {
603
- return this.request("SearchPersonsReturnsByGroup", req, cb)
604
- }
605
-
606
- /**
607
- * 获取人员库列表。
608
- */
609
- async GetGroupList(
610
- req: GetGroupListRequest,
611
- cb?: (error: string, rep: GetGroupListResponse) => void
612
- ): Promise<GetGroupListResponse> {
613
- return this.request("GetGroupList", req, cb)
614
- }
615
-
616
- /**
617
- * 删除一个人员下的人脸图片。如果该人员只有一张人脸图片,则返回错误。
618
- */
619
- async DeleteFace(
620
- req: DeleteFaceRequest,
621
- cb?: (error: string, rep: DeleteFaceResponse) => void
622
- ): Promise<DeleteFaceResponse> {
623
- return this.request("DeleteFace", req, cb)
624
- }
505
+ async SearchPersonsReturnsByGroup(req: SearchPersonsReturnsByGroupRequest, cb?: (error: string, rep: SearchPersonsReturnsByGroupResponse) => void): Promise<SearchPersonsReturnsByGroupResponse> {
506
+ return this.request("SearchPersonsReturnsByGroup", req, cb);
507
+ }
508
+
509
+ /**
510
+ * 获取人员库列表。
511
+ */
512
+ async GetGroupList(req: GetGroupListRequest, cb?: (error: string, rep: GetGroupListResponse) => void): Promise<GetGroupListResponse> {
513
+ return this.request("GetGroupList", req, cb);
514
+ }
515
+
516
+ /**
517
+ * 删除一个人员下的人脸图片。如果该人员只有一张人脸图片,则返回错误。
518
+ */
519
+ async DeleteFace(req: DeleteFaceRequest, cb?: (error: string, rep: DeleteFaceResponse) => void): Promise<DeleteFaceResponse> {
520
+ return this.request("DeleteFace", req, cb);
521
+ }
522
+
523
+
625
524
  }