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