tencentcloud-sdk-nodejs-iai 4.0.431 → 4.0.432

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,105 +17,104 @@
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,
118
-
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,
119
118
  } from "./iai_models"
120
119
 
121
120
  /**
@@ -123,19 +122,21 @@ import {
123
122
  * @class
124
123
  */
125
124
  export class Client extends TencentCloudCommon.AbstractClient {
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
- /**
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
+ /**
139
140
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
140
141
 
141
142
  支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
@@ -153,11 +154,14 @@ export class Client extends TencentCloudCommon.AbstractClient {
153
154
  - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
154
155
 
155
156
  */
156
- async SearchFacesReturnsByGroup(req: SearchFacesReturnsByGroupRequest, cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void): Promise<SearchFacesReturnsByGroupResponse> {
157
- return this.request("SearchFacesReturnsByGroup", req, cb);
158
- }
157
+ async SearchFacesReturnsByGroup(
158
+ req: SearchFacesReturnsByGroupRequest,
159
+ cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void
160
+ ): Promise<SearchFacesReturnsByGroupResponse> {
161
+ return this.request("SearchFacesReturnsByGroup", req, cb)
162
+ }
159
163
 
160
- /**
164
+ /**
161
165
  * 用于创建一个空的人员库,如果人员库已存在返回错误。
162
166
  可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
163
167
 
@@ -165,18 +169,24 @@ export class Client extends TencentCloudCommon.AbstractClient {
165
169
 
166
170
  不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
167
171
  */
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
- /**
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
+ /**
180
190
  * 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是:静态活体检测中,用户不需要通过唇语或摇头眨眼等动作来识别。
181
191
 
182
192
  静态活体检测适用于手机自拍的场景,或对防攻击要求不高的场景。如果对活体检测有更高安全性要求,请使用[人脸核身·云智慧眼](https://cloud.tencent.com/product/faceid)产品。
@@ -190,60 +200,81 @@ export class Client extends TencentCloudCommon.AbstractClient {
190
200
  >
191
201
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
192
202
  */
193
- async DetectLiveFace(req: DetectLiveFaceRequest, cb?: (error: string, rep: DetectLiveFaceResponse) => void): Promise<DetectLiveFaceResponse> {
194
- return this.request("DetectLiveFace", req, cb);
195
- }
203
+ async DetectLiveFace(
204
+ req: DetectLiveFaceRequest,
205
+ cb?: (error: string, rep: DetectLiveFaceResponse) => void
206
+ ): Promise<DetectLiveFaceResponse> {
207
+ return this.request("DetectLiveFace", req, cb)
208
+ }
196
209
 
197
- /**
210
+ /**
198
211
  * 将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中,所有人员库中该人员图片均会增加。
199
212
 
200
213
  >
201
214
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
202
215
  */
203
- async CreateFace(req: CreateFaceRequest, cb?: (error: string, rep: CreateFaceResponse) => void): Promise<CreateFaceResponse> {
204
- return this.request("CreateFace", req, cb);
205
- }
216
+ async CreateFace(
217
+ req: CreateFaceRequest,
218
+ cb?: (error: string, rep: CreateFaceResponse) => void
219
+ ): Promise<CreateFaceResponse> {
220
+ return this.request("CreateFace", req, cb)
221
+ }
206
222
 
207
- /**
223
+ /**
208
224
  * 删除该人员库及包含的所有的人员。同时,人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中,该人员不会被删除,但属于该人员库中的自定义描述字段信息会被删除,属于其他人员库的自定义描述字段信息不受影响。
209
225
 
210
226
  */
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
- /**
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
+ /**
230
255
  * 对请求图片进行五官定位(也称人脸关键点定位),计算构成人脸轮廓的 90 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子(13 点)、嘴巴(22 点)、脸型轮廓(21 点)、眼珠[或瞳孔](2点)。
231
256
 
232
257
  >
233
258
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
234
259
  */
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
- /**
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
+ /**
247
278
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,识别结果按照相似度从大到小排序。
248
279
 
249
280
  支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
@@ -261,20 +292,26 @@ export class Client extends TencentCloudCommon.AbstractClient {
261
292
  >
262
293
  - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
263
294
  */
264
- async SearchFaces(req: SearchFacesRequest, cb?: (error: string, rep: SearchFacesResponse) => void): Promise<SearchFacesResponse> {
265
- return this.request("SearchFaces", req, cb);
266
- }
295
+ async SearchFaces(
296
+ req: SearchFacesRequest,
297
+ cb?: (error: string, rep: SearchFacesResponse) => void
298
+ ): Promise<SearchFacesResponse> {
299
+ return this.request("SearchFaces", req, cb)
300
+ }
267
301
 
268
- /**
302
+ /**
269
303
  * 将已存在于某人员库的人员复制到其他人员库,该人员的描述信息不会被复制。单个人员最多只能同时存在100个人员库中。
270
304
  >
271
305
  - 注:若该人员创建时算法模型版本为2.0,复制到非2.0算法模型版本的Group中时,复制操作将会失败。
272
306
  */
273
- async CopyPerson(req: CopyPersonRequest, cb?: (error: string, rep: CopyPersonResponse) => void): Promise<CopyPersonResponse> {
274
- return this.request("CopyPerson", req, cb);
275
- }
307
+ async CopyPerson(
308
+ req: CopyPersonRequest,
309
+ cb?: (error: string, rep: CopyPersonResponse) => void
310
+ ): Promise<CopyPersonResponse> {
311
+ return this.request("CopyPerson", req, cb)
312
+ }
276
313
 
277
- /**
314
+ /**
278
315
  * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
279
316
 
280
317
  与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
@@ -284,32 +321,44 @@ export class Client extends TencentCloudCommon.AbstractClient {
284
321
  >
285
322
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
286
323
  */
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
- /**
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
+ /**
313
362
  * 升级人员库。升级过程中,人员库仍然为原算法版本,人员库相关操作仍然支持。升级完成后,人员库为新算法版本。
314
363
  单个人员库有且仅支持一次回滚操作。
315
364
 
@@ -317,56 +366,74 @@ export class Client extends TencentCloudCommon.AbstractClient {
317
366
 
318
367
  注:某些接口无法进行跨人员库版本操作,例如SearchFaces,SearchPersons和CopyPerson等。当业务有多个Group操作的场景时,如同时搜索Group1和Group2,如果升级了Group1,此时Group1和Group2版本不同,造成了跨版本操作,将导致Search接口无法正常执行,返回不允许执行跨版本操作错误,升级前需考虑业务是否有多库操作的场景,否则会影响线上接口表现。
319
368
  */
320
- async UpgradeGroupFaceModelVersion(req: UpgradeGroupFaceModelVersionRequest, cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void): Promise<UpgradeGroupFaceModelVersionResponse> {
321
- return this.request("UpgradeGroupFaceModelVersion", req, cb);
322
- }
369
+ async UpgradeGroupFaceModelVersion(
370
+ req: UpgradeGroupFaceModelVersionRequest,
371
+ cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void
372
+ ): Promise<UpgradeGroupFaceModelVersionResponse> {
373
+ return this.request("UpgradeGroupFaceModelVersion", req, cb)
374
+ }
323
375
 
324
- /**
376
+ /**
325
377
  * 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
326
378
 
327
379
  回滚操作会在10s内生效,回滚操作中,您对人员库的操作可能会失效。
328
380
  */
329
- async RevertGroupFaceModelVersion(req: RevertGroupFaceModelVersionRequest, cb?: (error: string, rep: RevertGroupFaceModelVersionResponse) => void): Promise<RevertGroupFaceModelVersionResponse> {
330
- return this.request("RevertGroupFaceModelVersion", req, cb);
331
- }
381
+ async RevertGroupFaceModelVersion(
382
+ req: RevertGroupFaceModelVersionRequest,
383
+ cb?: (error: string, rep: RevertGroupFaceModelVersionResponse) => void
384
+ ): Promise<RevertGroupFaceModelVersionResponse> {
385
+ return this.request("RevertGroupFaceModelVersion", req, cb)
386
+ }
332
387
 
333
- /**
388
+ /**
334
389
  * 创建人员,添加人脸、姓名、性别及其他相关信息。
335
390
 
336
391
  >
337
392
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
338
393
  */
339
- async CreatePerson(req: CreatePersonRequest, cb?: (error: string, rep: CreatePersonResponse) => void): Promise<CreatePersonResponse> {
340
- return this.request("CreatePerson", req, cb);
341
- }
394
+ async CreatePerson(
395
+ req: CreatePersonRequest,
396
+ cb?: (error: string, rep: CreatePersonResponse) => void
397
+ ): Promise<CreatePersonResponse> {
398
+ return this.request("CreatePerson", req, cb)
399
+ }
342
400
 
343
- /**
401
+ /**
344
402
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
345
403
 
346
404
  防疫场景人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
347
405
 
348
406
  如图片人脸不存在防疫场景下戴口罩的情况,建议使用人脸比对服务。
349
407
  */
350
- async CompareMaskFace(req: CompareMaskFaceRequest, cb?: (error: string, rep: CompareMaskFaceResponse) => void): Promise<CompareMaskFaceResponse> {
351
- return this.request("CompareMaskFace", req, cb);
352
- }
408
+ async CompareMaskFace(
409
+ req: CompareMaskFaceRequest,
410
+ cb?: (error: string, rep: CompareMaskFaceResponse) => void
411
+ ): Promise<CompareMaskFaceResponse> {
412
+ return this.request("CompareMaskFace", req, cb)
413
+ }
353
414
 
354
- /**
415
+ /**
355
416
  * 获取人员库升级任务列表
356
417
 
357
418
  */
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
- /**
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
+ /**
370
437
  * 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
371
438
 
372
439
 
@@ -385,18 +452,24 @@ export class Client extends TencentCloudCommon.AbstractClient {
385
452
 
386
453
 
387
454
  */
388
- async DetectFace(req: DetectFaceRequest, cb?: (error: string, rep: DetectFaceResponse) => void): Promise<DetectFaceResponse> {
389
- return this.request("DetectFace", req, cb);
390
- }
455
+ async DetectFace(
456
+ req: DetectFaceRequest,
457
+ cb?: (error: string, rep: DetectFaceResponse) => void
458
+ ): Promise<DetectFaceResponse> {
459
+ return this.request("DetectFace", req, cb)
460
+ }
391
461
 
392
- /**
393
- * 获取指定人员库中的人员列表。
394
- */
395
- async GetPersonList(req: GetPersonListRequest, cb?: (error: string, rep: GetPersonListResponse) => void): Promise<GetPersonListResponse> {
396
- return this.request("GetPersonList", req, cb);
397
- }
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
+ }
398
471
 
