tencentcloud-sdk-nodejs-iai 4.0.618 → 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,46 +166,39 @@ export interface CreatePersonRequest {
183
166
  * 待加入的人员库ID,取值为创建人员库接口中的GroupId
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
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
210
188
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
211
- */
189
+ */
212
190
  Image?: string
213
-
214
191
  /**
215
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
192
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
216
193
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
217
194
  Url、Image必须提供一个,如果都提供,只使用 Url。
218
195
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
219
196
  非腾讯云存储的Url速度和稳定性可能受一定影响。
220
197
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
221
- */
198
+ */
222
199
  Url?: string
223
-
224
200
  /**
225
- * 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
201
+ * 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
226
202
  如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
227
203
  如果判断没有,则完成创建人员。
228
204
  0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
@@ -232,11 +208,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
232
208
  4: 很高的同一人判断要求(十万一误识别率)。
233
209
  默认 0。
234
210
  注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
235
- */
211
+ */
236
212
  UniquePersonControl?: number
237
-
238
213
  /**
239
- * 图片质量控制。
214
+ * 图片质量控制。
240
215
  0: 不进行控制;
241
216
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
242
217
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -244,9 +219,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
244
219
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
245
220
  默认 0。
246
221
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
247
- */
222
+ */
248
223
  QualityControl?: number
249
-
250
224
  /**
251
225
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
252
226
  */
@@ -261,36 +235,30 @@ export interface CreateFaceResponse {
261
235
  * 加入成功的人脸数量
262
236
  */
263
237
  SucFaceNum: number
264
-
265
238
  /**
266
239
  * 加入成功的人脸ID列表
267
240
  */
268
241
  SucFaceIds: Array<string>
269
-
270
242
  /**
271
- * 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
243
+ * 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
272
244
  -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
273
245
  其他非 0 值代表算法服务异常。
274
246
  RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
275
- */
247
+ */
276
248
  RetCode: Array<number>
277
-
278
249
  /**
279
- * 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
250
+ * 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
280
251
  例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
281
- */
252
+ */
282
253
  SucIndexes: Array<number>
283
-
284
254
  /**
285
255
  * 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
286
256
  */
287
257
  SucFaceRects: Array<FaceRect>
288
-
289
258
  /**
290
259
  * 人脸识别所用的算法模型版本。
291
260
  */
292
261
  FaceModelVersion: string
293
-
294
262
  /**
295
263
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
296
264
  */
@@ -302,21 +270,19 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
302
270
  */
303
271
  export interface FaceHairAttributesInfo {
304
272
  /**
305
- * 0:光头,1:短发,2:中发,3:长发,4:绑发
273
+ * 0:光头,1:短发,2:中发,3:长发,4:绑发
306
274
  注意:此字段可能返回 null,表示取不到有效值。
307
- */
275
+ */
308
276
  Length: number
309
-
310
277
  /**
311
- * 0:有刘海,1:无刘海
278
+ * 0:有刘海,1:无刘海
312
279
  注意:此字段可能返回 null,表示取不到有效值。
313
- */
280
+ */
314
281
  Bang: number
315
-
316
282
  /**
317
- * 0:黑色,1:金色,2:棕色,3:灰白色
283
+ * 0:黑色,1:金色,2:棕色,3:灰白色
318
284
  注意:此字段可能返回 null,表示取不到有效值。
319
- */
285
+ */
320
286
  Color: number
321
287
  }
322
288
 
@@ -328,18 +294,16 @@ export interface CreateFaceRequest {
328
294
  * 人员ID,取值为创建人员接口中的PersonId
329
295
  */
330
296
  PersonId: string
331
-
332
297
  /**
333
- * 图片 base64 数据,base64 编码后大小不可超过5M。
298
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
334
299
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
335
300
  人员人脸总数量不可超过5张。
336
301
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
337
302
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
338
- */
303
+ */
339
304
  Images?: Array<string>
340
-
341
305
  /**
342
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
306
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
343
307
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
344
308
  Url、Image必须提供一个,如果都提供,只使用 Url。
345
309
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
@@ -347,17 +311,15 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
347
311
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
348
312
  人员人脸总数量不可超过5张。
349
313
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
350
- */
314
+ */
351
315
  Urls?: Array<string>
352
-
353
316
  /**
354
- * 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
317
+ * 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
355
318
  默认值60分。取值范围[0,100] 。
356
- */
319
+ */
357
320
  FaceMatchThreshold?: number
358
-
359
321
  /**
360
- * 图片质量控制。
322
+ * 图片质量控制。
361
323
  0: 不进行控制;
362
324
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
363
325
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -365,9 +327,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
365
327
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
366
328
  默认 0。
367
329
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
368
- */
330
+ */
369
331
  QualityControl?: number
370
-
371
332
  /**
372
333
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
373
334
  */
@@ -382,30 +343,26 @@ export interface CreateGroupRequest {
382
343
  * 人员库名称,[1,60]个字符,可修改,不可重复。
383
344
  */
384
345
  GroupName: string
385
-
386
346
  /**
387
347
  * 人员库 ID,不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
388
348
  */
389
349
  GroupId: string
390
-
391
350
  /**
392
- * 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
351
+ * 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
393
352
  最多可以创建5个。
394
353
  每个自定义描述字段支持[1,30]个字符。
395
354
  在同一人员库中自定义描述字段不可重复。
396
355
  例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
397
356
  则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
398
357
  可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
399
- */
358
+ */
400
359
  GroupExDescriptions?: Array<string>
401
-
402
360
  /**
403
361
  * 人员库信息备注,[0,40]个字符。
404
362
  */
405
363
  Tag?: string
406
-
407
364
  /**
408
- * 人脸识别服务所用的算法模型版本。
365
+ * 人脸识别服务所用的算法模型版本。
409
366
 
410
367
  目前入参支持 “2.0”和“3.0“ 两个输入。
411
368
 
@@ -414,7 +371,7 @@ export interface CreateGroupRequest {
414
371
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
415
372
 
416
373
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
417
- */
374
+ */
418
375
  FaceModelVersion?: string
419
376
  }
420
377
 
@@ -426,12 +383,10 @@ export interface GetPersonGroupInfoRequest {
426
383
  * 人员ID,取值为创建人员接口中的PersonId
427
384
  */
428
385
  PersonId: string
429
-
430
386
  /**
431
387
  * 起始序号,默认值为0
432
388
  */
433
389
  Offset?: number
434
-
435
390
  /**
436
391
  * 返回数量,默认值为10,最大值为100
437
392
  */
@@ -443,39 +398,34 @@ export interface GetPersonGroupInfoRequest {
443
398
  */
444
399
  export interface FaceInfo {
445
400
  /**
446
- * 人脸框左上角横坐标。
401
+ * 人脸框左上角横坐标。
447
402
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
448
403
  若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
449
- */
404
+ */
450
405
  X: number
451
-
452
406
  /**
453
- * 人脸框左上角纵坐标。
407
+ * 人脸框左上角纵坐标。
454
408
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
455
409
  若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
456
- */
410
+ */
457
411
  Y: number
458
-
459
412
  /**
460
413
  * 人脸框宽度。
461
414
  */
462
415
  Width: number
463
-
464
416
  /**
465
417
  * 人脸框高度。
466
418
  */
467
419
  Height: number
468
-
469
420
  /**
470
- * 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
421
+ * 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
471
422
  魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
472
- */
423
+ */
473
424
  FaceAttributesInfo: FaceAttributesInfo
474
-
475
425
  /**
476
- * 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
426
+ * 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
477
427
  注意:此字段可能返回 null,表示取不到有效值。
478
- */
428
+ */
479
429
  FaceQualityInfo: FaceQualityInfo
480
430
  }
481
431
 
@@ -484,21 +434,19 @@ export interface FaceInfo {
484
434
  */
485
435
  export interface Eyebrow {
486
436
  /**
487
- * 眉毛浓密。
437
+ * 眉毛浓密。
488
438
  AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
489
- */
439
+ */
490
440
  EyebrowDensity: AttributeItem
491
-
492
441
  /**
493
- * 眉毛弯曲。
442
+ * 眉毛弯曲。
494
443
  AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
495
- */
444
+ */
496
445
  EyebrowCurve: AttributeItem
497
-
498
446
  /**
499
- * 眉毛长短。
447
+ * 眉毛长短。
500
448
  AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
501
- */
449
+ */
502
450
  EyebrowLength: AttributeItem
503
451
  }
504
452
 
@@ -507,34 +455,30 @@ AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
507
455
  */
508
456
  export interface AnalyzeDenseLandmarksRequest {
509
457
  /**
510
- * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
458
+ * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
511
459
  默认为 0。
512
460
  最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
513
- */
461
+ */
514
462
  Mode?: number
515
-
516
463
  /**
517
- * 图片 base64 数据,base64 编码后大小不可超过5M。
464
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
518
465
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
519
466
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
520
- */
467
+ */
521
468
  Image?: string
522
-
523
469
  /**
524
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
470
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
525
471
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
526
472
  Url、Image必须提供一个,如果都提供,只使用 Url。
527
473
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
528
474
  非腾讯云存储的Url速度和稳定性可能受一定影响。
529
475
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
530
- */
476
+ */
531
477
  Url?: string
532
-
533
478
  /**
534
479
  * 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
535
480
  */
536
481
  FaceModelVersion?: string
537
-
538
482
  /**
539
483
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
540
484
  */
@@ -549,7 +493,6 @@ export interface GetGroupListRequest {
549
493
  * 起始序号,默认值为0
550
494
  */
551
495
  Offset?: number
552
-
553
496
  /**
554
497
  * 返回数量,默认值为10,最大值为1000
555
498
  */
@@ -564,7 +507,6 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
564
507
  * 起始序号,默认值为0。
565
508
  */
566
509
  Offset?: number
567
-
568
510
  /**
569
511
  * 返回数量,默认值为10,最大值为1000。
570
512
  */
@@ -576,50 +518,42 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
576
518
  */
577
519
  export interface GetUpgradeGroupFaceModelVersionResultResponse {
578
520
  /**
579
- * 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
521
+ * 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
580
522
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
581
523
  如果为0表示这个任务已经执行完毕。
582
- */
524
+ */
583
525
  EndTimestamp: number
584
-
585
526
  /**
586
527
  * 升级任务完成进度。取值[0.0,100.0]。
587
528
  */
588
529
  Progress: number
589
-
590
530
  /**
591
531
  * 0表示升级中,1表示升级完毕,2表示回滚完毕,3表示升级失败。
592
532
  */
593
533
  Status: number
594
-
595
534
  /**
596
- * 升级起始时间。
535
+ * 升级起始时间。
597
536
  StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
598
537
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
599
538
  有关更多信息,请参阅 Unix 时间。
600
- */
539
+ */
601
540
  StartTime: number
602
-
603
541
  /**
604
542
  * 当前算法模型版本。
605
543
  */
606
544
  FromFaceModelVersion: string
607
-
608
545
  /**
609
546
  * 目标算法模型版本。
610
547
  */
611
548
  ToFaceModelVersion: string
612
-
613
549
  /**
614
550
  * 人员库ID。
615
551
  */
616
552
  GroupId: string
617
-
618
553
  /**
619
554
  * 无法升级的人脸Id信息,文件格式为json。内容参见下方示例。url有效期为半小时。
620
555
  */
621
556
  FailedFacesUrl: string
622
-
623
557
  /**
624
558
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
625
559
  */
@@ -634,12 +568,10 @@ export interface DetectLiveFaceAccurateResponse {
634
568
  * 活体打分,取值范围 [0,100],根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
635
569
  */
636
570
  Score: number
637
-
638
571
  /**
639
572
  * 人脸识别所用的算法模型版本。
640
573
  */
641
574
  FaceModelVersion: string
642
-
643
575
  /**
644
576
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
645
577
  */
@@ -654,26 +586,23 @@ export interface AnalyzeFaceRequest {
654
586
  * 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
655
587
  */
656
588
  Mode?: number
657
-
658
589
  /**
659
- * 图片 base64 数据,base64 编码后大小不可超过5M。
590
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
660
591
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
661
592
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
662
- */
593
+ */
663
594
  Image?: string
664
-
665
595
  /**
666
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
596
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
667
597
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
668
598
  Url、Image必须提供一个,如果都提供,只使用 Url。
669
599
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
670
600
  非腾讯云存储的Url速度和稳定性可能受一定影响。
671
601
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
672
- */
602
+ */
673
603
  Url?: string
674
-
675
604
  /**
676
- * 人脸识别服务所用的算法模型版本。
605
+ * 人脸识别服务所用的算法模型版本。
677
606
 
678
607
  目前入参支持 “2.0”和“3.0“ 两个输入。
679
608
 
@@ -682,9 +611,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
682
611
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
683
612
 
684
613
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
685
- */
614
+ */
686
615
  FaceModelVersion?: string
687
-
688
616
  /**
689
617
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
690
618
  */
@@ -699,24 +627,20 @@ export interface CreatePersonResponse {
699
627
  * 人脸图片唯一标识。
700
628
  */
701
629
  FaceId: string
702
-
703
630
  /**
704
- * 检测出的人脸框的位置。
631
+ * 检测出的人脸框的位置。
705
632
  注意:此字段可能返回 null,表示取不到有效值。
706
- */
633
+ */
707
634
  FaceRect: FaceRect
708
-
709
635
  /**
710
- * 疑似同一人的PersonId。
636
+ * 疑似同一人的PersonId。
711
637
  当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
712
- */
638
+ */
713
639
  SimilarPersonId: string
714
-
715
640
  /**
716
641
  * 人脸识别所用的算法模型版本。
717
642
  */
718
643
  FaceModelVersion: string
719
-
720
644
  /**
721
645
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
722
646
  */
@@ -731,17 +655,14 @@ export interface SearchFacesResponse {
731
655
  * 识别结果。
732
656
  */
733
657
  Results: Array<Result>
734
-
735
658
  /**
736
659
  * 搜索的人员库中包含的人脸数。
737
660
  */
738
661
  FaceNum: number
739
-
740
662
  /**
741
663
  * 人脸识别所用的算法模型版本。
742
664
  */
743
665
  FaceModelVersion: string
744
-
745
666
  /**
746
667
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
747
668
  */
@@ -756,12 +677,10 @@ export interface CopyPersonResponse {
756
677
  * 成功加入的人员库数量
757
678
  */
758
679
  SucGroupNum?: number
759
-
760
680
  /**
761
681
  * 成功加入的人员库列表
762
682
  */
763
683
  SucGroupIds?: Array<string>
764
-
765
684
  /**
766
685
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
767
686
  */
@@ -776,7 +695,6 @@ export interface GroupCandidate {
776
695
  * 人员库ID 。
777
696
  */
778
697
  GroupId: string
779
-
780
698
  /**
781
699
  * 识别出的最相似候选人。
782
700
  */
@@ -791,12 +709,10 @@ export interface DeleteFaceResponse {
791
709
  * 删除成功的人脸数量
792
710
  */
793
711
  SucDeletedNum?: number
794
-
795
712
  /**
796
713
  * 删除成功的人脸ID列表
797
714
  */
798
715
  SucFaceIds?: Array<string>
799
-
800
716
  /**
801
717
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
802
718
  */
@@ -818,22 +734,19 @@ export interface DeletePersonRequest {
818
734
  */
819
735
  export interface DetectLiveFaceResponse {
820
736
  /**
821
- * 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
737
+ * 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
822
738
  本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
823
- */
739
+ */
824
740
  Score: number
825
-
826
741
  /**
827
742
  * 人脸识别所用的算法模型版本。
828
743
  */
829
744
  FaceModelVersion: string
830
-
831
745
  /**
832
- * 活体检测是否通过。
746
+ * 活体检测是否通过。
833
747
  本字段只有FaceModelVersion为3.0时才具备参考意义。
834
- */
748
+ */
835
749
  IsLiveness: boolean
836
-
837
750
  /**
838
751
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
839
752
  */
@@ -848,7 +761,6 @@ export interface DeleteFaceRequest {
848
761
  * 人员ID,取值为创建人员接口中的PersonId
849
762
  */
850
763
  PersonId: string
851
-
852
764
  /**
853
765
  * 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId
854
766
  */
@@ -863,17 +775,14 @@ export interface ModifyGroupRequest {
863
775
  * 人员库ID,取值为创建人员库接口中的GroupId
864
776
  */
865
777
  GroupId: string
866
-
867
778
  /**
868
779
  * 人员库名称
869
780
  */
870
781
  GroupName?: string
871
-
872
782
  /**
873
783
  * 需要修改的人员库自定义描述字段,key-value
874
784
  */
875
785
  GroupExDescriptionInfos?: Array<GroupExDescriptionInfo>
876
-
877
786
  /**
878
787
  * 人员库信息备注
879
788
  */
@@ -898,7 +807,6 @@ export interface UpgradeGroupFaceModelVersionRequest {
898
807
  * 需要升级的人员库ID。
899
808
  */
900
809
  GroupId: string
901
-
902
810
  /**
903
811
  * 需要升级至的算法模型版本。默认为最新版本。不可逆向升级
904
812
  */
@@ -910,25 +818,23 @@ export interface UpgradeGroupFaceModelVersionRequest {
910
818
  */
911
819
  export interface DetectLiveFaceRequest {
912
820
  /**
913
- * 图片 base64 数据,base64 编码后大小不可超过5M。
821
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
914
822
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
915
823
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
916
- */
824
+ */
917
825
  Image?: string
918
-
919
826
  /**
920
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
827
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
921
828
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
922
829
  Url、Image必须提供一个,如果都提供,只使用 Url。
923
830
  (图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
924
831
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
925
832
  非腾讯云存储的Url速度和稳定性可能受一定影响。
926
833
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
927
- */
834
+ */
928
835
  Url?: string
929
-
930
836
  /**
931
- * 人脸识别服务所用的算法模型版本。
837
+ * 人脸识别服务所用的算法模型版本。
932
838
 
933
839
  目前入参支持 “2.0”和“3.0“ 两个输入。
934
840
 
@@ -937,7 +843,7 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
937
843
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
938
844
 
939
845
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
940
- */
846
+ */
941
847
  FaceModelVersion?: string
942
848
  }
943
849
 
@@ -949,17 +855,14 @@ export interface GetPersonBaseInfoResponse {
949
855
  * 人员名称
950
856
  */
951
857
  PersonName?: string
952
-
953
858
  /**
954
859
  * 人员性别,0代表未填写,1代表男性,2代表女性
955
860
  */
956
861
  Gender?: number
957
-
958
862
  /**
959
863
  * 包含的人脸 ID 列表
960
864
  */
961
865
  FaceIds?: Array<string>
962
-
963
866
  /**
964
867
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
965
868
  */
@@ -974,18 +877,15 @@ export interface SearchPersonsResponse {
974
877
  * 识别结果。
975
878
  */
976
879
  Results: Array<Result>
977
-
978
880
  /**
979
881
  * 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求,则返回0。
980
882
  */
981
883
  PersonNum: number
982
-
983
884
  /**
984
- * 人脸识别所用的算法模型版本。
885
+ * 人脸识别所用的算法模型版本。
985
886
  注意:此字段可能返回 null,表示取不到有效值。
986
- */
887
+ */
987
888
  FaceModelVersion: string
988
-
989
889
  /**
990
890
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
991
891
  */
@@ -1010,35 +910,30 @@ export interface GroupInfo {
1010
910
  * 人员库名称
1011
911
  */
1012
912
  GroupName: string
1013
-
1014
913
  /**
1015
914
  * 人员库ID
1016
915
  */
1017
916
  GroupId: string
1018
-
1019
917
  /**
1020
- * 人员库自定义描述字段
918
+ * 人员库自定义描述字段
1021
919
  注意:此字段可能返回 null,表示取不到有效值。
1022
- */
920
+ */
1023
921
  GroupExDescriptions: Array<string>
1024
-
1025
922
  /**
1026
- * 人员库信息备注
923
+ * 人员库信息备注
1027
924
  注意:此字段可能返回 null,表示取不到有效值。
1028
- */
925
+ */
1029
926
  Tag: string
1030
-
1031
927
  /**
1032
- * 人脸识别所用的算法模型版本。
928
+ * 人脸识别所用的算法模型版本。
1033
929
  注意:此字段可能返回 null,表示取不到有效值。
1034
- */
930
+ */
1035
931
  FaceModelVersion: string
1036
-
1037
932
  /**
1038
- * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
933
+ * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
1039
934
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
1040
935
  注意:此字段可能返回 null,表示取不到有效值。
1041
- */
936
+ */
1042
937
  CreationTimestamp: number
1043
938
  }
1044
939
 
@@ -1047,34 +942,31 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
1047
942
  */
1048
943
  export interface FaceQualityInfo {
1049
944
  /**
1050
- * 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
945
+ * 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
1051
946
  正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
1052
947
  参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
1053
948
  建议:人脸入库选取70以上的图片。
1054
949
  注意:此字段可能返回 null,表示取不到有效值。
1055
- */
950
+ */
1056
951
  Score: number
1057
-
1058
952
  /**
1059
- * 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
953
+ * 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
1060
954
  参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
1061
955
  建议:人脸入库选取80以上的图片。
1062
956
  注意:此字段可能返回 null,表示取不到有效值。
1063
- */
957
+ */
1064
958
  Sharpness: number
1065
-
1066
959
  /**
1067
- * 光照分:[0,100],评价图片光照程度,分数越高越亮。
960
+ * 光照分:[0,100],评价图片光照程度,分数越高越亮。
1068
961
  参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
1069
962
  建议:人脸入库选取[30,70]的图片。
1070
963
  注意:此字段可能返回 null,表示取不到有效值。
1071
- */
964
+ */
1072
965
  Brightness: number
1073
-
1074
966
  /**
1075
- * 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
967
+ * 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
1076
968
  注意:此字段可能返回 null,表示取不到有效值。
1077
- */
969
+ */
1078
970
  Completeness: FaceQualityCompleteness
1079
971
  }
1080
972
 
@@ -1086,17 +978,14 @@ export interface SearchFacesReturnsByGroupResponse {
1086
978
  * 搜索的人员库中包含的人脸数。
1087
979
  */
1088
980
  FaceNum: number
1089
-
1090
981
  /**
1091
982
  * 识别结果。
1092
983
  */
1093
984
  ResultsReturnsByGroup: Array<ResultsReturnsByGroup>
1094
-
1095
985
  /**
1096
986
  * 人脸识别所用的算法模型版本。
1097
987
  */
1098
988
  FaceModelVersion: string
1099
-
1100
989
  /**
1101
990
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1102
991
  */
@@ -1111,7 +1000,6 @@ export interface CopyPersonRequest {
1111
1000
  * 人员ID,取值为创建人员接口中的PersonId
1112
1001
  */
1113
1002
  PersonId: string
1114
-
1115
1003
  /**
1116
1004
  * 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId
1117
1005
  */
@@ -1126,44 +1014,38 @@ export interface SearchPersonsReturnsByGroupRequest {
1126
1014
  * 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId
1127
1015
  */
1128
1016
  GroupIds: Array<string>
1129
-
1130
1017
  /**
1131
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1018
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1132
1019
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1133
1020
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1134
- */
1021
+ */
1135
1022
  Image?: string
1136
-
1137
1023
  /**
1138
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1024
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1139
1025
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1140
1026
  Url、Image必须提供一个,如果都提供,只使用 Url。
1141
1027
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1142
1028
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1143
1029
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1144
- */
1030
+ */
1145
1031
  Url?: string
1146
-
1147
1032
  /**
1148
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1033
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1149
1034
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1150
1035
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1151
- */
1036
+ */
1152
1037
  MaxFaceNum?: number
1153
-
1154
1038
  /**
1155
1039
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
1156
1040
  */
1157
1041
  MinFaceSize?: number
1158
-
1159
1042
  /**
1160
- * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1043
+ * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1161
1044
  例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
1162
- */
1045
+ */
1163
1046
  MaxPersonNumPerGroup?: number
1164
-
1165
1047
  /**
1166
- * 图片质量控制。
1048
+ * 图片质量控制。
1167
1049
  0: 不进行控制;
1168
1050
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1169
1051
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1171,19 +1053,16 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1171
1053
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1172
1054
  默认 0。
1173
1055
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1174
- */
1056
+ */
1175
1057
  QualityControl?: number
1176
-
1177
1058
  /**
1178
1059
  * 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
1179
1060
  */
1180
1061
  FaceMatchThreshold?: number
1181
-
1182
1062
  /**
1183
1063
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
1184
1064
  */
1185
1065
  NeedPersonInfo?: number
1186
-
1187
1066
  /**
1188
1067
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1189
1068
  */
@@ -1208,87 +1087,70 @@ export interface DenseFaceShape {
1208
1087
  * 人脸框左上角横坐标。
1209
1088
  */
1210
1089
  X: number
1211
-
1212
1090
  /**
1213
1091
  * 人脸框左上角纵坐标。
1214
1092
  */
1215
1093
  Y: number
1216
-
1217
1094
  /**
1218
1095
  * 人脸框宽度。
1219
1096
  */
1220
1097
  Width: number
1221
-
1222
1098
  /**
1223
1099
  * 人脸框高度。
1224
1100
  */
1225
1101
  Height: number
1226
-
1227
1102
  /**
1228
1103
  * 描述左侧眼睛轮廓的 XX 点。
1229
1104
  */
1230
1105
  LeftEye: Array<Point>
1231
-
1232
1106
  /**
1233
1107
  * 描述右侧眼睛轮廓的 XX 点。
1234
1108
  */
1235
1109
  RightEye: Array<Point>
1236
-
1237
1110
  /**
1238
1111
  * 描述左侧眉毛轮廓的 XX 点。
1239
1112
  */
1240
1113
  LeftEyeBrow: Array<Point>
1241
-
1242
1114
  /**
1243
1115
  * 描述右侧眉毛轮廓的 XX 点。
1244
1116
  */
1245
1117
  RightEyeBrow: Array<Point>
1246
-
1247
1118
  /**
1248
1119
  * 描述外嘴巴轮廓的 XX 点, 从左侧开始逆时针返回。
1249
1120
  */
1250
1121
  MouthOutside: Array<Point>
1251
-
1252
1122
  /**
1253
1123
  * 描述内嘴巴轮廓的 XX 点,从左侧开始逆时针返回。
1254
1124
  */
1255
1125
  MouthInside: Array<Point>
1256
-
1257
1126
  /**
1258
1127
  * 描述鼻子轮廓的 XX 点。
1259
1128
  */
1260
1129
  Nose: Array<Point>
1261
-
1262
1130
  /**
1263
1131
  * 左瞳孔轮廓的 XX 个点。
1264
1132
  */
1265
1133
  LeftPupil: Array<Point>
1266
-
1267
1134
  /**
1268
1135
  * 右瞳孔轮廓的 XX 个点。
1269
1136
  */
1270
1137
  RightPupil: Array<Point>
1271
-
1272
1138
  /**
1273
1139
  * 中轴线轮廓的 XX 个点。
1274
1140
  */
1275
1141
  CentralAxis: Array<Point>
1276
-
1277
1142
  /**
1278
1143
  * 下巴轮廓的 XX 个点。
1279
1144
  */
1280
1145
  Chin: Array<Point>
1281
-
1282
1146
  /**
1283
1147
  * 左眼袋的 XX 个点。
1284
1148
  */
1285
1149
  LeftEyeBags: Array<Point>
1286
-
1287
1150
  /**
1288
1151
  * 右眼袋的 XX 个点。
1289
1152
  */
1290
1153
  RightEyeBags: Array<Point>
1291
-
1292
1154
  /**
1293
1155
  * 额头的 XX 个点。
1294
1156
  */
@@ -1304,16 +1166,14 @@ export interface ResultsReturnsByGroup {
1304
1166
  * 检测出的人脸框位置。
1305
1167
  */
1306
1168
  FaceRect: FaceRect
1307
-
1308
1169
  /**
1309
1170
  * 识别结果。
1310
1171
  */
1311
1172
  GroupCandidates: Array<GroupCandidate>
1312
-
1313
1173
  /**
1314
- * 检测出的人脸图片状态返回码。0 表示正常。
1174
+ * 检测出的人脸图片状态返回码。0 表示正常。
1315
1175
  -1601代表不符合图片质量控制要求,此时Candidate内容为空。
1316
- */
1176
+ */
1317
1177
  RetCode: number
1318
1178
  }
1319
1179
 
@@ -1325,7 +1185,6 @@ export interface Point {
1325
1185
  * x坐标
1326
1186
  */
1327
1187
  X: number
1328
-
1329
1188
  /**
1330
1189
  * Y坐标
1331
1190
  */
@@ -1340,12 +1199,10 @@ export interface GetPersonListNumResponse {
1340
1199
  * 人员数量
1341
1200
  */
1342
1201
  PersonNum?: number
1343
-
1344
1202
  /**
1345
1203
  * 人脸数量
1346
1204
  */
1347
1205
  FaceNum?: number
1348
-
1349
1206
  /**
1350
1207
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1351
1208
  */
@@ -1360,7 +1217,6 @@ export interface DeletePersonFromGroupRequest {
1360
1217
  * 人员ID,取值为创建人员接口中的PersonId
1361
1218
  */
1362
1219
  PersonId: string
1363
-
1364
1220
  /**
1365
1221
  * 人员库ID,取值为创建人员库接口中的GroupId
1366
1222
  */
@@ -1375,28 +1231,25 @@ export interface VerifyFaceRequest {
1375
1231
  * 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
1376
1232
  */
1377
1233
  PersonId: string
1378
-
1379
1234
  /**
1380
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1235
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1381
1236
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1382
1237
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1383
1238
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1384
- */
1239
+ */
1385
1240
  Image?: string
1386
-
1387
1241
  /**
1388
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1242
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1389
1243
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1390
1244
  Url、Image必须提供一个,如果都提供,只使用 Url。
1391
1245
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1392
1246
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1393
1247
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1394
1248
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1395
- */
1249
+ */
1396
1250
  Url?: string
1397
-
1398
1251
  /**
1399
- * 图片质量控制。
1252
+ * 图片质量控制。
1400
1253
  0: 不进行控制;
1401
1254
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1402
1255
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1404,9 +1257,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
1404
1257
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1405
1258
  默认 0。
1406
1259
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1407
- */
1260
+ */
1408
1261
  QualityControl?: number
1409
-
1410
1262
  /**
1411
1263
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1412
1264
  */
@@ -1421,25 +1273,21 @@ export interface GetPersonListResponse {
1421
1273
  * 返回的人员信息
1422
1274
  */
1423
1275
  PersonInfos?: Array<PersonInfo>
1424
-
1425
1276
  /**
1426
- * 该人员库的人员数量
1277
+ * 该人员库的人员数量
1427
1278
  注意:此字段可能返回 null,表示取不到有效值。
1428
- */
1279
+ */
1429
1280
  PersonNum?: number
1430
-
1431
1281
  /**
1432
- * 该人员库的人脸数量
1282
+ * 该人员库的人脸数量
1433
1283
  注意:此字段可能返回 null,表示取不到有效值。
1434
- */
1284
+ */
1435
1285
  FaceNum?: number
1436
-
1437
1286
  /**
1438
- * 人脸识别所用的算法模型版本。
1287
+ * 人脸识别所用的算法模型版本。
1439
1288
  注意:此字段可能返回 null,表示取不到有效值。
1440
- */
1289
+ */
1441
1290
  FaceModelVersion?: string
1442
-
1443
1291
  /**
1444
1292
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1445
1293
  */
@@ -1451,21 +1299,19 @@ export interface GetPersonListResponse {
1451
1299
  */
1452
1300
  export interface Hair {
1453
1301
  /**
1454
- * 头发长度信息。
1302
+ * 头发长度信息。
1455
1303
  AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
1456
- */
1304
+ */
1457
1305
  Length: AttributeItem
1458
-
1459
1306
  /**
1460
- * 刘海信息。
1307
+ * 刘海信息。
1461
1308
  AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
1462
- */
1309
+ */
1463
1310
  Bang: AttributeItem
1464
-
1465
1311
  /**
1466
- * 头发颜色信息。
1312
+ * 头发颜色信息。
1467
1313
  AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
1468
- */
1314
+ */
1469
1315
  Color: AttributeItem
1470
1316
  }
1471
1317
 
@@ -1477,16 +1323,14 @@ export interface Result {
1477
1323
  * 识别出的最相似候选人
1478
1324
  */
1479
1325
  Candidates: Array<Candidate>
1480
-
1481
1326
  /**
1482
1327
  * 检测出的人脸框位置
1483
1328
  */
1484
1329
  FaceRect: FaceRect
1485
-
1486
1330
  /**
1487
- * 检测出的人脸图片状态返回码。0 表示正常。
1331
+ * 检测出的人脸图片状态返回码。0 表示正常。
1488
1332
  -1601代表不符合图片质量控制要求,此时Candidate内容为空。
1489
- */
1333
+ */
1490
1334
  RetCode: number
1491
1335
  }
1492
1336
 
@@ -1498,19 +1342,16 @@ export interface GetPersonGroupInfoResponse {
1498
1342
  * 包含此人员的人员库及描述字段内容列表
1499
1343
  */
1500
1344
  PersonGroupInfos?: Array<PersonGroupInfo>
1501
-
1502
1345
  /**
1503
- * 人员库总数量
1346
+ * 人员库总数量
1504
1347
  注意:此字段可能返回 null,表示取不到有效值。
1505
- */
1348
+ */
1506
1349
  GroupNum?: number
1507
-
1508
1350
  /**
1509
- * 人脸识别服务所用的算法模型版本。
1351
+ * 人脸识别服务所用的算法模型版本。
1510
1352
  注意:此字段可能返回 null,表示取不到有效值。
1511
- */
1353
+ */
1512
1354
  FaceModelVersion?: string
1513
-
1514
1355
  /**
1515
1356
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1516
1357
  */
@@ -1525,7 +1366,6 @@ export interface UpgradeGroupFaceModelVersionResponse {
1525
1366
  * 升级任务ID,用于查询、获取升级的进度和结果。
1526
1367
  */
1527
1368
  JobId: string
1528
-
1529
1369
  /**
1530
1370
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1531
1371
  */
@@ -1537,53 +1377,46 @@ export interface UpgradeGroupFaceModelVersionResponse {
1537
1377
  */
1538
1378
  export interface SearchFacesReturnsByGroupRequest {
1539
1379
  /**
1540
- * 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
1380
+ * 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
1541
1381
  不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
1542
- */
1382
+ */
1543
1383
  GroupIds: Array<string>
1544
-
1545
1384
  /**
1546
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1385
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1547
1386
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1548
1387
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1549
- */
1388
+ */
1550
1389
  Image?: string
1551
-
1552
1390
  /**
1553
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1391
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1554
1392
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1555
1393
  Url、Image必须提供一个,如果都提供,只使用 Url。
1556
1394
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1557
1395
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1558
1396
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1559
- */
1397
+ */
1560
1398
  Url?: string
1561
-
1562
1399
  /**
1563
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1400
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1564
1401
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1565
1402
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1566
- */
1403
+ */
1567
1404
  MaxFaceNum?: number
1568
-
1569
1405
  /**
1570
1406
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
1571
1407
  */
1572
1408
  MinFaceSize?: number
1573
-
1574
1409
  /**
1575
- * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1410
+ * 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
1576
1411
  例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
1577
- */
1412
+ */
1578
1413
  MaxPersonNumPerGroup?: number
1579
-
1580
1414
  /**
1581
1415
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
1582
1416
  */
1583
1417
  NeedPersonInfo?: number
1584
-
1585
1418
  /**
1586
- * 图片质量控制。
1419
+ * 图片质量控制。
1587
1420
  0: 不进行控制;
1588
1421
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1589
1422
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1591,16 +1424,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
1591
1424
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1592
1425
  默认 0。
1593
1426
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1594
- */
1427
+ */
1595
1428
  QualityControl?: number
1596
-
1597
1429
  /**
1598
- * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
1430
+ * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
1599
1431
  默认为0。
1600
1432
  取值范围[0.0,100.0) 。
1601
- */
1433
+ */
1602
1434
  FaceMatchThreshold?: number
1603
-
1604
1435
  /**
1605
1436
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1606
1437
  */
@@ -1615,22 +1446,18 @@ export interface AnalyzeDenseLandmarksResponse {
1615
1446
  * 请求的图片宽度。
1616
1447
  */
1617
1448
  ImageWidth?: number
1618
-
1619
1449
  /**
1620
1450
  * 请求的图片高度。
1621
1451
  */
1622
1452
  ImageHeight?: number
1623
-
1624
1453
  /**
1625
1454
  * 稠密人脸关键点具体信息。
1626
1455
  */
1627
1456
  DenseFaceShapeSet?: Array<DenseFaceShape>
1628
-
1629
1457
  /**
1630
1458
  * 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
1631
1459
  */
1632
1460
  FaceModelVersion?: string
1633
-
1634
1461
  /**
1635
1462
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1636
1463
  */
@@ -1655,12 +1482,10 @@ export interface ModifyPersonGroupInfoRequest {
1655
1482
  * 人员库ID,取值为创建人员库接口中的GroupId
1656
1483
  */
1657
1484
  GroupId: string
1658
-
1659
1485
  /**
1660
1486
  * 人员ID,取值为创建人员接口中的PersonId
1661
1487
  */
1662
1488
  PersonId: string
1663
-
1664
1489
  /**
1665
1490
  * 需要修改的人员描述字段内容,key-value
1666
1491
  */
@@ -1682,45 +1507,40 @@ export interface RevertGroupFaceModelVersionRequest {
1682
1507
  */
1683
1508
  export interface FaceQualityCompleteness {
1684
1509
  /**
1685
- * 眉毛的遮挡分数[0,100],分数越高遮挡越少。
1510
+ * 眉毛的遮挡分数[0,100],分数越高遮挡越少。
1686
1511
  参考范围:[0,80]表示发生遮挡。
1687
1512
  注意:此字段可能返回 null,表示取不到有效值。
1688
- */
1513
+ */
1689
1514
  Eyebrow: number
1690
-
1691
1515
  /**
1692
- * 眼睛的遮挡分数[0,100],分数越高遮挡越少。
1516
+ * 眼睛的遮挡分数[0,100],分数越高遮挡越少。
1693
1517
  参考范围:[0,80]表示发生遮挡。
1694
1518
  注意:此字段可能返回 null,表示取不到有效值。
1695
- */
1519
+ */
1696
1520
  Eye: number
1697
-
1698
1521
  /**
1699
- * 鼻子的遮挡分数[0,100],分数越高遮挡越少。
1522
+ * 鼻子的遮挡分数[0,100],分数越高遮挡越少。
1700
1523
  参考范围:[0,60]表示发生遮挡。
1701
1524
  注意:此字段可能返回 null,表示取不到有效值。
1702
- */
1525
+ */
1703
1526
  Nose: number
1704
-
1705
1527
  /**
1706
- * 脸颊的遮挡分数[0,100],分数越高遮挡越少。
1528
+ * 脸颊的遮挡分数[0,100],分数越高遮挡越少。
1707
1529
  参考范围:[0,70]表示发生遮挡。
1708
1530
  注意:此字段可能返回 null,表示取不到有效值。
1709
- */
1531
+ */
1710
1532
  Cheek: number
1711
-
1712
1533
  /**
1713
- * 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
1534
+ * 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
1714
1535
  参考范围:[0,50]表示发生遮挡。
1715
1536
  注意:此字段可能返回 null,表示取不到有效值。
1716
- */
1537
+ */
1717
1538
  Mouth: number
1718
-
1719
1539
  /**
1720
- * 下巴的遮挡分数[0,100],分数越高遮挡越少。
1540
+ * 下巴的遮挡分数[0,100],分数越高遮挡越少。
1721
1541
  参考范围:[0,70]表示发生遮挡。
1722
1542
  注意:此字段可能返回 null,表示取不到有效值。
1723
- */
1543
+ */
1724
1544
  Chin: number
1725
1545
  }
1726
1546
 
@@ -1733,67 +1553,56 @@ export interface FaceAttributesInfo {
1733
1553
  * 性别[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1734
1554
  */
1735
1555
  Gender: number
1736
-
1737
1556
  /**
1738
1557
  * 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1739
1558
  */
1740
1559
  Age: number
1741
-
1742
1560
  /**
1743
1561
  * 微笑[0(normal,正常)~50(smile,微笑)~100(laugh,大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1744
1562
  */
1745
1563
  Expression: number
1746
-
1747
1564
  /**
1748
1565
  * 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1749
1566
  */
1750
1567
  Glass: boolean
1751
-
1752
1568
  /**
1753
- * 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1569
+ * 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1754
1570
  建议:人脸入库选择[-10,10]的图片。
1755
- */
1571
+ */
1756
1572
  Pitch: number
1757
-
1758
1573
  /**
1759
- * 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1574
+ * 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1760
1575
  建议:人脸入库选择[-10,10]的图片。
1761
- */
1576
+ */
1762
1577
  Yaw: number
1763
-
1764
1578
  /**
1765
- * 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1579
+ * 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1766
1580
  建议:人脸入库选择[-20,20]的图片。
1767
- */
1581
+ */
1768
1582
  Roll: number
1769
-
1770
1583
  /**
1771
1584
  * 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1772
1585
  */
1773
1586
  Beauty: number
1774
-
1775
1587
  /**
1776
- * 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1588
+ * 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1777
1589
  注意:此字段可能返回 null,表示取不到有效值。
1778
- */
1590
+ */
1779
1591
  Hat: boolean
1780
-
1781
1592
  /**
1782
- * 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1593
+ * 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1783
1594
  注意:此字段可能返回 null,表示取不到有效值。
1784
- */
1595
+ */
1785
1596
  Mask: boolean
1786
-
1787
1597
  /**
1788
- * 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1598
+ * 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1789
1599
  注意:此字段可能返回 null,表示取不到有效值。
1790
- */
1600
+ */
1791
1601
  Hair: FaceHairAttributesInfo
1792
-
1793
1602
  /**
1794
- * 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1603
+ * 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1795
1604
  注意:此字段可能返回 null,表示取不到有效值。
1796
- */
1605
+ */
1797
1606
  EyeOpen: boolean
1798
1607
  }
1799
1608
 
@@ -1805,28 +1614,25 @@ export interface VerifyPersonRequest {
1805
1614
  * 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
1806
1615
  */
1807
1616
  PersonId: string
1808
-
1809
1617
  /**
1810
- * 图片 base64 数据。
1618
+ * 图片 base64 数据。
1811
1619
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1812
1620
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1813
1621
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1814
- */
1622
+ */
1815
1623
  Image?: string
1816
-
1817
1624
  /**
1818
- * 图片的 Url
1625
+ * 图片的 Url
1819
1626
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
1820
1627
  图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
1821
1628
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1822
1629
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1823
1630
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1824
1631
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1825
- */
1632
+ */
1826
1633
  Url?: string
1827
-
1828
1634
  /**
1829
- * 图片质量控制。
1635
+ * 图片质量控制。
1830
1636
  0: 不进行控制;
1831
1637
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
1832
1638
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -1834,9 +1640,8 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
1834
1640
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
1835
1641
  默认 0。
1836
1642
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
1837
- */
1643
+ */
1838
1644
  QualityControl?: number
1839
-
1840
1645
  /**
1841
1646
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1842
1647
  */
@@ -1848,19 +1653,17 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
1848
1653
  */
1849
1654
  export interface CompareMaskFaceResponse {
1850
1655
  /**
1851
- * 两张图片中人脸的相似度分数。
1656
+ * 两张图片中人脸的相似度分数。
1852
1657
  不同算法版本返回的相似度分数不同。
1853
1658
  若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
1854
1659
  2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
1855
1660
  若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
1856
- */
1661
+ */
1857
1662
  Score: number
1858
-
1859
1663
  /**
1860
1664
  * 人脸识别所用的算法模型版本。
1861
1665
  */
1862
1666
  FaceModelVersion: string
1863
-
1864
1667
  /**
1865
1668
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1866
1669
  */
@@ -1875,12 +1678,10 @@ export interface ModifyPersonBaseInfoRequest {
1875
1678
  * 人员ID,取值为创建人员接口中的PersonId
1876
1679
  */
1877
1680
  PersonId: string
1878
-
1879
1681
  /**
1880
1682
  * 需要修改的人员名称
1881
1683
  */
1882
1684
  PersonName?: string
1883
-
1884
1685
  /**
1885
1686
  * 需要修改的人员性别,1代表男性,2代表女性
1886
1687
  */
@@ -1892,25 +1693,23 @@ export interface ModifyPersonBaseInfoRequest {
1892
1693
  */
1893
1694
  export interface DetectLiveFaceAccurateRequest {
1894
1695
  /**
1895
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1696
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1896
1697
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1897
1698
  图片的宽高比请接近 3:4,手机拍摄比例最佳。
1898
1699
  人脸尺寸大于100X100像素。
1899
1700
  图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1900
- */
1701
+ */
1901
1702
  Image?: string
1902
-
1903
1703
  /**
1904
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1704
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1905
1705
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1906
1706
  Url、Image必须提供一个,如果都提供,只使用 Url。
1907
1707
  图片的宽高比请接近 3:4,手机拍摄比例最佳。
1908
1708
  人脸尺寸大于100X100像素。
1909
1709
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
1910
1710
  图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1911
- */
1711
+ */
1912
1712
  Url?: string
1913
-
1914
1713
  /**
1915
1714
  * 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
1916
1715
  */
@@ -1922,24 +1721,21 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
1922
1721
  */
1923
1722
  export interface VerifyFaceResponse {
1924
1723
  /**
1925
- * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
1724
+ * 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
1926
1725
 
1927
1726
  不同算法版本返回的相似度分数不同。
1928
1727
  若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
1929
1728
  2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
1930
- */
1729
+ */
1931
1730
  Score: number
1932
-
1933
1731
  /**
1934
1732
  * 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
1935
1733
  */
1936
1734
  IsMatch: boolean
1937
-
1938
1735
  /**
1939
1736
  * 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
1940
1737
  */
1941
1738
  FaceModelVersion: string
1942
-
1943
1739
  /**
1944
1740
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1945
1741
  */
@@ -1954,14 +1750,13 @@ export interface FaceDetailInfo {
1954
1750
  * 检测出的人脸框位置。
1955
1751
  */
1956
1752
  FaceRect: FaceRect
1957
-
1958
1753
  /**
1959
- * 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
1754
+ * 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
1960
1755
  情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
1961
1756
  头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
1962
1757
  鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
1963
1758
  若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
1964
- */
1759
+ */
1965
1760
  FaceDetailAttributesInfo: FaceDetailAttributesInfo
1966
1761
  }
1967
1762
 
@@ -1970,54 +1765,47 @@ export interface FaceDetailInfo {
1970
1765
  */
1971
1766
  export interface SearchFacesRequest {
1972
1767
  /**
1973
- * 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
1768
+ * 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
1974
1769
  不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
1975
- */
1770
+ */
1976
1771
  GroupIds: Array<string>
1977
-
1978
1772
  /**
1979
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1773
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
1980
1774
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1981
1775
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1982
- */
1776
+ */
1983
1777
  Image?: string
1984
-
1985
1778
  /**
1986
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1779
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1987
1780
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1988
1781
  Url、Image必须提供一个,如果都提供,只使用 Url。
1989
1782
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1990
1783
  非腾讯云存储的Url速度和稳定性可能受一定影响。
1991
1784
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1992
- */
1785
+ */
1993
1786
  Url?: string
1994
-
1995
1787
  /**
1996
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1788
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1997
1789
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
1998
1790
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
1999
- */
1791
+ */
2000
1792
  MaxFaceNum?: number
2001
-
2002
1793
  /**
2003
1794
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
2004
1795
  */
2005
1796
  MinFaceSize?: number
2006
-
2007
1797
  /**
2008
- * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1798
+ * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
2009
1799
  例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
2010
1800
  值越大,需要处理的时间越长。建议不要超过10。
2011
- */
1801
+ */
2012
1802
  MaxPersonNum?: number
2013
-
2014
1803
  /**
2015
1804
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
2016
1805
  */
2017
1806
  NeedPersonInfo?: number
2018
-
2019
1807
  /**
2020
- * 图片质量控制。
1808
+ * 图片质量控制。
2021
1809
  0: 不进行控制;
2022
1810
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
2023
1811
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -2025,14 +1813,12 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
2025
1813
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
2026
1814
  默认 0。
2027
1815
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2028
- */
1816
+ */
2029
1817
  QualityControl?: number
2030
-
2031
1818
  /**
2032
1819
  * 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
2033
1820
  */
2034
1821
  FaceMatchThreshold?: number
2035
-
2036
1822
  /**
2037
1823
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2038
1824
  */
@@ -2047,46 +1833,40 @@ export interface SearchPersonsRequest {
2047
1833
  * 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId
2048
1834
  */
2049
1835
  GroupIds: Array<string>
2050
-
2051
1836
  /**
2052
- * 图片 base64 数据,base64 编码后大小不可超过5M。
1837
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
2053
1838
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2054
1839
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2055
1840
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2056
- */
1841
+ */
2057
1842
  Image?: string
2058
-
2059
1843
  /**
2060
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
1844
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
2061
1845
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2062
1846
  Url、Image必须提供一个,如果都提供,只使用 Url。
2063
1847
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2064
1848
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2065
1849
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2066
- */
1850
+ */
2067
1851
  Url?: string
2068
-
2069
1852
  /**
2070
- * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
1853
+ * 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
2071
1854
  MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
2072
1855
  例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
2073
- */
1856
+ */
2074
1857
  MaxFaceNum?: number
2075
-
2076
1858
  /**
2077
1859
  * 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
2078
1860
  */
2079
1861
  MinFaceSize?: number
2080
-
2081
1862
  /**
2082
- * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
1863
+ * 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
2083
1864
  例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
2084
1865
  值越大,需要处理的时间越长。建议不要超过10。
2085
- */
1866
+ */
2086
1867
  MaxPersonNum?: number
2087
-
2088
1868
  /**
2089
- * 图片质量控制。
1869
+ * 图片质量控制。
2090
1870
  0: 不进行控制;
2091
1871
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
2092
1872
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -2094,19 +1874,16 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
2094
1874
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
2095
1875
  默认 0。
2096
1876
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2097
- */
1877
+ */
2098
1878
  QualityControl?: number
2099
-
2100
1879
  /**
2101
1880
  * 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
2102
1881
  */
2103
1882
  FaceMatchThreshold?: number
2104
-
2105
1883
  /**
2106
1884
  * 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
2107
1885
  */
2108
1886
  NeedPersonInfo?: number
2109
-
2110
1887
  /**
2111
1888
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2112
1889
  */
@@ -2121,31 +1898,26 @@ export interface PersonInfo {
2121
1898
  * 人员名称
2122
1899
  */
2123
1900
  PersonName: string
2124
-
2125
1901
  /**
2126
1902
  * 人员Id
2127
1903
  */
2128
1904
  PersonId: string
2129
-
2130
1905
  /**
2131
1906
  * 人员性别
2132
1907
  */
2133
1908
  Gender: number
2134
-
2135
1909
  /**
2136
1910
  * 人员描述字段内容
2137
1911
  */
2138
1912
  PersonExDescriptions: Array<string>
2139
-
2140
1913
  /**
2141
1914
  * 包含的人脸照片列表
2142
1915
  */
2143
1916
  FaceIds: Array<string>
2144
-
2145
1917
  /**
2146
- * 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
1918
+ * 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
2147
1919
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
2148
- */
1920
+ */
2149
1921
  CreationTimestamp: number
2150
1922
  }
2151
1923
 
@@ -2157,7 +1929,6 @@ export interface GroupExDescriptionInfo {
2157
1929
  * 人员库自定义描述字段Index,从0开始
2158
1930
  */
2159
1931
  GroupExDescriptionIndex: number
2160
-
2161
1932
  /**
2162
1933
  * 需要更新的人员库自定义描述字段内容
2163
1934
  */
@@ -2169,50 +1940,45 @@ export interface GroupExDescriptionInfo {
2169
1940
  */
2170
1941
  export interface CompareMaskFaceRequest {
2171
1942
  /**
2172
- * A 图片 base64 数据,base64 编码后大小不可超过5M。
1943
+ * A 图片 base64 数据,base64 编码后大小不可超过5M。
2173
1944
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2174
1945
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2175
1946
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2176
- */
1947
+ */
2177
1948
  ImageA?: string
2178
-
2179
1949
  /**
2180
- * B 图片 base64 数据,base64 编码后大小不可超过5M。
1950
+ * B 图片 base64 数据,base64 编码后大小不可超过5M。
2181
1951
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2182
1952
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2183
1953
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2184
- */
1954
+ */
2185
1955
  ImageB?: string
2186
-
2187
1956
  /**
2188
- * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
1957
+ * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2189
1958
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2190
1959
  A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2191
1960
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2192
1961
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2193
1962
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2194
1963
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2195
- */
1964
+ */
2196
1965
  UrlA?: string
2197
-
2198
1966
  /**
2199
- * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
1967
+ * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2200
1968
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2201
1969
  B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2202
1970
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2203
1971
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2204
1972
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2205
1973
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2206
- */
1974
+ */
2207
1975
  UrlB?: string
2208
-
2209
1976
  /**
2210
1977
  * 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
2211
1978
  */
2212
1979
  FaceModelVersion?: string
2213
-
2214
1980
  /**
2215
- * 图片质量控制。
1981
+ * 图片质量控制。
2216
1982
  0: 不进行控制;
2217
1983
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
2218
1984
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -2220,7 +1986,7 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2220
1986
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
2221
1987
  默认 0。
2222
1988
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2223
- */
1989
+ */
2224
1990
  QualityControl?: number
2225
1991
  }
2226
1992
 
@@ -2232,22 +1998,18 @@ export interface AnalyzeFaceResponse {
2232
1998
  * 请求的图片宽度。
2233
1999
  */
2234
2000
  ImageWidth: number
2235
-
2236
2001
  /**
2237
2002
  * 请求的图片高度。
2238
2003
  */
2239
2004
  ImageHeight: number
2240
-
2241
2005
  /**
2242
2006
  * 五官定位(人脸关键点)具体信息。
2243
2007
  */
2244
2008
  FaceShapeSet: Array<FaceShape>
2245
-
2246
2009
  /**
2247
2010
  * 人脸识别所用的算法模型版本。
2248
2011
  */
2249
2012
  FaceModelVersion: string
2250
-
2251
2013
  /**
2252
2014
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2253
2015
  */
@@ -2259,53 +2021,47 @@ export interface AnalyzeFaceResponse {
2259
2021
  */
2260
2022
  export interface DetectFaceRequest {
2261
2023
  /**
2262
- * 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
2024
+ * 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
2263
2025
  此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
2264
- */
2026
+ */
2265
2027
  MaxFaceNum?: number
2266
-
2267
2028
  /**
2268
- * 人脸长和宽的最小尺寸,单位为像素。
2029
+ * 人脸长和宽的最小尺寸,单位为像素。
2269
2030
  默认为34。建议不低于34。
2270
2031
  低于MinFaceSize值的人脸不会被检测。
2271
- */
2032
+ */
2272
2033
  MinFaceSize?: number
2273
-
2274
2034
  /**
2275
- * 图片 base64 数据,base64 编码后大小不可超过5M。
2035
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
2276
2036
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2277
2037
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2278
- */
2038
+ */
2279
2039
  Image?: string
2280
-
2281
2040
  /**
2282
- * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
2041
+ * 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
2283
2042
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2284
2043
  Url、Image必须提供一个,如果都提供,只使用 Url。
2285
2044
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2286
2045
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2287
2046
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2288
- */
2047
+ */
2289
2048
  Url?: string
2290
-
2291
2049
  /**
2292
- * 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
2050
+ * 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
2293
2051
  非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
2294
2052
  最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
2295
2053
  提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
2296
- */
2054
+ */
2297
2055
  NeedFaceAttributes?: number
2298
-
2299
2056
  /**
2300
- * 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
2057
+ * 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
2301
2058
  非 1 值均视为不进行质量检测。
2302
2059
  最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
2303
2060
  建议:人脸入库操作建议开启此功能。
2304
- */
2061
+ */
2305
2062
  NeedQualityDetection?: number
2306
-
2307
2063
  /**
2308
- * 人脸识别服务所用的算法模型版本。
2064
+ * 人脸识别服务所用的算法模型版本。
2309
2065
 
2310
2066
  目前入参支持 “2.0”和“3.0“ 两个输入。
2311
2067
 
@@ -2314,9 +2070,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
2314
2070
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
2315
2071
 
2316
2072
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
2317
- */
2073
+ */
2318
2074
  FaceModelVersion?: string
2319
-
2320
2075
  /**
2321
2076
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2322
2077
  */
@@ -2351,7 +2106,6 @@ export interface PersonExDescriptionInfo {
2351
2106
  * 人员描述字段Index,从0开始
2352
2107
  */
2353
2108
  PersonExDescriptionIndex: number
2354
-
2355
2109
  /**
2356
2110
  * 需要更新的人员描述字段内容
2357
2111
  */
@@ -2366,12 +2120,10 @@ export interface GetUpgradeGroupFaceModelVersionJobListResponse {
2366
2120
  * 人员库升级任务信息列表。
2367
2121
  */
2368
2122
  JobInfos?: Array<UpgradeJobInfo>
2369
-
2370
2123
  /**
2371
2124
  * 升级任务总数量。
2372
2125
  */
2373
2126
  JobNum?: number
2374
-
2375
2127
  /**
2376
2128
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2377
2129
  */
@@ -2386,12 +2138,10 @@ export interface HeadPose {
2386
2138
  * 上下偏移[-30,30]。
2387
2139
  */
2388
2140
  Pitch: number
2389
-
2390
2141
  /**
2391
2142
  * 左右偏移[-30,30]。
2392
2143
  */
2393
2144
  Yaw: number
2394
-
2395
2145
  /**
2396
2146
  * 平面旋转[-180,180]。
2397
2147
  */
@@ -2406,13 +2156,11 @@ export interface GetGroupListResponse {
2406
2156
  * 返回的人员库信息
2407
2157
  */
2408
2158
  GroupInfos: Array<GroupInfo>
2409
-
2410
2159
  /**
2411
- * 人员库总数量
2160
+ * 人员库总数量
2412
2161
  注意:此字段可能返回 null,表示取不到有效值。
2413
- */
2162
+ */
2414
2163
  GroupNum: number
2415
-
2416
2164
  /**
2417
2165
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2418
2166
  */
@@ -2424,46 +2172,41 @@ export interface GetGroupListResponse {
2424
2172
  */
2425
2173
  export interface DetectFaceAttributesRequest {
2426
2174
  /**
2427
- * 最多处理的人脸数目。
2175
+ * 最多处理的人脸数目。
2428
2176
  默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
2429
2177
  此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
2430
- */
2178
+ */
2431
2179
  MaxFaceNum?: number
2432
-
2433
2180
  /**
2434
- * 图片 base64 数据,base64 编码后大小不可超过5M。
2181
+ * 图片 base64 数据,base64 编码后大小不可超过5M。
2435
2182
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2436
2183
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2437
- */
2184
+ */
2438
2185
  Image?: string
2439
-
2440
2186
  /**
2441
- * 图片的 Url 。
2187
+ * 图片的 Url 。
2442
2188
  对应图片 base64 编码后大小不可超过5M。
2443
2189
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2444
2190
  Url、Image必须提供一个,如果都提供,只使用 Url。
2445
2191
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2446
2192
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2447
2193
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2448
- */
2194
+ */
2449
2195
  Url?: string
2450
-
2451
2196
  /**
2452
- * 是否返回年龄、性别、情绪等属性。
2197
+ * 是否返回年龄、性别、情绪等属性。
2453
2198
  合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
2454
2199
  Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
2455
2200
  None为不需要返回。默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
2456
2201
  需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
2457
2202
  关于各属性的详细描述,参见下文出参。
2458
2203
  最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
2459
- */
2204
+ */
2460
2205
  FaceAttributesType?: string
2461
-
2462
2206
  /**
2463
2207
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2464
2208
  */
2465
2209
  NeedRotateDetection?: number
2466
-
2467
2210
  /**
2468
2211
  * 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
2469
2212
  */
@@ -2478,32 +2221,26 @@ export interface GetGroupInfoResponse {
2478
2221
  * 人员库名称
2479
2222
  */
2480
2223
  GroupName?: string
2481
-
2482
2224
  /**
2483
2225
  * 人员库ID
2484
2226
  */
2485
2227
  GroupId?: string
2486
-
2487
2228
  /**
2488
2229
  * 人员库自定义描述字段
2489
2230
  */
2490
2231
  GroupExDescriptions?: Array<string>
2491
-
2492
2232
  /**
2493
2233
  * 人员库信息备注
2494
2234
  */
2495
2235
  Tag?: string
2496
-
2497
2236
  /**
2498
2237
  * 人脸识别所用的算法模型版本。
2499
2238
  */
2500
2239
  FaceModelVersion?: string
2501
-
2502
2240
  /**
2503
2241
  * Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2504
2242
  */
2505
2243
  CreationTimestamp?: number
2506
-
2507
2244
  /**
2508
2245
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2509
2246
  */
@@ -2515,19 +2252,17 @@ export interface GetGroupInfoResponse {
2515
2252
  */
2516
2253
  export interface CompareFaceResponse {
2517
2254
  /**
2518
- * 两张图片中人脸的相似度分数。
2255
+ * 两张图片中人脸的相似度分数。
2519
2256
  不同算法版本返回的相似度分数不同。
2520
2257
  若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
2521
2258
  2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
2522
2259
  若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
2523
- */
2260
+ */
2524
2261
  Score: number
2525
-
2526
2262
  /**
2527
2263
  * 人脸识别所用的算法模型版本。
2528
2264
  */
2529
2265
  FaceModelVersion: string
2530
-
2531
2266
  /**
2532
2267
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2533
2268
  */
@@ -2539,9 +2274,9 @@ export interface CompareFaceResponse {
2539
2274
  */
2540
2275
  export interface Mouth {
2541
2276
  /**
2542
- * 是否张嘴信息。
2277
+ * 是否张嘴信息。
2543
2278
  AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
2544
- */
2279
+ */
2545
2280
  MouthOpen: AttributeItem
2546
2281
  }
2547
2282
 
@@ -2573,42 +2308,34 @@ export interface FaceShape {
2573
2308
  * 描述脸型轮廓的 21 点。
2574
2309
  */
2575
2310
  FaceProfile: Array<Point>
2576
-
2577
2311
  /**
2578
2312
  * 描述左侧眼睛轮廓的 8 点。
2579
2313
  */
2580
2314
  LeftEye: Array<Point>
2581
-
2582
2315
  /**
2583
2316
  * 描述右侧眼睛轮廓的 8 点。
2584
2317
  */
2585
2318
  RightEye: Array<Point>
2586
-
2587
2319
  /**
2588
2320
  * 描述左侧眉毛轮廓的 8 点。
2589
2321
  */
2590
2322
  LeftEyeBrow: Array<Point>
2591
-
2592
2323
  /**
2593
2324
  * 描述右侧眉毛轮廓的 8 点。
2594
2325
  */
2595
2326
  RightEyeBrow: Array<Point>
2596
-
2597
2327
  /**
2598
2328
  * 描述嘴巴轮廓的 22 点。
2599
2329
  */
2600
2330
  Mouth: Array<Point>
2601
-
2602
2331
  /**
2603
2332
  * 描述鼻子轮廓的 13 点。
2604
2333
  */
2605
2334
  Nose: Array<Point>
2606
-
2607
2335
  /**
2608
2336
  * 左瞳孔轮廓的 1 个点。
2609
2337
  */
2610
2338
  LeftPupil: Array<Point>
2611
-
2612
2339
  /**
2613
2340
  * 右瞳孔轮廓的 1 个点。
2614
2341
  */
@@ -2620,45 +2347,41 @@ export interface FaceShape {
2620
2347
  */
2621
2348
  export interface CompareFaceRequest {
2622
2349
  /**
2623
- * A 图片 base64 数据,base64 编码后大小不可超过5M。
2350
+ * A 图片 base64 数据,base64 编码后大小不可超过5M。
2624
2351
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2625
2352
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2626
2353
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2627
- */
2354
+ */
2628
2355
  ImageA?: string
2629
-
2630
2356
  /**
2631
- * B 图片 base64 数据,base64 编码后大小不可超过5M。
2357
+ * B 图片 base64 数据,base64 编码后大小不可超过5M。
2632
2358
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2633
2359
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2634
2360
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2635
- */
2361
+ */
2636
2362
  ImageB?: string
2637
-
2638
2363
  /**
2639
- * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2364
+ * A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2640
2365
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2641
2366
  A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2642
2367
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2643
2368
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2644
2369
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2645
2370
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2646
- */
2371
+ */
2647
2372
  UrlA?: string
2648
-
2649
2373
  /**
2650
- * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2374
+ * B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
2651
2375
  jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
2652
2376
  B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2653
2377
  图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
2654
2378
  非腾讯云存储的Url速度和稳定性可能受一定影响。
2655
2379
  若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
2656
2380
  支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
2657
- */
2381
+ */
2658
2382
  UrlB?: string
2659
-
2660
2383
  /**
2661
- * 人脸识别服务所用的算法模型版本。
2384
+ * 人脸识别服务所用的算法模型版本。
2662
2385
 
2663
2386
  目前入参支持 “2.0”和“3.0“ 两个输入。
2664
2387
 
@@ -2667,11 +2390,10 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2667
2390
  2020年11月26日后开通服务的账号仅支持输入“3.0”。
2668
2391
 
2669
2392
  不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
2670
- */
2393
+ */
2671
2394
  FaceModelVersion?: string
2672
-
2673
2395
  /**
2674
- * 图片质量控制。
2396
+ * 图片质量控制。
2675
2397
  0: 不进行控制;
2676
2398
  1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
2677
2399
  2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
@@ -2679,9 +2401,8 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
2679
2401
  4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
2680
2402
  默认 0。
2681
2403
  若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
2682
- */
2404
+ */
2683
2405
  QualityControl?: number
2684
-
2685
2406
  /**
2686
2407
  * 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
2687
2408
  */
@@ -2696,17 +2417,14 @@ export interface VerifyPersonResponse {
2696
2417
  * 给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸(Face),会融合多张人脸信息进行验证。
2697
2418
  */
2698
2419
  Score?: number
2699
-
2700
2420
  /**
2701
2421
  * 是否为同一人的判断。
2702
2422
  */
2703
2423
  IsMatch?: boolean
2704
-
2705
2424
  /**
2706
2425
  * 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
2707
2426
  */
2708
2427
  FaceModelVersion?: string
2709
-
2710
2428
  /**
2711
2429
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2712
2430
  */
@@ -2721,22 +2439,18 @@ export interface DetectFaceResponse {
2721
2439
  * 请求的图片宽度。
2722
2440
  */
2723
2441
  ImageWidth: number
2724
-
2725
2442
  /**
2726
2443
  * 请求的图片高度。
2727
2444
  */
2728
2445
  ImageHeight: number
2729
-
2730
2446
  /**
2731
2447
  * 人脸信息列表。包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
2732
2448
  */
2733
2449
  FaceInfos: Array<FaceInfo>
2734
-
2735
2450
  /**
2736
2451
  * 人脸识别所用的算法模型版本。
2737
2452
  */
2738
2453
  FaceModelVersion: string
2739
-
2740
2454
  /**
2741
2455
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2742
2456
  */
@@ -2771,30 +2485,25 @@ export interface UpgradeJobInfo {
2771
2485
  * 人员库升级任务ID,用于查询、获取升级的进度和结果。
2772
2486
  */
2773
2487
  JobId: string
2774
-
2775
2488
  /**
2776
2489
  * 人员库ID。
2777
2490
  */
2778
2491
  GroupId: string
2779
-
2780
2492
  /**
2781
2493
  * 当前算法模型版本。
2782
2494
  */
2783
2495
  FromFaceModelVersion: string
2784
-
2785
2496
  /**
2786
2497
  * 目标算法模型版本。
2787
2498
  */
2788
2499
  ToFaceModelVersion: string
2789
-
2790
2500
  /**
2791
- * 升级起始时间。
2501
+ * 升级起始时间。
2792
2502
  StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2793
2503
  Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
2794
2504
  有关更多信息,请参阅 Unix 时间。
2795
- */
2505
+ */
2796
2506
  StartTime: number
2797
-
2798
2507
  /**
2799
2508
  * 0表示升级中,1表示升级完毕,2表示回滚完毕,3表示升级失败。
2800
2509
  */
@@ -2819,12 +2528,10 @@ export interface GetPersonListRequest {
2819
2528
  * 人员库ID,取值为创建人员库接口中的GroupId
2820
2529
  */
2821
2530
  GroupId: string
2822
-
2823
2531
  /**
2824
2532
  * 起始序号,默认值为0
2825
2533
  */
2826
2534
  Offset?: number
2827
-
2828
2535
  /**
2829
2536
  * 返回数量,默认值为10,最大值为1000
2830
2537
  */
@@ -2840,106 +2547,91 @@ export interface GetPersonListRequest {
2840
2547
  */
2841
2548
  export interface FaceDetailAttributesInfo {
2842
2549
  /**
2843
- * 年龄 [0,65],其中65代表“65岁及以上”。
2550
+ * 年龄 [0,65],其中65代表“65岁及以上”。
2844
2551
  FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2845
- */
2552
+ */
2846
2553
  Age: number
2847
-
2848
2554
  /**
2849
- * 美丑打分[0,100]。
2555
+ * 美丑打分[0,100]。
2850
2556
  FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2851
- */
2557
+ */
2852
2558
  Beauty: number
2853
-
2854
2559
  /**
2855
- * 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
2560
+ * 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
2856
2561
  AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
2857
2562
  FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2858
- */
2563
+ */
2859
2564
  Emotion: AttributeItem
2860
-
2861
2565
  /**
2862
- * 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
2566
+ * 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
2863
2567
  FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2864
- */
2568
+ */
2865
2569
  Eye: Eye
2866
-
2867
2570
  /**
2868
- * 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
2571
+ * 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
2869
2572
  FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2870
- */
2573
+ */
2871
2574
  Eyebrow: Eyebrow
2872
-
2873
2575
  /**
2874
- * 性别信息。
2576
+ * 性别信息。
2875
2577
  AttributeItem对应的Type为 —— 0:男性,1:女性。
2876
2578
  FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2877
- */
2579
+ */
2878
2580
  Gender: AttributeItem
2879
-
2880
2581
  /**
2881
- * 头发信息,包含头发长度、有无刘海、头发颜色。
2582
+ * 头发信息,包含头发长度、有无刘海、头发颜色。
2882
2583
  FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2883
- */
2584
+ */
2884
2585
  Hair: Hair
2885
-
2886
2586
  /**
2887
- * 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
2587
+ * 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
2888
2588
  FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2889
- */
2589
+ */
2890
2590
  Hat: Hat
2891
-
2892
2591
  /**
2893
- * 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
2592
+ * 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
2894
2593
  FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2895
- */
2594
+ */
2896
2595
  HeadPose: HeadPose
2897
-
2898
2596
  /**
2899
- * 口罩佩戴信息。
2597
+ * 口罩佩戴信息。
2900
2598
  AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
2901
2599
  FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2902
- */
2600
+ */
2903
2601
  Mask: AttributeItem
2904
-
2905
2602
  /**
2906
- * 嘴巴信息,可识别是否张嘴、嘴唇厚度。
2603
+ * 嘴巴信息,可识别是否张嘴、嘴唇厚度。
2907
2604
  FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2908
- */
2605
+ */
2909
2606
  Mouth: Mouth
2910
-
2911
2607
  /**
2912
- * 胡子信息。
2608
+ * 胡子信息。
2913
2609
  AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
2914
2610
  FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2915
- */
2611
+ */
2916
2612
  Moustache: AttributeItem
2917
-
2918
2613
  /**
2919
- * 鼻子信息。
2614
+ * 鼻子信息。
2920
2615
  AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
2921
2616
  FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2922
- */
2617
+ */
2923
2618
  Nose: AttributeItem
2924
-
2925
2619
  /**
2926
- * 脸型信息。
2620
+ * 脸型信息。
2927
2621
  AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
2928
2622
  FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2929
- */
2623
+ */
2930
2624
  Shape: AttributeItem
2931
-
2932
2625
  /**
2933
- * 肤色信息。
2626
+ * 肤色信息。
2934
2627
  AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
2935
2628
  FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2936
- */
2629
+ */
2937
2630
  Skin: AttributeItem
2938
-
2939
2631
  /**
2940
- * 微笑程度,[0,100]。
2632
+ * 微笑程度,[0,100]。
2941
2633
  FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
2942
- */
2634
+ */
2943
2635
  Smile: number
2944
2636
  }
2945
2637
 
@@ -2951,7 +2643,6 @@ export interface AttributeItem {
2951
2643
  * 属性值
2952
2644
  */
2953
2645
  Type: number
2954
-
2955
2646
  /**
2956
2647
  * Type识别概率值,【0,1】,代表判断正确的概率。
2957
2648
  */
@@ -2963,24 +2654,21 @@ export interface AttributeItem {
2963
2654
  */
2964
2655
  export interface FaceRect {
2965
2656
  /**
2966
- * 人脸框左上角横坐标。
2657
+ * 人脸框左上角横坐标。
2967
2658
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
2968
2659
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
2969
- */
2660
+ */
2970
2661
  X: number
2971
-
2972
2662
  /**
2973
- * 人脸框左上角纵坐标。
2663
+ * 人脸框左上角纵坐标。
2974
2664
  人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
2975
2665
  若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
2976
- */
2666
+ */
2977
2667
  Y: number
2978
-
2979
2668
  /**
2980
2669
  * 人脸宽度
2981
2670
  */
2982
2671
  Width: number
2983
-
2984
2672
  /**
2985
2673
  * 人脸高度
2986
2674
  */
@@ -3005,7 +2693,6 @@ export interface CreateGroupResponse {
3005
2693
  * 人脸识别所用的算法模型版本。
3006
2694
  */
3007
2695
  FaceModelVersion: string
3008
-
3009
2696
  /**
3010
2697
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
3011
2698
  */