tencentcloud-sdk-nodejs-iai 4.0.388 → 4.0.431

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