tencentcloud-sdk-nodejs-iai 4.0.431 → 4.0.432

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