399
- /**
472
+ /**
400
473
  * 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
401
474
  本接口会将该人员(Person)下的所有人脸(Face)进行融合特征处理,即若某个Person下有4张 Face,本接口会将4张 Face 的特征进行融合处理,生成对应这个 Person 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
402
475
 
@@ -407,11 +480,14 @@ export class Client extends TencentCloudCommon.AbstractClient {
407
480
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
408
481
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
409
482
  */
410
- async VerifyPerson(req: VerifyPersonRequest, cb?: (error: string, rep: VerifyPersonResponse) => void): Promise<VerifyPersonResponse> {
411
- return this.request("VerifyPerson", req, cb);
412
- }
483
+ async VerifyPerson(
484
+ req: VerifyPersonRequest,
485
+ cb?: (error: string, rep: VerifyPersonResponse) => void
486
+ ): Promise<VerifyPersonResponse> {
487
+ return this.request("VerifyPerson", req, cb)
488
+ }
413
489
 
414
- /**
490
+ /**
415
491
  * 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
416
492
 
417
493
 
@@ -434,34 +510,46 @@ export class Client extends TencentCloudCommon.AbstractClient {
434
510
  >
435
511
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
436
512
  */
437
- async DetectFaceAttributes(req: DetectFaceAttributesRequest, cb?: (error: string, rep: DetectFaceAttributesResponse) => void): Promise<DetectFaceAttributesResponse> {
438
- return this.request("DetectFaceAttributes", req, cb);
439
- }
513
+ async DetectFaceAttributes(
514
+ req: DetectFaceAttributesRequest,
515
+ cb?: (error: string, rep: DetectFaceAttributesResponse) => void
516
+ ): Promise<DetectFaceAttributesResponse> {
517
+ return this.request("DetectFaceAttributes", req, cb)
518
+ }
440
519
 
