tencentcloud-sdk-nodejs-iai 4.0.617 → 4.0.619

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.
@@ -20,27 +20,24 @@
20
20
  */
21
21
  export interface Eye {
22
22
  /**
23
- * 识别是否佩戴眼镜。
23
+ * 识别是否佩戴眼镜。
24
24
  AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
25
- */
25
+ */
26
26
  Glass: AttributeItem
27
-
28
27
  /**
29
- * 识别眼睛的睁开、闭合状态。
28
+ * 识别眼睛的睁开、闭合状态。
30
29
  AttributeItem对应的Type为 —— 0:睁开,1:闭眼
31
- */
30
+ */
32
31
  EyeOpen: AttributeItem
33
-
34
32
  /**
35
- * 识别是否双眼皮。
33
+ * 识别是否双眼皮。
36
34
  AttributeItem对应的Type为 —— 0:无,1:有。
37
- */
35
+ */
38
36
  EyelidType: AttributeItem
39
-
40
37
  /**
41
- * 眼睛大小。
38
+ * 眼睛大小。
42
39
  AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
43
- */
40
+ */
44
41
  EyeSize: AttributeItem
45
42
  }
46
43
 
@@ -52,39 +49,34 @@ export interface Candidate {
52
49
  * 人员ID
53
50
  */
54
51
  PersonId: string
55
-
56
52
  /**
57
53
  * 人脸ID,仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索,该字段无意义
58
54
  */
59
55
  FaceId: string
60
-
61
56
  /**
62
- * 候选者的匹配得分。
57
+ * 候选者的匹配得分。
63
58
 
64
59
  1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
65
60
  10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分;
66
61
  30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
67
62
 
68
63
  一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
69
- */
64
+ */
70
65
  Score: number
71
-
72
66
  /**
73
- * 人员名称
67
+ * 人员名称
74
68
  注意:此字段可能返回 null,表示取不到有效值。
75
- */
69
+ */
76
70
  PersonName: string
77
-
78
71
  /**
79
- * 人员性别
72
+ * 人员性别
80
73
  注意:此字段可能返回 null,表示取不到有效值。
81
- */
74
+ */
82
75
  Gender: number
83
-
84
76
  /**
85
- * 包含此人员的人员库及描述字段内容列表
77
+ * 包含此人员的人员库及描述字段内容列表
86
78
  注意:此字段可能返回 null,表示取不到有效值。
87
- */
79
+ */
88
80
  PersonGroupInfos: Array<PersonGroupInfo>
89
81
  }
90
82
 