441
- /**
520
+ /**
442
521
  * 人脸静态活体检测(高精度版)可用于对用户上传的静态图片进行防翻拍活体检测,以判断是否是翻拍图片。
443
522
 
444
523
  相比现有静态活体检测服务,高精度版在维持高真人通过率的前提下,增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力,攻击拦截率约为业内同类型产品形态4-5倍。同时支持多场景人脸核验,满足移动端、PC端各类型场景的图片活体检验需求,适用于各个行业不同的活体检验应用。
445
524
  */
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
- /**
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
+ /**
465
553
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照相似度从大到小排列。
466
554
 
467
555
  支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
@@ -474,11 +562,14 @@ export class Client extends TencentCloudCommon.AbstractClient {
474
562
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
475
563
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
476
564
  */
477
- async SearchPersons(req: SearchPersonsRequest, cb?: (error: string, rep: SearchPersonsResponse) => void): Promise<SearchPersonsResponse> {
478
- return this.request("SearchPersons", req, cb);
479
- }
565
+ async SearchPersons(
566
+ req: SearchPersonsRequest,
567
+ cb?: (error: string, rep: SearchPersonsResponse) => void
568
+ ): Promise<SearchPersonsResponse> {
569
+ return this.request("SearchPersons", req, cb)
570
+ }
480
571
 
481
- /**
572
+ /**
482
573
  * 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
483
574
 
484
575
  若您需要判断 “此人是否是某人”,即验证某张图片中的人是否是已知身份的某人,如常见的人脸登录场景,建议使用[人脸验证](https://cloud.tencent.com/document/product/867/44983)或[人员验证](https://cloud.tencent.com/document/product/867/44982)接口。
@@ -486,11 +577,14 @@ export class Client extends TencentCloudCommon.AbstractClient {
486
577
  >
487
578
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
488
579
  */
489
- async CompareFace(req: CompareFaceRequest, cb?: (error: string, rep: CompareFaceResponse) => void): Promise<CompareFaceResponse> {
490
- return this.request("CompareFace", req, cb);
491
- }
580
+ async CompareFace(
581
+ req: CompareFaceRequest,
582
+ cb?: (error: string, rep: CompareFaceResponse) => void
583
+ ): Promise<CompareFaceResponse> {
584
+ return this.request("CompareFace", req, cb)
585
+ }
492
586
 
493
- /**
587
+ /**
494
588
  * 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
495
589
 
496
590
  支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
@@ -502,23 +596,30 @@ export class Client extends TencentCloudCommon.AbstractClient {
502
596
  - 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
503
597
  - 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
504
598
  */
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
-
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
+ }
524
625
  }