@@ -96,22 +88,18 @@ export interface DetectFaceAttributesResponse {
96
88
  * 请求的图片宽度。
97
89
  */
98
90
  ImageWidth: number
99
-
100
91
  /**
101
92
  * 请求的图片高度。
102
93
  */
103
94
  ImageHeight: number
104
-
105
95
  /**
106
96
  * 人脸信息列表。
107
97
  */
108
98
  FaceDetailInfos: Array<FaceDetailInfo>
109
-
110
99
  /**
111
100
  * 人脸识别所用的算法模型版本。
112
101
  */
113
102
  FaceModelVersion: string
114
-
115
103
  /**
116
104
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
117
105
  */
@@ -126,17 +114,14 @@ export interface SearchPersonsReturnsByGroupResponse {
126
114
  * 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求,则返回0。
127
115
  */
128
116
  PersonNum?: number
129
-
130
117
  /**
131
118
  * 识别结果。
132
119
  */
133
120
  ResultsReturnsByGroup?: Array<ResultsReturnsByGroup>
134
-
135
121
  /**
136
122
  * 人脸识别所用的算法模型版本。
137
123
  */
138
124
  FaceModelVersion?: string
139
-
140
125
  /**
141
126
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
142
127
  */
@@ -151,7 +136,6 @@ export interface PersonGroupInfo {
151
136
  * 包含此人员的人员库ID
152
137
  */
153
138
  GroupId: string
154
-
155
139
  /**
156
140
  * 人员描述字段内容
157
141
  */
@@ -163,15 +147,14 @@ export interface PersonGroupInfo {
163
147
  */
164
148
  export interface Hat {
165
149
  /**
166
- * 帽子佩戴状态信息。
150
+ * 帽子佩戴状态信息。
167
151
  AttributeItem对应的Type为 —— 0:不戴帽子,1:普通帽子,2:头盔,3:保安帽。
168
- */
152
+ */
169
153
  Style: AttributeItem
170
-
171
154
  /**
172
- * 帽子颜色。
155
+ * 帽子颜色。
173
156
  AttributeItem对应的Type为 —— 0:不戴帽子,1:红色系,2:黄色系,3:蓝色系,4:黑色系,5:灰白色系,6:混色系子。
174
- */
157
+ */
175
158
  Color: AttributeItem
176
159
  }
177
160
 
@@ -183,44 +166,37 @@ export interface CreatePersonRequest {
183
166
  * 待加入的人员库ID。
184
167
  */
185
168
  GroupId: string
186
-
187
169
  /**
188
170
  * 人员名称。[1,60]个字符,可修改,可重复。
189
171
  */
190
172
  PersonName: string
191
-
192
173
  /**
193
174
  * 人员ID,单个腾讯云账号下不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
194
175
  */
195
176
  PersonId: string
196
-
197
177
  /**
198
178
  * 0代表未填写,1代表男性,2代表女性。
199
179
  */
200
180
  Gender?: number
201
-
202
181
  /**
203
182
  * 人员描述字段内容,key-value。[0,60]个字符,可修改,可重复。
204
183
  */
205
184
  PersonExDescriptionInfos?: Array<PersonExDescriptionInfo>
206
-
207
185
  /**
208
- * 图片 base64 数据,base64 编码后大小不可超过5M。
186
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
209
187
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
210
- */
188
+ */
211
189
  Image?: string
212
-
213
190
  /**
214
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
191
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
215
192
  Url、Image必须提供一个,如果都提供,只使用 Url。
216
193
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
217
194
  非腾讯云存储的Url速度和稳定性可能受一定影响。
218
195
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
219
- */
196
+ */
220
197
  Url?: string
221
-
222
198
  /**
223
- * 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
199
+ * 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
224
200
  如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
225
201
  如果判断没有,则完成创建人员。
226
202
  0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
@@ -230,11 +206,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
230
206
  4: 很高的同一人判断要求(十万一误识别率)。
231
207
  默认 0。
232
208
  注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
233
- */
209
+ */
234
210
  UniquePersonControl?: number
235
-
236
211
  /**
237
- * 图片质量控制。
212
+ * 图片质量控制。
238
213
  0: 不进行控制;
239
214
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
240
215
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -242,9 +217,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
242
217
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
243
218
  默认 0。
244
219
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
245
- */
220
+ */
246
221
  QualityControl?: number
247
-
248
222
  /**
249
223
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
250
224
  */
@@ -259,36 +233,30 @@ export interface CreateFaceResponse {
259
233
  * 加入成功的人脸数量
260
234
  */
261
235
  SucFaceNum: number
262
-
263
236
  /**
264
237
  * 加入成功的人脸ID列表
265
238
  */
266
239
  SucFaceIds: Array<string>
267
-
268
240
  /**
269
- * 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
241
+ * 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
270
242
  -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
271
243
  其他非 0 值代表算法服务异常。
272
244
  RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
273
- */
245
+ */
274
246
  RetCode: Array<number>
275
-
276
247
  /**
277
- * 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
248
+ * 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
278
249
  例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
279
- */
250
+ */
280
251
  SucIndexes: Array<number>
281
-
282
252
  /**
283
253
  * 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
284
254
  */
285
255
  SucFaceRects: Array<FaceRect>
286
-
287
256
  /**
288
257
  * 人脸识别所用的算法模型版本。
289
258
  */
290
259
  FaceModelVersion: string
291
-
292
260
  /**
293
261
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
294
262
  */
@@ -300,21 +268,19 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
300
268
  */
301
269
  export interface FaceHairAttributesInfo {
302
270
  /**
303
- * 0:光头,1:短发,2:中发,3:长发,4:绑发
271
+ * 0:光头,1:短发,2:中发,3:长发,4:绑发
304
272
  注意:此字段可能返回 null,表示取不到有效值。
305
- */
273
+ */
306
274
  Length: number
307
-
308
275
  /**
309
- * 0:有刘海,1:无刘海
276
+ * 0:有刘海,1:无刘海
310
277
  注意:此字段可能返回 null,表示取不到有效值。
311
- */
278
+ */
312
279
  Bang: number
313
-
314
280
  /**
315
- * 0:黑色,1:金色,2:棕色,3:灰白色
281
+ * 0:黑色,1:金色,2:棕色,3:灰白色
316
282
  注意:此字段可能返回 null,表示取不到有效值。
317
- */
283
+ */
318
284
  Color: number
319
285
  }
320
286
 
@@ -326,34 +292,30 @@ export interface CreateFaceRequest {
326
292
  * 人员ID。
327
293
  */
328
294
  PersonId: string
329
-
330
295
  /**
331
- * 图片 base64 数据,base64 编码后大小不可超过5M。
296
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
332
297
  人员人脸总数量不可超过5张。
333
298
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
334
299
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
335
- */
300
+ */
336
301
  Images?: Array<string>
337
-
338
302
  /**
339
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
303
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
340
304
  Url、Image必须提供一个,如果都提供,只使用 Url。
341
305
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
342
306
  非腾讯云存储的Url速度和稳定性可能受一定影响。
343
307
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
344
308
  人员人脸总数量不可超过5张。
345
309
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
346
- */
310
+ */
347
311
  Urls?: Array<string>
348
-
349
312
  /**
350
- * 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
313
+ * 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
351
314
  默认值60分。取值范围[0,100] 。
352
- */
315
+ */
353
316
  FaceMatchThreshold?: number
354
-
355
317
  /**
356
- * 图片质量控制。
318
+ * 图片质量控制。
357
319
  0: 不进行控制;
358
320
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
359
321
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -361,9 +323,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
361
323
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
362
324
  默认 0。
363
325
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
364
- */
326
+ */
365
327
  QualityControl?: number
366
-
367
328
  /**
368
329
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
369
330
  */
@@ -378,30 +339,26 @@ export interface CreateGroupRequest {
378
339
  * 人员库名称,[1,60]个字符,可修改,不可重复。
379
340
  */
380
341
  GroupName: string
381
-
382
342
  /**
383
343
  * 人员库 ID,不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
384
344
  */
385
345
  GroupId: string
386
-
387
346
  /**
388
- * 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
347
+ * 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
389
348
  最多可以创建5个。
390
349
  每个自定义描述字段支持[1,30]个字符。
391
350
  在同一人员库中自定义描述字段不可重复。
392
351
  例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
393
352
  则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
394
353
  可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
395
- */
354
+ */
396
355
  GroupExDescriptions?: Array<string>
397
-
398
356
  /**
399
357
  * 人员库信息备注,[0,40]个字符。
400
358
  */
401
359
  Tag?: string
402
-
403
360
  /**
404
- * 人脸识别服务所用的算法模型版本。
361
+ * 人脸识别服务所用的算法模型版本。
405
362
 
406
363
  目前入参支持 “2.0”和“3.0“ 两个输入。
407
364
 
@@ -410,7 +367,7 @@ export interface CreateGroupRequest {
410
367
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
411
368
 
412
369
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
413
- */
370
+ */
414
371
  FaceModelVersion?: string
415
372
  }
416
373
 
@@ -422,12 +379,10 @@ export interface GetPersonGroupInfoRequest {
422
379
  * 人员ID
423
380
  */
424
381
  PersonId: string
425
-
426
382
  /**
427
383
  * 起始序号,默认值为0
428
384
  */
429
385
  Offset?: number
430
-
431
386
  /**
432
387
  * 返回数量,默认值为10,最大值为100
433
388
  */
@@ -439,39 +394,34 @@ export interface GetPersonGroupInfoRequest {
439
394
  */
440
395
  export interface FaceInfo {
441
396
  /**
442
- * 人脸框左上角横坐标。
397
+ * 人脸框左上角横坐标。
443
398
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
444
399
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
445
- */
400
+ */
446
401
  X: number
447
-
448
402
  /**
449
- * 人脸框左上角纵坐标。
403
+ * 人脸框左上角纵坐标。
450
404
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
451
405
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
452
- */
406
+ */
453
407
  Y: number
454
-
455
408
  /**
456
409
  * 人脸框宽度。
457
410
  */
458
411
  Width: number
459
-
460
412
  /**
461
413
  * 人脸框高度。
462
414
  */
463
415
  Height: number
464
-
465
416
  /**
466
- * 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
417
+ * 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
467
418
  魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
468
- */
419
+ */
469
420
  FaceAttributesInfo: FaceAttributesInfo
470
-
471
421
  /**
472
- * 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
422
+ * 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
473
423
  注意:此字段可能返回 null,表示取不到有效值。
474
- */
424
+ */
475
425
  FaceQualityInfo: FaceQualityInfo
476
426
  }
477
427
 
@@ -480,21 +430,19 @@ export interface FaceInfo {
480
430
  */
481
431
  export interface Eyebrow {
482
432
  /**
483
- * 眉毛浓密。
433
+ * 眉毛浓密。
484
434
  AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
485
- */
435
+ */
486
436
  EyebrowDensity: AttributeItem
487
-
488
437
  /**
489
- * 眉毛弯曲。
438
+ * 眉毛弯曲。
490
439
  AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
491
- */
440
+ */
492
441
  EyebrowCurve: AttributeItem
493
-
494
442
  /**
495
- * 眉毛长短。
443
+ * 眉毛长短。
496
444
  AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
497
- */
445
+ */
498
446
  EyebrowLength: AttributeItem
499
447
  }
500
448
 
@@ -503,34 +451,30 @@ AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
503
451
  */
504
452
  export interface AnalyzeDenseLandmarksRequest {
505
453
  /**
506
- * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
454
+ * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
507
455
  默认为 0。
508
456
  最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
509
- */
457
+ */
510
458
  Mode?: number
511
-
512
459
  /**
513
- * 图片 base64 数据,base64 编码后大小不可超过5M。
460
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
514
461
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
515
462
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
516
- */
463
+ */
517
464
  Image?: string
518
-
519
465
  /**
520
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
466
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
521
467
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
522
468
  Url、Image必须提供一个,如果都提供,只使用 Url。
523
469
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
524
470
  非腾讯云存储的Url速度和稳定性可能受一定影响。
525
471
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
526
- */
472
+ */
527
473
  Url?: string
528
-
529
474
  /**
530
475
  * 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
531
476
  */
532
477
  FaceModelVersion?: string
533
-
534
478
  /**
535
479
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
536
480
  */
@@ -545,7 +489,6 @@ export interface GetGroupListRequest {
545
489
  * 起始序号,默认值为0
546
490
  */
547
491
  Offset?: number
548
-
549
492
  /**
550
493
  * 返回数量,默认值为10,最大值为1000
551
494
  */
@@ -560,7 +503,6 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
560
503
  * 起始序号,默认值为0。
561
504
  */
562
505
  Offset?: number
563
-
564
506
  /**
565
507
  * 返回数量,默认值为10,最大值为1000。
566
508
  */
@@ -572,50 +514,42 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
572
514
  */
573
515
  export interface GetUpgradeGroupFaceModelVersionResultResponse {
574
516
  /**
575
- * 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
517
+ * 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
576
518
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
577
519
  如果为0表示这个任务已经执行完毕。
578
- */
520
+ */
579
521
  EndTimestamp: number
580
-
581
522
  /**
582
523
  * 升级任务完成进度。取值[0.0,100.0]。
583
524
  */
584
525
  Progress: number
585
-
586
526
  /**
587
527
  * 0表示升级中,1表示升级完毕,2表示回滚完毕。
588
528
  */
589
529
  Status: number
590
-
591
530
  /**
592
- * 升级起始时间。
531
+ * 升级起始时间。
593
532
  StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
594
533
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
595
534
  有关更多信息,请参阅 Unix 时间。
596
- */
535
+ */
597
536
  StartTime: number
598
-
599
537
  /**
600
538
  * 当前算法模型版本。
601
539
  */
602
540
  FromFaceModelVersion: string
603
-
604
541
  /**
605
542
  * 目标算法模型版本。
606
543
  */
607
544
  ToFaceModelVersion: string
608
-
609
545
  /**
610
546
  * 人员库ID。
611
547
  */
612
548
  GroupId: string
613
-
614
549
  /**
615
550
  * 无法升级的人脸Id信息,文件格式为json。半小时有效
616
551
  */
617
552
  FailedFacesUrl: string
618
-
619
553
  /**
620
554
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
621
555
  */
@@ -630,24 +564,21 @@ export interface AnalyzeFaceRequest {
630
564
  * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
631
565
  */
632
566
  Mode?: number
633
-
634
567
  /**
635
- * 图片 base64 数据,base64 编码后大小不可超过5M。
568
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
636
569
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
637
- */
570
+ */
638
571
  Image?: string
639
-
640
572
  /**
641
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
573
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
642
574
  Url、Image必须提供一个,如果都提供,只使用 Url。
643
575
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
644
576
  非腾讯云存储的Url速度和稳定性可能受一定影响。
645
577
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
646
- */
578
+ */
647
579
  Url?: string
648
-
649
580
  /**
650
- * 人脸识别服务所用的算法模型版本。
581
+ * 人脸识别服务所用的算法模型版本。
651
582
 
652
583
  目前入参支持 “2.0”和“3.0“ 两个输入。
653
584
 
@@ -656,9 +587,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
656
587
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
657
588
 
658
589
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
659
- */
590
+ */
660
591
  FaceModelVersion?: string
661
-
662
592
  /**
663
593
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
664
594
  */
@@ -673,24 +603,20 @@ export interface CreatePersonResponse {
673
603
  * 人脸图片唯一标识。
674
604
  */
675
605
  FaceId?: string
676
-
677
606
  /**
678
- * 检测出的人脸框的位置。
607
+ * 检测出的人脸框的位置。
679
608
  注意:此字段可能返回 null,表示取不到有效值。
680
- */
609
+ */
681
610
  FaceRect?: FaceRect
682
-
683
611
  /**
684
- * 疑似同一人的PersonId。
612
+ * 疑似同一人的PersonId。
685
613
  当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
686
- */
614
+ */
687
615
  SimilarPersonId?: string
688
-
689
616
  /**
690
617
  * 人脸识别所用的算法模型版本。
691
618
  */
692
619
  FaceModelVersion?: string
693
-
694
620
  /**
695
621
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
696
622
  */
@@ -705,17 +631,14 @@ export interface SearchFacesResponse {
705
631
  * 识别结果。
706
632
  */
707
633
  Results: Array<Result>
708
-
709
634
  /**
710
635
  * 搜索的人员库中包含的人脸数。
711
636
  */
712
637
  FaceNum: number
713
-
714
638
  /**
715
639
  * 人脸识别所用的算法模型版本。
716
640
  */
717
641
  FaceModelVersion: string
718
-
719
642
  /**
720
643
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
721
644
  */
@@ -730,12 +653,10 @@ export interface CopyPersonResponse {
730
653
  * 成功加入的人员库数量
731
654
  */
732
655
  SucGroupNum?: number
733
-
734
656
  /**
735
657
  * 成功加入的人员库列表
736
658
  */
737
659
  SucGroupIds?: Array<string>
738
-
739
660
  /**
740
661
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
741
662
  */
@@ -750,7 +671,6 @@ export interface GroupCandidate {
750
671
  * 人员库ID 。
751
672
  */
752
673
  GroupId: string
753
-
754
674
  /**
755
675
  * 识别出的最相似候选人。
756
676
  */
@@ -765,12 +685,10 @@ export interface DeleteFaceResponse {
765
685
  * 删除成功的人脸数量
766
686
  */
767
687
  SucDeletedNum?: number
768
-
769
688
  /**
770
689
  * 删除成功的人脸ID列表
771
690
  */
772
691
  SucFaceIds?: Array<string>
773
-
774
692
  /**
775
693
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
776
694
  */
@@ -792,22 +710,19 @@ export interface DeletePersonRequest {
792
710
  */
793
711
  export interface DetectLiveFaceResponse {
794
712
  /**
795
- * 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
713
+ * 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
796
714
  本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
797
- */
715
+ */
798
716
  Score: number
799
-
800
717
  /**
801
718
  * 人脸识别所用的算法模型版本。
802
719
  */
803
720
  FaceModelVersion: string
804
-
805
721
  /**
806
- * 活体检测是否通过。
722
+ * 活体检测是否通过。
807
723
  本字段只有FaceModelVersion为3.0时才具备参考意义。
808
- */
724
+ */
809
725
  IsLiveness: boolean
810
-
811
726
  /**
812
727
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
813
728
  */
@@ -822,7 +737,6 @@ export interface DeleteFaceRequest {
822
737
  * 人员ID
823
738
  */
824
739
  PersonId: string
825
-
826
740
  /**
827
741
  * 待删除的人脸ID列表
828
742
  */
@@ -837,17 +751,14 @@ export interface ModifyGroupRequest {
837
751
  * 人员库ID
838
752
  */
839
753
  GroupId: string
840
-
841
754
  /**
842
755
  * 人员库名称
843
756
  */
844
757
  GroupName?: string
845
-
846
758
  /**
847
759
  * 需要修改的人员库自定义描述字段,key-value
848
760
  */
849
761
  GroupExDescriptionInfos?: Array<GroupExDescriptionInfo>
850
-
851
762
  /**
852
763
  * 人员库信息备注
853
764
  */
@@ -872,7 +783,6 @@ export interface UpgradeGroupFaceModelVersionRequest {
872
783
  * 需要升级的人员库ID。
873
784
  */
874
785
  GroupId: string
875
-
876
786
  /**
877
787
  * 需要升级至的算法模型版本。默认为最新版本。不可逆向升级
878
788
  */
@@ -884,23 +794,21 @@ export interface UpgradeGroupFaceModelVersionRequest {
884
794
  */
885
795
  export interface DetectLiveFaceRequest {
886
796
  /**
887
- * 图片 base64 数据,base64 编码后大小不可超过5M(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
797
+ * 图片 base64 数据,base64 编码后大小不可超过5M(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
888
798
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
889
- */
799
+ */
890
800
  Image?: string
891
-
892
801
  /**
893
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
802
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
894
803
  Url、Image必须提供一个,如果都提供,只使用 Url。
895
804
  (图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
896
805
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
897
806
  非腾讯云存储的Url速度和稳定性可能受一定影响。
898
807
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
899
- */
808
+ */
900
809
  Url?: string
901
-
902
810
  /**
903
- * 人脸识别服务所用的算法模型版本。
811
+ * 人脸识别服务所用的算法模型版本。
904
812
 
905
813
  目前入参支持 “2.0”和“3.0“ 两个输入。
906
814
 
@@ -909,7 +817,7 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
909
817
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
910
818
 
911
819
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
912
- */
820
+ */
913
821
  FaceModelVersion?: string
914
822
  }
915
823
 
@@ -921,17 +829,14 @@ export interface GetPersonBaseInfoResponse {
921
829
  * 人员名称
922
830
  */
923
831
  PersonName?: string
924
-
925
832
  /**
926
833
  * 人员性别
927
834
  */
928
835
  Gender?: number
929
-
930
836
  /**
931
837
  * 包含的人脸 ID 列表
932
838
  */
933
839
  FaceIds?: Array<string>
934
-
935
840
  /**
936
841
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
937
842
  */
@@ -946,18 +851,15 @@ export interface SearchPersonsResponse {
946
851
  * 识别结果。
947
852
  */
948
853
  Results: Array<Result>
949
-
950
854
  /**
951
855
  * 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求,则返回0。
952
856
  */
953
857
  PersonNum: number
954
-
955
858
  /**
956
- * 人脸识别所用的算法模型版本。
859
+ * 人脸识别所用的算法模型版本。
957
860
  注意:此字段可能返回 null,表示取不到有效值。
958
- */
861
+ */
959
862
  FaceModelVersion: string
960
-
961
863
  /**
962
864
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
963
865
  */
@@ -982,35 +884,30 @@ export interface GroupInfo {
982
884
  * 人员库名称
983
885
  */
984
886
  GroupName: string
985
-
986
887
  /**
987
888
  * 人员库ID
988
889
  */
989
890
  GroupId: string
990
-
991
891
  /**
992
- * 人员库自定义描述字段
892
+ * 人员库自定义描述字段
993
893
  注意:此字段可能返回 null,表示取不到有效值。
994
- */
894
+ */
995
895
  GroupExDescriptions: Array<string>
996
-
997
896
  /**
998
- * 人员库信息备注
897
+ * 人员库信息备注
999
898
  注意:此字段可能返回 null,表示取不到有效值。
1000
- */
899
+ */
1001
900
  Tag: string
1002
-
1003
901
  /**
1004
- * 人脸识别所用的算法模型版本。
902
+ * 人脸识别所用的算法模型版本。
1005
903
  注意:此字段可能返回 null,表示取不到有效值。
1006
- */
904
+ */
1007
905
  FaceModelVersion: string
1008
-
1009
906
  /**
1010
- * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
907
+ * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
1011
908
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
1012
909
  注意:此字段可能返回 null,表示取不到有效值。
1013
- */
910
+ */
1014
911
  CreationTimestamp: number
1015
912
  }
1016
913
 
@@ -1019,34 +916,31 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
1019
916
  */
1020
917
  export interface FaceQualityInfo {
1021
918
  /**
1022
- * 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
919
+ * 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
1023
920
  正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
1024
921
  参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
1025
922
  建议:人脸入库选取70以上的图片。
1026
923
  注意:此字段可能返回 null,表示取不到有效值。
1027
- */
924
+ */
1028
925
  Score: number
1029
-
1030
926
  /**
1031
- * 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
927
+ * 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
1032
928
  参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
1033
929
  建议:人脸入库选取80以上的图片。
1034
930
  注意:此字段可能返回 null,表示取不到有效值。
1035
- */
931
+ */
1036
932
  Sharpness: number
1037
-
1038
933
  /**
1039
- * 光照分:[0,100],评价图片光照程度,分数越高越亮。
934
+ * 光照分:[0,100],评价图片光照程度,分数越高越亮。
1040
935
  参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
1041
936
  建议:人脸入库选取[30,70]的图片。
1042
937
  注意:此字段可能返回 null,表示取不到有效值。
1043
- */
938
+ */
1044
939
  Brightness: number
1045
-
1046
940
  /**
1047
- * 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
941
+ * 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
1048
942
  注意:此字段可能返回 null,表示取不到有效值。
1049
- */
943
+ */
1050
944
  Completeness: FaceQualityCompleteness
1051
945
  }
1052
946
 
@@ -1058,17 +952,14 @@ export interface SearchFacesReturnsByGroupResponse {
1058
952
  * 搜索的人员库中包含的人脸数。
1059
953
  */
1060
954
  FaceNum: number
1061
-
1062
955
  /**
1063
956
  * 识别结果。
1064
957
  */
1065
958
  ResultsReturnsByGroup: Array<ResultsReturnsByGroup>
1066
-
1067
959
  /**
1068
960
  * 人脸识别所用的算法模型版本。
1069
961
  */
1070
962
  FaceModelVersion: string
1071
-
1072
963
  /**
1073
964
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1074
965
  */
@@ -1083,7 +974,6 @@ export interface CopyPersonRequest {
1083
974
  * 人员ID
1084
975
  */
1085
976
  PersonId: string
1086
-
1087
977
  /**
1088
978
  * 待加入的人员库列表
1089
979
  */
@@ -1098,42 +988,36 @@ export interface SearchPersonsReturnsByGroupRequest {
1098
988
  * 希望搜索的人员库列表,上限60个。
1099
989
  */
1100
990
  GroupIds: Array<string>
1101
-
1102
991
  /**
1103
- * 图片 base64 数据,base64 编码后大小不可超过5M。
992
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1104
993
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1105
- */
994
+ */
1106
995
  Image?: string
1107
-
1108
996
  /**
1109
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
997
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1110
998
  Url、Image必须提供一个,如果都提供,只使用 Url。
1111
999
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1112
1000
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1113
1001
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1114
- */
1002
+ */
1115
1003
  Url?: string
1116
-
1117
1004
  /**
1118
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1005
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1119
1006
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1120
1007
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1121
- */
1008
+ */
1122
1009
  MaxFaceNum?: number
1123
-
1124
1010
  /**
1125
1011
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
1126
1012
  */
1127
1013
  MinFaceSize?: number
1128
-
1129
1014
  /**
1130
- * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1015
+ * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1131
1016
  例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
1132
- */
1017
+ */
1133
1018
  MaxPersonNumPerGroup?: number
1134
-
1135
1019
  /**
1136
- * 图片质量控制。
1020
+ * 图片质量控制。
1137
1021
  0: 不进行控制;
1138
1022
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1139
1023
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1141,19 +1025,16 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1141
1025
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1142
1026
  默认 0。
1143
1027
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1144
- */
1028
+ */
1145
1029
  QualityControl?: number
1146
-
1147
1030
  /**
1148
1031
  * 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
1149
1032
  */
1150
1033
  FaceMatchThreshold?: number
1151
-
1152
1034
  /**
1153
1035
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
1154
1036
  */
1155
1037
  NeedPersonInfo?: number
1156
-
1157
1038
  /**
1158
1039
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1159
1040
  */
@@ -1178,87 +1059,70 @@ export interface DenseFaceShape {
1178
1059
  * 人脸框左上角横坐标。
1179
1060
  */
1180
1061
  X: number
1181
-
1182
1062
  /**
1183
1063
  * 人脸框左上角纵坐标。
1184
1064
  */
1185
1065
  Y: number
1186
-
1187
1066
  /**
1188
1067
  * 人脸框宽度。
1189
1068
  */
1190
1069
  Width: number
1191
-
1192
1070
  /**
1193
1071
  * 人脸框高度。
1194
1072
  */
1195
1073
  Height: number
1196
-
1197
1074
  /**
1198
1075
  * 描述左侧眼睛轮廓的 XX 点。
1199
1076
  */
1200
1077
  LeftEye: Array<Point>
1201
-
1202
1078
  /**
1203
1079
  * 描述右侧眼睛轮廓的 XX 点。
1204
1080
  */
1205
1081
  RightEye: Array<Point>
1206
-
1207
1082
  /**
1208
1083
  * 描述左侧眉毛轮廓的 XX 点。
1209
1084
  */
1210
1085
  LeftEyeBrow: Array<Point>
1211
-
1212
1086
  /**
1213
1087
  * 描述右侧眉毛轮廓的 XX 点。
1214
1088
  */
1215
1089
  RightEyeBrow: Array<Point>
1216
-
1217
1090
  /**
1218
1091
  * 描述外嘴巴轮廓的 XX 点, 从左侧开始逆时针返回。
1219
1092
  */
1220
1093
  MouthOutside: Array<Point>
1221
-
1222
1094
  /**
1223
1095
  * 描述内嘴巴轮廓的 XX 点,从左侧开始逆时针返回。
1224
1096
  */
1225
1097
  MouthInside: Array<Point>
1226
-
1227
1098
  /**
1228
1099
  * 描述鼻子轮廓的 XX 点。
1229
1100
  */
1230
1101
  Nose: Array<Point>
1231
-
1232
1102
  /**
1233
1103
  * 左瞳孔轮廓的 XX 个点。
1234
1104
  */
1235
1105
  LeftPupil: Array<Point>
1236
-
1237
1106
  /**
1238
1107
  * 右瞳孔轮廓的 XX 个点。
1239
1108
  */
1240
1109
  RightPupil: Array<Point>
1241
-
1242
1110
  /**
1243
1111
  * 中轴线轮廓的 XX 个点。
1244
1112
  */
1245
1113
  CentralAxis: Array<Point>
1246
-
1247
1114
  /**
1248
1115
  * 下巴轮廓的 XX 个点。
1249
1116
  */
1250
1117
  Chin: Array<Point>
1251
-
1252
1118
  /**
1253
1119
  * 左眼袋的 XX 个点。
1254
1120
  */
1255
1121
  LeftEyeBags: Array<Point>
1256
-
1257
1122
  /**
1258
1123
  * 右眼袋的 XX 个点。
1259
1124
  */
1260
1125
  RightEyeBags: Array<Point>
1261
-
1262
1126
  /**
1263
1127
  * 额头的 XX 个点。
1264
1128
  */
@@ -1274,16 +1138,14 @@ export interface ResultsReturnsByGroup {
1274
1138
  * 检测出的人脸框位置。
1275
1139
  */
1276
1140
  FaceRect: FaceRect
1277
-
1278
1141
  /**
1279
1142
  * 识别结果。
1280
1143
  */
1281
1144
  GroupCandidates: Array<GroupCandidate>
1282
-
1283
1145
  /**
1284
- * 检测出的人脸图片状态返回码。0 表示正常。
1146
+ * 检测出的人脸图片状态返回码。0 表示正常。
1285
1147
  -1601代表不符合图片质量控制要求,此时Candidate内容为空。
1286
- */
1148
+ */
1287
1149
  RetCode: number
1288
1150
  }
1289
1151
 
@@ -1295,7 +1157,6 @@ export interface Point {
1295
1157
  * x坐标
1296
1158
  */
1297
1159
  X: number
1298
-
1299
1160
  /**
1300
1161
  * Y坐标
1301
1162
  */
@@ -1310,12 +1171,10 @@ export interface GetPersonListNumResponse {
1310
1171
  * 人员数量
1311
1172
  */
1312
1173
  PersonNum?: number
1313
-
1314
1174
  /**
1315
1175
  * 人脸数量
1316
1176
  */
1317
1177
  FaceNum?: number
1318
-
1319
1178
  /**
1320
1179
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1321
1180
  */
@@ -1330,7 +1189,6 @@ export interface DeletePersonFromGroupRequest {
1330
1189
  * 人员ID
1331
1190
  */
1332
1191
  PersonId: string
1333
-
1334
1192
  /**
1335
1193
  * 人员库ID
1336
1194
  */
@@ -1345,26 +1203,23 @@ export interface VerifyFaceRequest {
1345
1203
  * 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
1346
1204
  */
1347
1205
  PersonId: string
1348
-
1349
1206
  /**
1350
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1207
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1351
1208
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1352
1209
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1353
- */
1210
+ */
1354
1211
  Image?: string
1355
-
1356
1212
  /**
1357
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1213
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1358
1214
  Url、Image必须提供一个,如果都提供,只使用 Url。
1359
1215
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1360
1216
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1361
1217
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1362
1218
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1363
- */
1219
+ */
1364
1220
  Url?: string
1365
-
1366
1221
  /**
1367
- * 图片质量控制。
1222
+ * 图片质量控制。
1368
1223
  0: 不进行控制;
1369
1224
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1370
1225
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1372,9 +1227,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
1372
1227
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1373
1228
  默认 0。
1374
1229
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1375
- */
1230
+ */
1376
1231
  QualityControl?: number
1377
-
1378
1232
  /**
1379
1233
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1380
1234
  */
@@ -1389,25 +1243,21 @@ export interface GetPersonListResponse {
1389
1243
  * 返回的人员信息
1390
1244
  */
1391
1245
  PersonInfos?: Array<PersonInfo>
1392
-
1393
1246
  /**
1394
- * 该人员库的人员数量
1247
+ * 该人员库的人员数量
1395
1248
  注意:此字段可能返回 null,表示取不到有效值。
1396
- */
1249
+ */
1397
1250
  PersonNum?: number
1398
-
1399
1251
  /**
1400
- * 该人员库的人脸数量
1252
+ * 该人员库的人脸数量
1401
1253
  注意:此字段可能返回 null,表示取不到有效值。
1402
- */
1254
+ */
1403
1255
  FaceNum?: number
1404
-
1405
1256
  /**
1406
- * 人脸识别所用的算法模型版本。
1257
+ * 人脸识别所用的算法模型版本。
1407
1258
  注意:此字段可能返回 null,表示取不到有效值。
1408
- */
1259
+ */
1409
1260
  FaceModelVersion?: string
1410
-
1411
1261
  /**
1412
1262
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1413
1263
  */
@@ -1419,21 +1269,19 @@ export interface GetPersonListResponse {
1419
1269
  */
1420
1270
  export interface Hair {
1421
1271
  /**
1422
- * 头发长度信息。
1272
+ * 头发长度信息。
1423
1273
  AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
1424
- */
1274
+ */
1425
1275
  Length: AttributeItem
1426
-
1427
1276
  /**
1428
- * 刘海信息。
1277
+ * 刘海信息。
1429
1278
  AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
1430
- */
1279
+ */
1431
1280
  Bang: AttributeItem
1432
-
1433
1281
  /**
1434
- * 头发颜色信息。
1282
+ * 头发颜色信息。
1435
1283
  AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
1436
- */
1284
+ */
1437
1285
  Color: AttributeItem
1438
1286
  }
1439
1287
 
@@ -1445,16 +1293,14 @@ export interface Result {
1445
1293
  * 识别出的最相似候选人
1446
1294
  */
1447
1295
  Candidates: Array<Candidate>
1448
-
1449
1296
  /**
1450
1297
  * 检测出的人脸框位置
1451
1298
  */
1452
1299
  FaceRect: FaceRect
1453
-
1454
1300
  /**
1455
- * 检测出的人脸图片状态返回码。0 表示正常。
1301
+ * 检测出的人脸图片状态返回码。0 表示正常。
1456
1302
  -1601代表不符合图片质量控制要求,此时Candidate内容为空。
1457
- */
1303
+ */
1458
1304
  RetCode: number
1459
1305
  }
1460
1306
 
@@ -1466,19 +1312,16 @@ export interface GetPersonGroupInfoResponse {
1466
1312
  * 包含此人员的人员库及描述字段内容列表
1467
1313
  */
1468
1314
  PersonGroupInfos?: Array<PersonGroupInfo>
1469
-
1470
1315
  /**
1471
- * 人员库总数量
1316
+ * 人员库总数量
1472
1317
  注意:此字段可能返回 null,表示取不到有效值。
1473
- */
1318
+ */
1474
1319
  GroupNum?: number
1475
-
1476
1320
  /**
1477
- * 人脸识别服务所用的算法模型版本。
1321
+ * 人脸识别服务所用的算法模型版本。
1478
1322
  注意:此字段可能返回 null,表示取不到有效值。
1479
- */
1323
+ */
1480
1324
  FaceModelVersion?: string
1481
-
1482
1325
  /**
1483
1326
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1484
1327
  */
@@ -1493,7 +1336,6 @@ export interface UpgradeGroupFaceModelVersionResponse {
1493
1336
  * 升级任务ID,用于查询、获取升级的进度和结果。
1494
1337
  */
1495
1338
  JobId: string
1496
-
1497
1339
  /**
1498
1340
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1499
1341
  */
@@ -1508,47 +1350,40 @@ export interface SearchFacesReturnsByGroupRequest {
1508
1350
  * 希望搜索的人员库列表,上限60个。
1509
1351
  */
1510
1352
  GroupIds: Array<string>
1511
-
1512
1353
  /**
1513
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1354
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1514
1355
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1515
- */
1356
+ */
1516
1357
  Image?: string
1517
-
1518
1358
  /**
1519
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1359
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1520
1360
  Url、Image必须提供一个,如果都提供,只使用 Url。
1521
1361
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1522
1362
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1523
1363
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1524
- */
1364
+ */
1525
1365
  Url?: string
1526
-
1527
1366
  /**
1528
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1367
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1529
1368
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1530
1369
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1531
- */
1370
+ */
1532
1371
  MaxFaceNum?: number
1533
-
1534
1372
  /**
1535
1373
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
1536
1374
  */
1537
1375
  MinFaceSize?: number
1538
-
1539
1376
  /**
1540
- * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1377
+ * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1541
1378
  例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
1542
- */
1379
+ */
1543
1380
  MaxPersonNumPerGroup?: number
1544
-
1545
1381
  /**
1546
1382
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
1547
1383
  */
1548
1384
  NeedPersonInfo?: number
1549
-
1550
1385
  /**
1551
- * 图片质量控制。
1386
+ * 图片质量控制。
1552
1387
  0: 不进行控制;
1553
1388
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1554
1389
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1556,16 +1391,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1556
1391
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1557
1392
  默认 0。
1558
1393
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1559
- */
1394
+ */
1560
1395
  QualityControl?: number
1561
-
1562
1396
  /**
1563
- * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
1397
+ * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
1564
1398
  默认为0。
1565
1399
  取值范围[0.0,100.0) 。
1566
- */
1400
+ */
1567
1401
  FaceMatchThreshold?: number
1568
-
1569
1402
  /**
1570
1403
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1571
1404
  */
@@ -1580,22 +1413,18 @@ export interface AnalyzeDenseLandmarksResponse {
1580
1413
  * 请求的图片宽度。
1581
1414
  */
1582
1415
  ImageWidth?: number
1583
-
1584
1416
  /**
1585
1417
  * 请求的图片高度。
1586
1418
  */
1587
1419
  ImageHeight?: number
1588
-
1589
1420
  /**
1590
1421
  * 稠密人脸关键点具体信息。
1591
1422
  */
1592
1423
  DenseFaceShapeSet?: Array<DenseFaceShape>
1593
-
1594
1424
  /**
1595
1425
  * 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
1596
1426
  */
1597
1427
  FaceModelVersion?: string
1598
-
1599
1428
  /**
1600
1429
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1601
1430
  */
@@ -1620,12 +1449,10 @@ export interface ModifyPersonGroupInfoRequest {
1620
1449
  * 人员库ID
1621
1450
  */
1622
1451
  GroupId: string
1623
-
1624
1452
  /**
1625
1453
  * 人员ID
1626
1454
  */
1627
1455
  PersonId: string
1628
-
1629
1456
  /**
1630
1457
  * 需要修改的人员描述字段内容,key-value
1631
1458
  */
@@ -1647,45 +1474,40 @@ export interface RevertGroupFaceModelVersionRequest {
1647
1474
  */
1648
1475
  export interface FaceQualityCompleteness {
1649
1476
  /**
1650
- * 眉毛的遮挡分数[0,100],分数越高遮挡越少。
1477
+ * 眉毛的遮挡分数[0,100],分数越高遮挡越少。
1651
1478
  参考范围:[0,80]表示发生遮挡。
1652
1479
  注意:此字段可能返回 null,表示取不到有效值。
1653
- */
1480
+ */
1654
1481
  Eyebrow: number
1655
-
1656
1482
  /**
1657
- * 眼睛的遮挡分数[0,100],分数越高遮挡越少。
1483
+ * 眼睛的遮挡分数[0,100],分数越高遮挡越少。
1658
1484
  参考范围:[0,80]表示发生遮挡。
1659
1485
  注意:此字段可能返回 null,表示取不到有效值。
1660
- */
1486
+ */
1661
1487
  Eye: number
1662
-
1663
1488
  /**
1664
- * 鼻子的遮挡分数[0,100],分数越高遮挡越少。
1489
+ * 鼻子的遮挡分数[0,100],分数越高遮挡越少。
1665
1490
  参考范围:[0,60]表示发生遮挡。
1666
1491
  注意:此字段可能返回 null,表示取不到有效值。
1667
- */
1492
+ */
1668
1493
  Nose: number
1669
-
1670
1494
  /**
1671
- * 脸颊的遮挡分数[0,100],分数越高遮挡越少。
1495
+ * 脸颊的遮挡分数[0,100],分数越高遮挡越少。
1672
1496
  参考范围:[0,70]表示发生遮挡。
1673
1497
  注意:此字段可能返回 null,表示取不到有效值。
1674
- */
1498
+ */
1675
1499
  Cheek: number
1676
-
1677
1500
  /**
1678
- * 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
1501
+ * 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
1679
1502
  参考范围:[0,50]表示发生遮挡。
1680
1503
  注意:此字段可能返回 null,表示取不到有效值。
1681
- */
1504
+ */
1682
1505
  Mouth: number
1683
-
1684
1506
  /**
1685
- * 下巴的遮挡分数[0,100],分数越高遮挡越少。
1507
+ * 下巴的遮挡分数[0,100],分数越高遮挡越少。
1686
1508
  参考范围:[0,70]表示发生遮挡。
1687
1509
  注意:此字段可能返回 null,表示取不到有效值。
1688
- */
1510
+ */
1689
1511
  Chin: number
1690
1512
  }
1691
1513
 
@@ -1698,67 +1520,56 @@ export interface FaceAttributesInfo {
1698
1520
  * 性别[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1699
1521
  */
1700
1522
  Gender: number
1701
-
1702
1523
  /**
1703
1524
  * 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1704
1525
  */
1705
1526
  Age: number
1706
-
1707
1527
  /**
1708
1528
  * 微笑[0(normal,正常)~50(smile,微笑)~100(laugh,大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1709
1529
  */
1710
1530
  Expression: number
1711
-
1712
1531
  /**
1713
1532
  * 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1714
1533
  */
1715
1534
  Glass: boolean
1716
-
1717
1535
  /**
1718
- * 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1536
+ * 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1719
1537
  建议:人脸入库选择[-10,10]的图片。
1720
- */
1538
+ */
1721
1539
  Pitch: number
1722
-
1723
1540
  /**
1724
- * 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1541
+ * 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1725
1542
  建议:人脸入库选择[-10,10]的图片。
1726
- */
1543
+ */
1727
1544
  Yaw: number
1728
-
1729
1545
  /**
1730
- * 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1546
+ * 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1731
1547
  建议:人脸入库选择[-20,20]的图片。
1732
- */
1548
+ */
1733
1549
  Roll: number
1734
-
1735
1550
  /**
1736
1551
  * 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1737
1552
  */
1738
1553
  Beauty: number
1739
-
1740
1554
  /**
1741
- * 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1555
+ * 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1742
1556
  注意:此字段可能返回 null,表示取不到有效值。
1743
- */
1557
+ */
1744
1558
  Hat: boolean
1745
-
1746
1559
  /**
1747
- * 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1560
+ * 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1748
1561
  注意:此字段可能返回 null,表示取不到有效值。
1749
- */
1562
+ */
1750
1563
  Mask: boolean
1751
-
1752
1564
  /**
1753
- * 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1565
+ * 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1754
1566
  注意:此字段可能返回 null,表示取不到有效值。
1755
- */
1567
+ */
1756
1568
  Hair: FaceHairAttributesInfo
1757
-
1758
1569
  /**
1759
- * 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1570
+ * 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1760
1571
  注意:此字段可能返回 null,表示取不到有效值。
1761
- */
1572
+ */
1762
1573
  EyeOpen: boolean
1763
1574
  }
1764
1575
 
@@ -1770,25 +1581,22 @@ export interface VerifyPersonRequest {
1770
1581
  * 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
1771
1582
  */
1772
1583
  PersonId: string
1773
-
1774
1584
  /**
1775
- * 图片 base64 数据。
1585
+ * 图片 base64 数据。
1776
1586
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1777
1587
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1778
- */
1588
+ */
1779
1589
  Image?: string
1780
-
1781
1590
  /**
1782
- * 图片的 Url 。 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
1591
+ * 图片的 Url 。 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
1783
1592
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1784
1593
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1785
1594
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1786
1595
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1787
- */
1596
+ */
1788
1597
  Url?: string
1789
-
1790
1598
  /**
1791
- * 图片质量控制。
1599
+ * 图片质量控制。
1792
1600
  0: 不进行控制;
1793
1601
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1794
1602
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1796,9 +1604,8 @@ export interface VerifyPersonRequest {
1796
1604
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1797
1605
  默认 0。
1798
1606
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1799
- */
1607
+ */
1800
1608
  QualityControl?: number
1801
-
1802
1609
  /**
1803
1610
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1804
1611
  */
@@ -1813,12 +1620,10 @@ export interface ModifyPersonBaseInfoRequest {
1813
1620
  * 人员ID
1814
1621
  */
1815
1622
  PersonId: string
1816
-
1817
1623
  /**
1818
1624
  * 需要修改的人员名称
1819
1625
  */
1820
1626
  PersonName?: string
1821
-
1822
1627
  /**
1823
1628
  * 需要修改的人员性别
1824
1629
  */
@@ -1830,24 +1635,21 @@ export interface ModifyPersonBaseInfoRequest {
1830
1635
  */
1831
1636
  export interface VerifyFaceResponse {
1832
1637
  /**
1833
- * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
1638
+ * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
1834
1639
 
1835
1640
  不同算法版本返回的相似度分数不同。
1836
1641
  若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
1837
1642
  2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
1838
- */
1643
+ */
1839
1644
  Score: number
1840
-
1841
1645
  /**
1842
1646
  * 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
1843
1647
  */
1844
1648
  IsMatch: boolean
1845
-
1846
1649
  /**
1847
1650
  * 人脸识别所用的算法模型版本。
1848
1651
  */
1849
1652
  FaceModelVersion: string
1850
-
1851
1653
  /**
1852
1654
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1853
1655
  */
@@ -1862,14 +1664,13 @@ export interface FaceDetailInfo {
1862
1664
  * 检测出的人脸框位置。
1863
1665
  */
1864
1666
  FaceRect: FaceRect
1865
-
1866
1667
  /**
1867
- * 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
1668
+ * 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
1868
1669
  情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
1869
1670
  头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
1870
1671
  鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
1871
1672
  若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
1872
- */
1673
+ */
1873
1674
  FaceDetailAttributesInfo: FaceDetailAttributesInfo
1874
1675
  }
1875
1676
 
@@ -1881,48 +1682,41 @@ export interface SearchFacesRequest {
1881
1682
  * 希望搜索的人员库列表,上限100个。
1882
1683
  */
1883
1684
  GroupIds: Array<string>
1884
-
1885
1685
  /**
1886
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1686
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1887
1687
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1888
- */
1688
+ */
1889
1689
  Image?: string
1890
-
1891
1690
  /**
1892
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1691
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1893
1692
  Url、Image必须提供一个,如果都提供,只使用 Url。
1894
1693
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1895
1694
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1896
1695
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1897
- */
1696
+ */
1898
1697
  Url?: string
1899
-
1900
1698
  /**
1901
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1699
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1902
1700
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1903
1701
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1904
- */
1702
+ */
1905
1703
  MaxFaceNum?: number
1906
-
1907
1704
  /**
1908
1705
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
1909
1706
  */
1910
1707
  MinFaceSize?: number
1911
-
1912
1708
  /**
1913
- * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1709
+ * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1914
1710
  例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
1915
1711
  值越大,需要处理的时间越长。建议不要超过10。
1916
- */
1712
+ */
1917
1713
  MaxPersonNum?: number
1918
-
1919
1714
  /**
1920
1715
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
1921
1716
  */
1922
1717
  NeedPersonInfo?: number
1923
-
1924
1718
  /**
1925
- * 图片质量控制。
1719
+ * 图片质量控制。
1926
1720
  0: 不进行控制;
1927
1721
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1928
1722
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1930,14 +1724,12 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1930
1724
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1931
1725
  默认 0。
1932
1726
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1933
- */
1727
+ */
1934
1728
  QualityControl?: number
1935
-
1936
1729
  /**
1937
1730
  * 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
1938
1731
  */
1939
1732
  FaceMatchThreshold?: number
1940
-
1941
1733
  /**
1942
1734
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1943
1735
  */
@@ -1952,44 +1744,38 @@ export interface SearchPersonsRequest {
1952
1744
  * 希望搜索的人员库列表,上限100个。
1953
1745
  */
1954
1746
  GroupIds: Array<string>
1955
-
1956
1747
  /**
1957
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1748
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1958
1749
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1959
1750
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1960
- */
1751
+ */
1961
1752
  Image?: string
1962
-
1963
1753
  /**
1964
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1754
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1965
1755
  Url、Image必须提供一个,如果都提供,只使用 Url。
1966
1756
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1967
1757
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1968
1758
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1969
- */
1759
+ */
1970
1760
  Url?: string
1971
-
1972
1761
  /**
1973
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1762
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1974
1763
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1975
1764
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1976
- */
1765
+ */
1977
1766
  MaxFaceNum?: number
1978
-
1979
1767
  /**
1980
1768
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
1981
1769
  */
1982
1770
  MinFaceSize?: number
1983
-
1984
1771
  /**
1985
- * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1772
+ * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1986
1773
  例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
1987
1774
  值越大,需要处理的时间越长。建议不要超过10。
1988
- */
1775
+ */
1989
1776
  MaxPersonNum?: number
1990
-
1991
1777
  /**
1992
- * 图片质量控制。
1778
+ * 图片质量控制。
1993
1779
  0: 不进行控制;
1994
1780
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1995
1781
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1997,19 +1783,16 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1997
1783
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1998
1784
  默认 0。
1999
1785
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2000
- */
1786
+ */
2001
1787
  QualityControl?: number
2002
-
2003
1788
  /**
2004
1789
  * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
2005
1790
  */
2006
1791
  FaceMatchThreshold?: number
2007
-
2008
1792
  /**
2009
1793
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
2010
1794
  */
2011
1795
  NeedPersonInfo?: number
2012
-
2013
1796
  /**
2014
1797
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2015
1798
  */
@@ -2024,31 +1807,26 @@ export interface PersonInfo {
2024
1807
  * 人员名称
2025
1808
  */
2026
1809
  PersonName: string
2027
-
2028
1810
  /**
2029
1811
  * 人员Id
2030
1812
  */
2031
1813
  PersonId: string
2032
-
2033
1814
  /**
2034
1815
  * 人员性别
2035
1816
  */
2036
1817
  Gender: number
2037
-
2038
1818
  /**
2039
1819
  * 人员描述字段内容
2040
1820
  */
2041
1821
  PersonExDescriptions: Array<string>
2042
-
2043
1822
  /**
2044
1823
  * 包含的人脸照片列表
2045
1824
  */
2046
1825
  FaceIds: Array<string>
2047
-
2048
1826
  /**
2049
- * 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
1827
+ * 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2050
1828
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
2051
- */
1829
+ */
2052
1830
  CreationTimestamp: number
2053
1831
  }
2054
1832
 
@@ -2060,7 +1838,6 @@ export interface GroupExDescriptionInfo {
2060
1838
  * 人员库自定义描述字段Index,从0开始
2061
1839
  */
2062
1840
  GroupExDescriptionIndex: number
2063
-
2064
1841
  /**
2065
1842
  * 需要更新的人员库自定义描述字段内容
2066
1843
  */
@@ -2075,22 +1852,18 @@ export interface AnalyzeFaceResponse {
2075
1852
  * 请求的图片宽度。
2076
1853
  */
2077
1854
  ImageWidth: number
2078
-
2079
1855
  /**
2080
1856
  * 请求的图片高度。
2081
1857
  */
2082
1858
  ImageHeight: number
2083
-
2084
1859
  /**
2085
1860
  * 五官定位(人脸关键点)具体信息。
2086
1861
  */
2087
1862
  FaceShapeSet: Array<FaceShape>
2088
-
2089
1863
  /**
2090
1864
  * 人脸识别所用的算法模型版本。
2091
1865
  */
2092
1866
  FaceModelVersion: string
2093
-
2094
1867
  /**
2095
1868
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2096
1869
  */
@@ -2102,56 +1875,49 @@ export interface AnalyzeFaceResponse {
2102
1875
  */
2103
1876
  export interface DetectFaceRequest {
2104
1877
  /**
2105
- * 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
1878
+ * 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
2106
1879
  此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
2107
- */
1880
+ */
2108
1881
  MaxFaceNum?: number
2109
-
2110
1882
  /**
2111
- * 人脸长和宽的最小尺寸,单位为像素。
1883
+ * 人脸长和宽的最小尺寸,单位为像素。
2112
1884
  默认为34。建议不低于34。
2113
1885
  低于MinFaceSize值的人脸不会被检测。
2114
- */
1886
+ */
2115
1887
  MinFaceSize?: number
2116
-
2117
1888
  /**
2118
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1889
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
2119
1890
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2120
- */
1891
+ */
2121
1892
  Image?: string
2122
-
2123
1893
  /**
2124
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1894
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
2125
1895
  Url、Image必须提供一个,如果都提供,只使用 Url。
2126
1896
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2127
1897
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2128
1898
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2129
- */
1899
+ */
2130
1900
  Url?: string
2131
-
2132
1901
  /**
2133
- * 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
1902
+ * 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
2134
1903
  非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
2135
1904
  最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
2136
1905
  提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
2137
- */
1906
+ */
2138
1907
  NeedFaceAttributes?: number
2139
-
2140
1908
  /**
2141
- * 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
1909
+ * 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
2142
1910
  非 1 值均视为不进行质量检测。
2143
1911
  最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
2144
1912
  建议:人脸入库操作建议开启此功能。
2145
- */
1913
+ */
2146
1914
  NeedQualityDetection?: number
2147
-
2148
1915
  /**
2149
- * 人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。
1916
+ * 人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。
2150
1917
  2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
2151
1918
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
2152
- */
1919
+ */
2153
1920
  FaceModelVersion?: string
2154
-
2155
1921
  /**
2156
1922
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2157
1923
  */
@@ -2186,7 +1952,6 @@ export interface PersonExDescriptionInfo {
2186
1952
  * 人员描述字段Index,从0开始
2187
1953
  */
2188
1954
  PersonExDescriptionIndex: number
2189
-
2190
1955
  /**
2191
1956
  * 需要更新的人员描述字段内容
2192
1957
  */
@@ -2201,12 +1966,10 @@ export interface GetUpgradeGroupFaceModelVersionJobListResponse {
2201
1966
  * 人员库升级任务信息列表。
2202
1967
  */
2203
1968
  JobInfos?: Array<UpgradeJobInfo>
2204
-
2205
1969
  /**
2206
1970
  * 升级任务总数量。
2207
1971
  */
2208
1972
  JobNum?: number
2209
-
2210
1973
  /**
2211
1974
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2212
1975
  */
@@ -2221,12 +1984,10 @@ export interface HeadPose {
2221
1984
  * 上下偏移[-30,30]。
2222
1985
  */
2223
1986
  Pitch: number
2224
-
2225
1987
  /**
2226
1988
  * 左右偏移[-30,30]。
2227
1989
  */
2228
1990
  Yaw: number
2229
-
2230
1991
  /**
2231
1992
  * 平面旋转[-180,180]。
2232
1993
  */
@@ -2241,13 +2002,11 @@ export interface GetGroupListResponse {
2241
2002
  * 返回的人员库信息
2242
2003
  */
2243
2004
  GroupInfos: Array<GroupInfo>
2244
-
2245
2005
  /**
2246
- * 人员库总数量
2006
+ * 人员库总数量
2247
2007
  注意:此字段可能返回 null,表示取不到有效值。
2248
- */
2008
+ */
2249
2009
  GroupNum: number
2250
-
2251
2010
  /**
2252
2011
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2253
2012
  */
@@ -2259,46 +2018,41 @@ export interface GetGroupListResponse {
2259
2018
  */
2260
2019
  export interface DetectFaceAttributesRequest {
2261
2020
  /**
2262
- * 最多处理的人脸数目。
2021
+ * 最多处理的人脸数目。
2263
2022
  默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
2264
2023
  此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
2265
- */
2024
+ */
2266
2025
  MaxFaceNum?: number
2267
-
2268
2026
  /**
2269
- * 图片 base64 数据,base64 编码后大小不可超过5M。
2027
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
2270
2028
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2271
2029
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2272
- */
2030
+ */
2273
2031
  Image?: string
2274
-
2275
2032
  /**
2276
- * 图片的 Url 。
2033
+ * 图片的 Url 。
2277
2034
  对应图片 base64 编码后大小不可超过5M。
2278
2035
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2279
2036
  Url、Image必须提供一个,如果都提供,只使用 Url。
2280
2037
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2281
2038
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2282
2039
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2283
- */
2040
+ */
2284
2041
  Url?: string
2285
-
2286
2042
  /**
2287
- * 是否返回年龄、性别、情绪等属性。
2043
+ * 是否返回年龄、性别、情绪等属性。
2288
2044
  合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
2289
2045
  Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
2290
2046
  None为不需要返回。默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
2291
2047
  需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
2292
2048
  关于各属性的详细描述,参见下文出参。
2293
2049
  最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
2294
- */
2050
+ */
2295
2051
  FaceAttributesType?: string
2296
-
2297
2052
  /**
2298
2053
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2299
2054
  */
2300
2055
  NeedRotateDetection?: number
2301
-
2302
2056
  /**
2303
2057
  * 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
2304
2058
  */
@@ -2313,32 +2067,26 @@ export interface GetGroupInfoResponse {
2313
2067
  * 人员库名称
2314
2068
  */
2315
2069
  GroupName?: string
2316
-
2317
2070
  /**
2318
2071
  * 人员库ID
2319
2072
  */
2320
2073
  GroupId?: string
2321
-
2322
2074
  /**
2323
2075
  * 人员库自定义描述字段
2324
2076
  */
2325
2077
  GroupExDescriptions?: Array<string>
2326
-
2327
2078
  /**
2328
2079
  * 人员库信息备注
2329
2080
  */
2330
2081
  Tag?: string
2331
-
2332
2082
  /**
2333
2083
  * 人脸识别所用的算法模型版本。
2334
2084
  */
2335
2085
  FaceModelVersion?: string
2336
-
2337
2086
  /**
2338
2087
  * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2339
2088
  */
2340
2089
  CreationTimestamp?: number
2341
-
2342
2090
  /**
2343
2091
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2344
2092
  */
@@ -2350,19 +2098,17 @@ export interface GetGroupInfoResponse {
2350
2098
  */
2351
2099
  export interface CompareFaceResponse {
2352
2100
  /**
2353
- * 两张图片中人脸的相似度分数。
2101
+ * 两张图片中人脸的相似度分数。
2354
2102
  不同算法版本返回的相似度分数不同。
2355
2103
  若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
2356
2104
  2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
2357
2105
  若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
2358
- */
2106
+ */
2359
2107
  Score: number
2360
-
2361
2108
  /**
2362
2109
  * 人脸识别所用的算法模型版本。
2363
2110
  */
2364
2111
  FaceModelVersion: string
2365
-
2366
2112
  /**
2367
2113
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2368
2114
  */
@@ -2374,9 +2120,9 @@ export interface CompareFaceResponse {
2374
2120
  */
2375
2121
  export interface Mouth {
2376
2122
  /**
2377
- * 是否张嘴信息。
2123
+ * 是否张嘴信息。
2378
2124
  AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
2379
- */
2125
+ */
2380
2126
  MouthOpen: AttributeItem
2381
2127
  }
2382
2128
 
@@ -2408,42 +2154,34 @@ export interface FaceShape {
2408
2154
  * 描述脸型轮廓的 21 点。
2409
2155
  */
2410
2156
  FaceProfile: Array<Point>
2411
-
2412
2157
  /**
2413
2158
  * 描述左侧眼睛轮廓的 8 点。
2414
2159
  */
2415
2160
  LeftEye: Array<Point>
2416
-
2417
2161
  /**
2418
2162
  * 描述右侧眼睛轮廓的 8 点。
2419
2163
  */
2420
2164
  RightEye: Array<Point>
2421
-
2422
2165
  /**
2423
2166
  * 描述左侧眉毛轮廓的 8 点。
2424
2167
  */
2425
2168
  LeftEyeBrow: Array<Point>
2426
-
2427
2169
  /**
2428
2170
  * 描述右侧眉毛轮廓的 8 点。
2429
2171
  */
2430
2172
  RightEyeBrow: Array<Point>
2431
-
2432
2173
  /**
2433
2174
  * 描述嘴巴轮廓的 22 点。
2434
2175
  */
2435
2176
  Mouth: Array<Point>
2436
-
2437
2177
  /**
2438
2178
  * 描述鼻子轮廓的 13 点。
2439
2179
  */
2440
2180
  Nose: Array<Point>
2441
-
2442
2181
  /**
2443
2182
  * 左瞳孔轮廓的 1 个点。
2444
2183
  */
2445
2184
  LeftPupil: Array<Point>
2446
-
2447
2185
  /**
2448
2186
  * 右瞳孔轮廓的 1 个点。
2449
2187
  */
@@ -2455,41 +2193,37 @@ export interface FaceShape {
2455
2193
  */
2456
2194
  export interface CompareFaceRequest {
2457
2195
  /**
2458
- * A 图片 base64 数据,base64 编码后大小不可超过5M。
2196
+ * A 图片 base64 数据,base64 编码后大小不可超过5M。
2459
2197
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2460
2198
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2461
- */
2199
+ */
2462
2200
  ImageA?: string
2463
-
2464
2201
  /**
2465
- * B 图片 base64 数据,base64 编码后大小不可超过5M。
2202
+ * B 图片 base64 数据,base64 编码后大小不可超过5M。
2466
2203
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2467
2204
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2468
- */
2205
+ */
2469
2206
  ImageB?: string
2470
-
2471
2207
  /**
2472
- * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2208
+ * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2473
2209
  A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2474
2210
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2475
2211
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2476
2212
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2477
2213
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2478
- */
2214
+ */
2479
2215
  UrlA?: string
2480
-
2481
2216
  /**
2482
- * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2217
+ * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2483
2218
  B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2484
2219
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2485
2220
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2486
2221
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2487
2222
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2488
- */
2223
+ */
2489
2224
  UrlB?: string
2490
-
2491
2225
  /**
2492
- * 人脸识别服务所用的算法模型版本。
2226
+ * 人脸识别服务所用的算法模型版本。
2493
2227
 
2494
2228
  目前入参支持 “2.0”和“3.0“ 两个输入。
2495
2229
 
@@ -2498,11 +2232,10 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2498
2232
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
2499
2233
 
2500
2234
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
2501
- */
2235
+ */
2502
2236
  FaceModelVersion?: string
2503
-
2504
2237
  /**
2505
- * 图片质量控制。
2238
+ * 图片质量控制。
2506
2239
  0: 不进行控制;
2507
2240
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
2508
2241
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -2510,9 +2243,8 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2510
2243
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
2511
2244
  默认 0。
2512
2245
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2513
- */
2246
+ */
2514
2247
  QualityControl?: number
2515
-
2516
2248
  /**
2517
2249
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2518
2250
  */
@@ -2527,17 +2259,14 @@ export interface VerifyPersonResponse {
2527
2259
  * 给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸(Face),会融合多张人脸信息进行验证。
2528
2260
  */
2529
2261
  Score?: number
2530
-
2531
2262
  /**
2532
2263
  * 是否为同一人的判断。
2533
2264
  */
2534
2265
  IsMatch?: boolean
2535
-
2536
2266
  /**
2537
2267
  * 人脸识别所用的算法模型版本。
2538
2268
  */
2539
2269
  FaceModelVersion?: string
2540
-
2541
2270
  /**
2542
2271
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2543
2272
  */
@@ -2552,19 +2281,16 @@ export interface DetectFaceResponse {
2552
2281
  * 请求的图片宽度。
2553
2282
  */
2554
2283
  ImageWidth: number
2555
-
2556
2284
  /**
2557
2285
  * 请求的图片高度。
2558
2286
  */
2559
2287
  ImageHeight: number
2560
-
2561
2288
  /**
2562
2289
  * 人脸信息列表。包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
2563
2290
  */
2564
2291
  FaceInfos: Array<FaceInfo>
2565
-
2566
2292
  /**
2567
- * 人脸识别服务所用的算法模型版本。
2293
+ * 人脸识别服务所用的算法模型版本。
2568
2294
 
2569
2295
  目前入参支持 “2.0”和“3.0“ 两个输入。
2570
2296
 
@@ -2573,9 +2299,8 @@ export interface DetectFaceResponse {
2573
2299
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
2574
2300
 
2575
2301
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
2576
- */
2302
+ */
2577
2303
  FaceModelVersion: string
2578
-
2579
2304
  /**
2580
2305
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2581
2306
  */
@@ -2610,30 +2335,25 @@ export interface UpgradeJobInfo {
2610
2335
  * 人员库升级任务ID,用于查询、获取升级的进度和结果。
2611
2336
  */
2612
2337
  JobId: string
2613
-
2614
2338
  /**
2615
2339
  * 人员库ID。
2616
2340
  */
2617
2341
  GroupId: string
2618
-
2619
2342
  /**
2620
2343
  * 当前算法模型版本。
2621
2344
  */
2622
2345
  FromFaceModelVersion: string
2623
-
2624
2346
  /**
2625
2347
  * 目标算法模型版本。
2626
2348
  */
2627
2349
  ToFaceModelVersion: string
2628
-
2629
2350
  /**
2630
- * 升级起始时间。
2351
+ * 升级起始时间。
2631
2352
  StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2632
2353
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
2633
2354
  有关更多信息,请参阅 Unix 时间。
2634
- */
2355
+ */
2635
2356
  StartTime: number
2636
-
2637
2357
  /**
2638
2358
  * 0表示升级中,1表示升级完毕,2表示回滚完毕。
2639
2359
  */
@@ -2658,12 +2378,10 @@ export interface GetPersonListRequest {
2658
2378
  * 人员库ID
2659
2379
  */
2660
2380
  GroupId: string
2661
-
2662
2381
  /**
2663
2382
  * 起始序号,默认值为0
2664
2383
  */
2665
2384
  Offset?: number
2666
-
2667
2385
  /**
2668
2386
  * 返回数量,默认值为10,最大值为1000
2669
2387
  */
@@ -2679,106 +2397,91 @@ export interface GetPersonListRequest {
2679
2397
  */
2680
2398
  export interface FaceDetailAttributesInfo {
2681
2399
  /**
2682
- * 年龄 [0,65],其中65代表“65岁及以上”。
2400
+ * 年龄 [0,65],其中65代表“65岁及以上”。
2683
2401
  FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2684
- */
2402
+ */
2685
2403
  Age: number
2686
-
2687
2404
  /**
2688
- * 美丑打分[0,100]。
2405
+ * 美丑打分[0,100]。
2689
2406
  FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2690
- */
2407
+ */
2691
2408
  Beauty: number
2692
-
2693
2409
  /**
2694
- * 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
2410
+ * 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
2695
2411
  AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
2696
2412
  FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2697
- */
2413
+ */
2698
2414
  Emotion: AttributeItem
2699
-
2700
2415
  /**
2701
- * 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
2416
+ * 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
2702
2417
  FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2703
- */
2418
+ */
2704
2419
  Eye: Eye
2705
-
2706
2420
  /**
2707
- * 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
2421
+ * 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
2708
2422
  FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2709
- */
2423
+ */
2710
2424
  Eyebrow: Eyebrow
2711
-
2712
2425
  /**
2713
- * 性别信息。
2426
+ * 性别信息。
2714
2427
  AttributeItem对应的Type为 —— 0:男性,1:女性。
2715
2428
  FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2716
- */
2429
+ */
2717
2430
  Gender: AttributeItem
2718
-
2719
2431
  /**
2720
- * 头发信息,包含头发长度、有无刘海、头发颜色。
2432
+ * 头发信息,包含头发长度、有无刘海、头发颜色。
2721
2433
  FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2722
- */
2434
+ */
2723
2435
  Hair: Hair
2724
-
2725
2436
  /**
2726
- * 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
2437
+ * 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
2727
2438
  FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2728
- */
2439
+ */
2729
2440
  Hat: Hat
2730
-
2731
2441
  /**
2732
- * 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
2442
+ * 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
2733
2443
  FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2734
- */
2444
+ */
2735
2445
  HeadPose: HeadPose
2736
-
2737
2446
  /**
2738
- * 口罩佩戴信息。
2447
+ * 口罩佩戴信息。
2739
2448
  AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
2740
2449
  FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2741
- */
2450
+ */
2742
2451
  Mask: AttributeItem
2743
-
2744
2452
  /**
2745
- * 嘴巴信息,可识别是否张嘴、嘴唇厚度。
2453
+ * 嘴巴信息,可识别是否张嘴、嘴唇厚度。
2746
2454
  FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2747
- */
2455
+ */
2748
2456
  Mouth: Mouth
2749
-
2750
2457
  /**
2751
- * 胡子信息。
2458
+ * 胡子信息。
2752
2459
  AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
2753
2460
  FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2754
- */
2461
+ */
2755
2462
  Moustache: AttributeItem
2756
-
2757
2463
  /**
2758
- * 鼻子信息。
2464
+ * 鼻子信息。
2759
2465
  AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
2760
2466
  FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2761
- */
2467
+ */
2762
2468
  Nose: AttributeItem
2763
-
2764
2469
  /**
2765
- * 脸型信息。
2470
+ * 脸型信息。
2766
2471
  AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
2767
2472
  FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2768
- */
2473
+ */
2769
2474
  Shape: AttributeItem
2770
-
2771
2475
  /**
2772
- * 肤色信息。
2476
+ * 肤色信息。
2773
2477
  AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
2774
2478
  FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2775
- */
2479
+ */
2776
2480
  Skin: AttributeItem
2777
-
2778
2481
  /**
2779
- * 微笑程度,[0,100]。
2482
+ * 微笑程度,[0,100]。
2780
2483
  FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2781
- */
2484
+ */
2782
2485
  Smile: number
2783
2486
  }
2784
2487
 
@@ -2790,7 +2493,6 @@ export interface AttributeItem {
2790
2493
  * 属性值
2791
2494
  */
2792
2495
  Type: number
2793
-
2794
2496
  /**
2795
2497
  * Type识别概率值,【0,1】,代表判断正确的概率。
2796
2498
  */
@@ -2802,24 +2504,21 @@ export interface AttributeItem {
2802
2504
  */
2803
2505
  export interface FaceRect {
2804
2506
  /**
2805
- * 人脸框左上角横坐标。
2507
+ * 人脸框左上角横坐标。
2806
2508
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
2807
2509
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
2808
- */
2510
+ */
2809
2511
  X: number
2810
-
2811
2512
  /**
2812
- * 人脸框左上角纵坐标。
2513
+ * 人脸框左上角纵坐标。
2813
2514
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
2814
2515
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
2815
- */
2516
+ */
2816
2517
  Y: number
2817
-
2818
2518
  /**
2819
2519
  * 人脸宽度
2820
2520
  */
2821
2521
  Width: number
2822
-
2823
2522
  /**
2824
2523
  * 人脸高度
2825
2524
  */
@@ -2844,7 +2543,6 @@ export interface CreateGroupResponse {
2844
2543
  * 人脸识别所用的算法模型版本。
2845
2544
  */
2846
2545
  FaceModelVersion: string
2847
-
2848
2546
  /**
2849
2547
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2850
2548
  */