tencentcloud-sdk-nodejs-iai 4.0.617 → 4.0.619
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +556 -0
- package/SERVICE_CHANGELOG.md +677 -22
- package/package.json +1 -1
- package/products.md +33 -33
- package/src/services/iai/v20180301/iai_models.ts +298 -600
- package/src/services/iai/v20200303/iai_models.ts +316 -629
- package/tencentcloud/services/iai/v20180301/iai_models.d.ts +298 -298
- package/tencentcloud/services/iai/v20200303/iai_models.d.ts +316 -316
|
@@ -3,24 +3,24 @@
|
|
|
3
3
|
*/
|
|
4
4
|
export interface Eye {
|
|
5
5
|
/**
|
|
6
|
-
|
|
6
|
+
* 识别是否佩戴眼镜。
|
|
7
7
|
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
|
8
|
-
|
|
8
|
+
*/
|
|
9
9
|
Glass: AttributeItem;
|
|
10
10
|
/**
|
|
11
|
-
|
|
11
|
+
* 识别眼睛的睁开、闭合状态。
|
|
12
12
|
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
13
|
-
|
|
13
|
+
*/
|
|
14
14
|
EyeOpen: AttributeItem;
|
|
15
15
|
/**
|
|
16
|
-
|
|
16
|
+
* 识别是否双眼皮。
|
|
17
17
|
AttributeItem对应的Type为 —— 0:无,1:有。
|
|
18
|
-
|
|
18
|
+
*/
|
|
19
19
|
EyelidType: AttributeItem;
|
|
20
20
|
/**
|
|
21
|
-
|
|
21
|
+
* 眼睛大小。
|
|
22
22
|
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
|
23
|
-
|
|
23
|
+
*/
|
|
24
24
|
EyeSize: AttributeItem;
|
|
25
25
|
}
|
|
26
26
|
/**
|
|
@@ -36,29 +36,29 @@ export interface Candidate {
|
|
|
36
36
|
*/
|
|
37
37
|
FaceId: string;
|
|
38
38
|
/**
|
|
39
|
-
|
|
39
|
+
* 候选者的匹配得分。
|
|
40
40
|
|
|
41
41
|
1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
|
|
42
42
|
10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分;
|
|
43
43
|
30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
|
44
44
|
|
|
45
45
|
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
|
46
|
-
|
|
46
|
+
*/
|
|
47
47
|
Score: number;
|
|
48
48
|
/**
|
|
49
|
-
|
|
49
|
+
* 人员名称
|
|
50
50
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
51
|
-
|
|
51
|
+
*/
|
|
52
52
|
PersonName: string;
|
|
53
53
|
/**
|
|
54
|
-
|
|
54
|
+
* 人员性别
|
|
55
55
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
56
|
-
|
|
56
|
+
*/
|
|
57
57
|
Gender: number;
|
|
58
58
|
/**
|
|
59
|
-
|
|
59
|
+
* 包含此人员的人员库及描述字段内容列表
|
|
60
60
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
61
|
-
|
|
61
|
+
*/
|
|
62
62
|
PersonGroupInfos: Array<PersonGroupInfo>;
|
|
63
63
|
}
|
|
64
64
|
/**
|
|
@@ -125,14 +125,14 @@ export interface PersonGroupInfo {
|
|
|
125
125
|
*/
|
|
126
126
|
export interface Hat {
|
|
127
127
|
/**
|
|
128
|
-
|
|
128
|
+
* 帽子佩戴状态信息。
|
|
129
129
|
AttributeItem对应的Type为 —— 0:不戴帽子,1:普通帽子,2:头盔,3:保安帽。
|
|
130
|
-
|
|
130
|
+
*/
|
|
131
131
|
Style: AttributeItem;
|
|
132
132
|
/**
|
|
133
|
-
|
|
133
|
+
* 帽子颜色。
|
|
134
134
|
AttributeItem对应的Type为 —— 0:不戴帽子,1:红色系,2:黄色系,3:蓝色系,4:黑色系,5:灰白色系,6:混色系子。
|
|
135
|
-
|
|
135
|
+
*/
|
|
136
136
|
Color: AttributeItem;
|
|
137
137
|
}
|
|
138
138
|
/**
|
|
@@ -160,20 +160,20 @@ export interface CreatePersonRequest {
|
|
|
160
160
|
*/
|
|
161
161
|
PersonExDescriptionInfos?: Array<PersonExDescriptionInfo>;
|
|
162
162
|
/**
|
|
163
|
-
|
|
163
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
164
164
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
165
|
-
|
|
165
|
+
*/
|
|
166
166
|
Image?: string;
|
|
167
167
|
/**
|
|
168
|
-
|
|
168
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
169
169
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
170
170
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
171
171
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
172
172
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
173
|
-
|
|
173
|
+
*/
|
|
174
174
|
Url?: string;
|
|
175
175
|
/**
|
|
176
|
-
|
|
176
|
+
* 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
|
177
177
|
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
178
178
|
如果判断没有,则完成创建人员。
|
|
179
179
|
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
|
@@ -183,10 +183,10 @@ export interface CreatePersonRequest {
|
|
|
183
183
|
4: 很高的同一人判断要求(十万一误识别率)。
|
|
184
184
|
默认 0。
|
|
185
185
|
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
186
|
-
|
|
186
|
+
*/
|
|
187
187
|
UniquePersonControl?: number;
|
|
188
188
|
/**
|
|
189
|
-
|
|
189
|
+
* 图片质量控制。
|
|
190
190
|
0: 不进行控制;
|
|
191
191
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
192
192
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -194,7 +194,7 @@ export interface CreatePersonRequest {
|
|
|
194
194
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
195
195
|
默认 0。
|
|
196
196
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
197
|
-
|
|
197
|
+
*/
|
|
198
198
|
QualityControl?: number;
|
|
199
199
|
/**
|
|
200
200
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -214,16 +214,16 @@ export interface CreateFaceResponse {
|
|
|
214
214
|
*/
|
|
215
215
|
SucFaceIds: Array<string>;
|
|
216
216
|
/**
|
|
217
|
-
|
|
217
|
+
* 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
|
|
218
218
|
-1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
|
|
219
219
|
其他非 0 值代表算法服务异常。
|
|
220
220
|
RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
221
|
-
|
|
221
|
+
*/
|
|
222
222
|
RetCode: Array<number>;
|
|
223
223
|
/**
|
|
224
|
-
|
|
224
|
+
* 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
|
|
225
225
|
例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
|
226
|
-
|
|
226
|
+
*/
|
|
227
227
|
SucIndexes: Array<number>;
|
|
228
228
|
/**
|
|
229
229
|
* 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
|
|
@@ -243,19 +243,19 @@ export interface CreateFaceResponse {
|
|
|
243
243
|
*/
|
|
244
244
|
export interface FaceHairAttributesInfo {
|
|
245
245
|
/**
|
|
246
|
-
|
|
246
|
+
* 0:光头,1:短发,2:中发,3:长发,4:绑发
|
|
247
247
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
248
|
-
|
|
248
|
+
*/
|
|
249
249
|
Length: number;
|
|
250
250
|
/**
|
|
251
|
-
|
|
251
|
+
* 0:有刘海,1:无刘海
|
|
252
252
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
253
|
-
|
|
253
|
+
*/
|
|
254
254
|
Bang: number;
|
|
255
255
|
/**
|
|
256
|
-
|
|
256
|
+
* 0:黑色,1:金色,2:棕色,3:灰白色
|
|
257
257
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
258
|
-
|
|
258
|
+
*/
|
|
259
259
|
Color: number;
|
|
260
260
|
}
|
|
261
261
|
/**
|
|
@@ -267,29 +267,29 @@ export interface CreateFaceRequest {
|
|
|
267
267
|
*/
|
|
268
268
|
PersonId: string;
|
|
269
269
|
/**
|
|
270
|
-
|
|
270
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
271
271
|
人员人脸总数量不可超过5张。
|
|
272
272
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
273
273
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
274
|
-
|
|
274
|
+
*/
|
|
275
275
|
Images?: Array<string>;
|
|
276
276
|
/**
|
|
277
|
-
|
|
277
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
278
278
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
279
279
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
280
280
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
281
281
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
282
282
|
人员人脸总数量不可超过5张。
|
|
283
283
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
284
|
-
|
|
284
|
+
*/
|
|
285
285
|
Urls?: Array<string>;
|
|
286
286
|
/**
|
|
287
|
-
|
|
287
|
+
* 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
|
288
288
|
默认值60分。取值范围[0,100] 。
|
|
289
|
-
|
|
289
|
+
*/
|
|
290
290
|
FaceMatchThreshold?: number;
|
|
291
291
|
/**
|
|
292
|
-
|
|
292
|
+
* 图片质量控制。
|
|
293
293
|
0: 不进行控制;
|
|
294
294
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
295
295
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -297,7 +297,7 @@ export interface CreateFaceRequest {
|
|
|
297
297
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
298
298
|
默认 0。
|
|
299
299
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
300
|
-
|
|
300
|
+
*/
|
|
301
301
|
QualityControl?: number;
|
|
302
302
|
/**
|
|
303
303
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -317,21 +317,21 @@ export interface CreateGroupRequest {
|
|
|
317
317
|
*/
|
|
318
318
|
GroupId: string;
|
|
319
319
|
/**
|
|
320
|
-
|
|
320
|
+
* 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
|
321
321
|
最多可以创建5个。
|
|
322
322
|
每个自定义描述字段支持[1,30]个字符。
|
|
323
323
|
在同一人员库中自定义描述字段不可重复。
|
|
324
324
|
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
|
325
325
|
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
|
326
326
|
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
327
|
-
|
|
327
|
+
*/
|
|
328
328
|
GroupExDescriptions?: Array<string>;
|
|
329
329
|
/**
|
|
330
330
|
* 人员库信息备注,[0,40]个字符。
|
|
331
331
|
*/
|
|
332
332
|
Tag?: string;
|
|
333
333
|
/**
|
|
334
|
-
|
|
334
|
+
* 人脸识别服务所用的算法模型版本。
|
|
335
335
|
|
|
336
336
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
337
337
|
|
|
@@ -340,7 +340,7 @@ export interface CreateGroupRequest {
|
|
|
340
340
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
341
341
|
|
|
342
342
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
343
|
-
|
|
343
|
+
*/
|
|
344
344
|
FaceModelVersion?: string;
|
|
345
345
|
}
|
|
346
346
|
/**
|
|
@@ -365,16 +365,16 @@ export interface GetPersonGroupInfoRequest {
|
|
|
365
365
|
*/
|
|
366
366
|
export interface FaceInfo {
|
|
367
367
|
/**
|
|
368
|
-
|
|
368
|
+
* 人脸框左上角横坐标。
|
|
369
369
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
370
370
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
371
|
-
|
|
371
|
+
*/
|
|
372
372
|
X: number;
|
|
373
373
|
/**
|
|
374
|
-
|
|
374
|
+
* 人脸框左上角纵坐标。
|
|
375
375
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
376
376
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
377
|
-
|
|
377
|
+
*/
|
|
378
378
|
Y: number;
|
|
379
379
|
/**
|
|
380
380
|
* 人脸框宽度。
|
|
@@ -385,14 +385,14 @@ export interface FaceInfo {
|
|
|
385
385
|
*/
|
|
386
386
|
Height: number;
|
|
387
387
|
/**
|
|
388
|
-
|
|
388
|
+
* 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
|
|
389
389
|
魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
|
390
|
-
|
|
390
|
+
*/
|
|
391
391
|
FaceAttributesInfo: FaceAttributesInfo;
|
|
392
392
|
/**
|
|
393
|
-
|
|
393
|
+
* 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
|
|
394
394
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
395
|
-
|
|
395
|
+
*/
|
|
396
396
|
FaceQualityInfo: FaceQualityInfo;
|
|
397
397
|
}
|
|
398
398
|
/**
|
|
@@ -400,19 +400,19 @@ export interface FaceInfo {
|
|
|
400
400
|
*/
|
|
401
401
|
export interface Eyebrow {
|
|
402
402
|
/**
|
|
403
|
-
|
|
403
|
+
* 眉毛浓密。
|
|
404
404
|
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
405
|
-
|
|
405
|
+
*/
|
|
406
406
|
EyebrowDensity: AttributeItem;
|
|
407
407
|
/**
|
|
408
|
-
|
|
408
|
+
* 眉毛弯曲。
|
|
409
409
|
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
410
|
-
|
|
410
|
+
*/
|
|
411
411
|
EyebrowCurve: AttributeItem;
|
|
412
412
|
/**
|
|
413
|
-
|
|
413
|
+
* 眉毛长短。
|
|
414
414
|
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
415
|
-
|
|
415
|
+
*/
|
|
416
416
|
EyebrowLength: AttributeItem;
|
|
417
417
|
}
|
|
418
418
|
/**
|
|
@@ -420,25 +420,25 @@ export interface Eyebrow {
|
|
|
420
420
|
*/
|
|
421
421
|
export interface AnalyzeDenseLandmarksRequest {
|
|
422
422
|
/**
|
|
423
|
-
|
|
423
|
+
* 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
|
424
424
|
默认为 0。
|
|
425
425
|
最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
426
|
-
|
|
426
|
+
*/
|
|
427
427
|
Mode?: number;
|
|
428
428
|
/**
|
|
429
|
-
|
|
429
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
430
430
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
431
431
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
432
|
-
|
|
432
|
+
*/
|
|
433
433
|
Image?: string;
|
|
434
434
|
/**
|
|
435
|
-
|
|
435
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
436
436
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
437
437
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
438
438
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
439
439
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
440
440
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
441
|
-
|
|
441
|
+
*/
|
|
442
442
|
Url?: string;
|
|
443
443
|
/**
|
|
444
444
|
* 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
|
@@ -480,10 +480,10 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
|
|
|
480
480
|
*/
|
|
481
481
|
export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
482
482
|
/**
|
|
483
|
-
|
|
483
|
+
* 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
|
|
484
484
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
485
485
|
如果为0表示这个任务已经执行完毕。
|
|
486
|
-
|
|
486
|
+
*/
|
|
487
487
|
EndTimestamp: number;
|
|
488
488
|
/**
|
|
489
489
|
* 升级任务完成进度。取值[0.0,100.0]。
|
|
@@ -494,11 +494,11 @@ export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
|
494
494
|
*/
|
|
495
495
|
Status: number;
|
|
496
496
|
/**
|
|
497
|
-
|
|
497
|
+
* 升级起始时间。
|
|
498
498
|
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
499
499
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
500
500
|
有关更多信息,请参阅 Unix 时间。
|
|
501
|
-
|
|
501
|
+
*/
|
|
502
502
|
StartTime: number;
|
|
503
503
|
/**
|
|
504
504
|
* 当前算法模型版本。
|
|
@@ -530,20 +530,20 @@ export interface AnalyzeFaceRequest {
|
|
|
530
530
|
*/
|
|
531
531
|
Mode?: number;
|
|
532
532
|
/**
|
|
533
|
-
|
|
533
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
534
534
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
535
|
-
|
|
535
|
+
*/
|
|
536
536
|
Image?: string;
|
|
537
537
|
/**
|
|
538
|
-
|
|
538
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
539
539
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
540
540
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
541
541
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
542
542
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
543
|
-
|
|
543
|
+
*/
|
|
544
544
|
Url?: string;
|
|
545
545
|
/**
|
|
546
|
-
|
|
546
|
+
* 人脸识别服务所用的算法模型版本。
|
|
547
547
|
|
|
548
548
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
549
549
|
|
|
@@ -552,7 +552,7 @@ export interface AnalyzeFaceRequest {
|
|
|
552
552
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
553
553
|
|
|
554
554
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
555
|
-
|
|
555
|
+
*/
|
|
556
556
|
FaceModelVersion?: string;
|
|
557
557
|
/**
|
|
558
558
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -568,14 +568,14 @@ export interface CreatePersonResponse {
|
|
|
568
568
|
*/
|
|
569
569
|
FaceId?: string;
|
|
570
570
|
/**
|
|
571
|
-
|
|
571
|
+
* 检测出的人脸框的位置。
|
|
572
572
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
573
|
-
|
|
573
|
+
*/
|
|
574
574
|
FaceRect?: FaceRect;
|
|
575
575
|
/**
|
|
576
|
-
|
|
576
|
+
* 疑似同一人的PersonId。
|
|
577
577
|
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
578
|
-
|
|
578
|
+
*/
|
|
579
579
|
SimilarPersonId?: string;
|
|
580
580
|
/**
|
|
581
581
|
* 人脸识别所用的算法模型版本。
|
|
@@ -668,18 +668,18 @@ export interface DeletePersonRequest {
|
|
|
668
668
|
*/
|
|
669
669
|
export interface DetectLiveFaceResponse {
|
|
670
670
|
/**
|
|
671
|
-
|
|
671
|
+
* 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
|
|
672
672
|
本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
|
|
673
|
-
|
|
673
|
+
*/
|
|
674
674
|
Score: number;
|
|
675
675
|
/**
|
|
676
676
|
* 人脸识别所用的算法模型版本。
|
|
677
677
|
*/
|
|
678
678
|
FaceModelVersion: string;
|
|
679
679
|
/**
|
|
680
|
-
|
|
680
|
+
* 活体检测是否通过。
|
|
681
681
|
本字段只有FaceModelVersion为3.0时才具备参考意义。
|
|
682
|
-
|
|
682
|
+
*/
|
|
683
683
|
IsLiveness: boolean;
|
|
684
684
|
/**
|
|
685
685
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -747,21 +747,21 @@ export interface UpgradeGroupFaceModelVersionRequest {
|
|
|
747
747
|
*/
|
|
748
748
|
export interface DetectLiveFaceRequest {
|
|
749
749
|
/**
|
|
750
|
-
|
|
750
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
|
|
751
751
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
752
|
-
|
|
752
|
+
*/
|
|
753
753
|
Image?: string;
|
|
754
754
|
/**
|
|
755
|
-
|
|
755
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
756
756
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
757
757
|
(图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
|
|
758
758
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
759
759
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
760
760
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
761
|
-
|
|
761
|
+
*/
|
|
762
762
|
Url?: string;
|
|
763
763
|
/**
|
|
764
|
-
|
|
764
|
+
* 人脸识别服务所用的算法模型版本。
|
|
765
765
|
|
|
766
766
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
767
767
|
|
|
@@ -770,7 +770,7 @@ export interface DetectLiveFaceRequest {
|
|
|
770
770
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
771
771
|
|
|
772
772
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
773
|
-
|
|
773
|
+
*/
|
|
774
774
|
FaceModelVersion?: string;
|
|
775
775
|
}
|
|
776
776
|
/**
|
|
@@ -807,9 +807,9 @@ export interface SearchPersonsResponse {
|
|
|
807
807
|
*/
|
|
808
808
|
PersonNum: number;
|
|
809
809
|
/**
|
|
810
|
-
|
|
810
|
+
* 人脸识别所用的算法模型版本。
|
|
811
811
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
812
|
-
|
|
812
|
+
*/
|
|
813
813
|
FaceModelVersion: string;
|
|
814
814
|
/**
|
|
815
815
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -838,25 +838,25 @@ export interface GroupInfo {
|
|
|
838
838
|
*/
|
|
839
839
|
GroupId: string;
|
|
840
840
|
/**
|
|
841
|
-
|
|
841
|
+
* 人员库自定义描述字段
|
|
842
842
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
843
|
-
|
|
843
|
+
*/
|
|
844
844
|
GroupExDescriptions: Array<string>;
|
|
845
845
|
/**
|
|
846
|
-
|
|
846
|
+
* 人员库信息备注
|
|
847
847
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
848
|
-
|
|
848
|
+
*/
|
|
849
849
|
Tag: string;
|
|
850
850
|
/**
|
|
851
|
-
|
|
851
|
+
* 人脸识别所用的算法模型版本。
|
|
852
852
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
853
|
-
|
|
853
|
+
*/
|
|
854
854
|
FaceModelVersion: string;
|
|
855
855
|
/**
|
|
856
|
-
|
|
856
|
+
* Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
857
857
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
858
858
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
859
|
-
|
|
859
|
+
*/
|
|
860
860
|
CreationTimestamp: number;
|
|
861
861
|
}
|
|
862
862
|
/**
|
|
@@ -864,31 +864,31 @@ export interface GroupInfo {
|
|
|
864
864
|
*/
|
|
865
865
|
export interface FaceQualityInfo {
|
|
866
866
|
/**
|
|
867
|
-
|
|
867
|
+
* 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
|
868
868
|
正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
|
869
869
|
参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
|
870
870
|
建议:人脸入库选取70以上的图片。
|
|
871
871
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
872
|
-
|
|
872
|
+
*/
|
|
873
873
|
Score: number;
|
|
874
874
|
/**
|
|
875
|
-
|
|
875
|
+
* 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
|
|
876
876
|
参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
|
877
877
|
建议:人脸入库选取80以上的图片。
|
|
878
878
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
879
|
-
|
|
879
|
+
*/
|
|
880
880
|
Sharpness: number;
|
|
881
881
|
/**
|
|
882
|
-
|
|
882
|
+
* 光照分:[0,100],评价图片光照程度,分数越高越亮。
|
|
883
883
|
参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
|
884
884
|
建议:人脸入库选取[30,70]的图片。
|
|
885
885
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
886
|
-
|
|
886
|
+
*/
|
|
887
887
|
Brightness: number;
|
|
888
888
|
/**
|
|
889
|
-
|
|
889
|
+
* 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
|
890
890
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
891
|
-
|
|
891
|
+
*/
|
|
892
892
|
Completeness: FaceQualityCompleteness;
|
|
893
893
|
}
|
|
894
894
|
/**
|
|
@@ -934,35 +934,35 @@ export interface SearchPersonsReturnsByGroupRequest {
|
|
|
934
934
|
*/
|
|
935
935
|
GroupIds: Array<string>;
|
|
936
936
|
/**
|
|
937
|
-
|
|
937
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
938
938
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
939
|
-
|
|
939
|
+
*/
|
|
940
940
|
Image?: string;
|
|
941
941
|
/**
|
|
942
|
-
|
|
942
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
943
943
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
944
944
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
945
945
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
946
946
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
947
|
-
|
|
947
|
+
*/
|
|
948
948
|
Url?: string;
|
|
949
949
|
/**
|
|
950
|
-
|
|
950
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
951
951
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
952
952
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
953
|
-
|
|
953
|
+
*/
|
|
954
954
|
MaxFaceNum?: number;
|
|
955
955
|
/**
|
|
956
956
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
957
957
|
*/
|
|
958
958
|
MinFaceSize?: number;
|
|
959
959
|
/**
|
|
960
|
-
|
|
960
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
961
961
|
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
962
|
-
|
|
962
|
+
*/
|
|
963
963
|
MaxPersonNumPerGroup?: number;
|
|
964
964
|
/**
|
|
965
|
-
|
|
965
|
+
* 图片质量控制。
|
|
966
966
|
0: 不进行控制;
|
|
967
967
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
968
968
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -970,7 +970,7 @@ export interface SearchPersonsReturnsByGroupRequest {
|
|
|
970
970
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
971
971
|
默认 0。
|
|
972
972
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
973
|
-
|
|
973
|
+
*/
|
|
974
974
|
QualityControl?: number;
|
|
975
975
|
/**
|
|
976
976
|
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
@@ -1085,9 +1085,9 @@ export interface ResultsReturnsByGroup {
|
|
|
1085
1085
|
*/
|
|
1086
1086
|
GroupCandidates: Array<GroupCandidate>;
|
|
1087
1087
|
/**
|
|
1088
|
-
|
|
1088
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1089
1089
|
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1090
|
-
|
|
1090
|
+
*/
|
|
1091
1091
|
RetCode: number;
|
|
1092
1092
|
}
|
|
1093
1093
|
/**
|
|
@@ -1142,22 +1142,22 @@ export interface VerifyFaceRequest {
|
|
|
1142
1142
|
*/
|
|
1143
1143
|
PersonId: string;
|
|
1144
1144
|
/**
|
|
1145
|
-
|
|
1145
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1146
1146
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1147
1147
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1148
|
-
|
|
1148
|
+
*/
|
|
1149
1149
|
Image?: string;
|
|
1150
1150
|
/**
|
|
1151
|
-
|
|
1151
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1152
1152
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1153
1153
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1154
1154
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1155
1155
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1156
1156
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1157
|
-
|
|
1157
|
+
*/
|
|
1158
1158
|
Url?: string;
|
|
1159
1159
|
/**
|
|
1160
|
-
|
|
1160
|
+
* 图片质量控制。
|
|
1161
1161
|
0: 不进行控制;
|
|
1162
1162
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1163
1163
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1165,7 +1165,7 @@ export interface VerifyFaceRequest {
|
|
|
1165
1165
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1166
1166
|
默认 0。
|
|
1167
1167
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1168
|
-
|
|
1168
|
+
*/
|
|
1169
1169
|
QualityControl?: number;
|
|
1170
1170
|
/**
|
|
1171
1171
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1181,19 +1181,19 @@ export interface GetPersonListResponse {
|
|
|
1181
1181
|
*/
|
|
1182
1182
|
PersonInfos?: Array<PersonInfo>;
|
|
1183
1183
|
/**
|
|
1184
|
-
|
|
1184
|
+
* 该人员库的人员数量
|
|
1185
1185
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1186
|
-
|
|
1186
|
+
*/
|
|
1187
1187
|
PersonNum?: number;
|
|
1188
1188
|
/**
|
|
1189
|
-
|
|
1189
|
+
* 该人员库的人脸数量
|
|
1190
1190
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1191
|
-
|
|
1191
|
+
*/
|
|
1192
1192
|
FaceNum?: number;
|
|
1193
1193
|
/**
|
|
1194
|
-
|
|
1194
|
+
* 人脸识别所用的算法模型版本。
|
|
1195
1195
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1196
|
-
|
|
1196
|
+
*/
|
|
1197
1197
|
FaceModelVersion?: string;
|
|
1198
1198
|
/**
|
|
1199
1199
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -1205,19 +1205,19 @@ export interface GetPersonListResponse {
|
|
|
1205
1205
|
*/
|
|
1206
1206
|
export interface Hair {
|
|
1207
1207
|
/**
|
|
1208
|
-
|
|
1208
|
+
* 头发长度信息。
|
|
1209
1209
|
AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
|
|
1210
|
-
|
|
1210
|
+
*/
|
|
1211
1211
|
Length: AttributeItem;
|
|
1212
1212
|
/**
|
|
1213
|
-
|
|
1213
|
+
* 刘海信息。
|
|
1214
1214
|
AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
|
|
1215
|
-
|
|
1215
|
+
*/
|
|
1216
1216
|
Bang: AttributeItem;
|
|
1217
1217
|
/**
|
|
1218
|
-
|
|
1218
|
+
* 头发颜色信息。
|
|
1219
1219
|
AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
|
|
1220
|
-
|
|
1220
|
+
*/
|
|
1221
1221
|
Color: AttributeItem;
|
|
1222
1222
|
}
|
|
1223
1223
|
/**
|
|
@@ -1233,9 +1233,9 @@ export interface Result {
|
|
|
1233
1233
|
*/
|
|
1234
1234
|
FaceRect: FaceRect;
|
|
1235
1235
|
/**
|
|
1236
|
-
|
|
1236
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1237
1237
|
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1238
|
-
|
|
1238
|
+
*/
|
|
1239
1239
|
RetCode: number;
|
|
1240
1240
|
}
|
|
1241
1241
|
/**
|
|
@@ -1247,14 +1247,14 @@ export interface GetPersonGroupInfoResponse {
|
|
|
1247
1247
|
*/
|
|
1248
1248
|
PersonGroupInfos?: Array<PersonGroupInfo>;
|
|
1249
1249
|
/**
|
|
1250
|
-
|
|
1250
|
+
* 人员库总数量
|
|
1251
1251
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1252
|
-
|
|
1252
|
+
*/
|
|
1253
1253
|
GroupNum?: number;
|
|
1254
1254
|
/**
|
|
1255
|
-
|
|
1255
|
+
* 人脸识别服务所用的算法模型版本。
|
|
1256
1256
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1257
|
-
|
|
1257
|
+
*/
|
|
1258
1258
|
FaceModelVersion?: string;
|
|
1259
1259
|
/**
|
|
1260
1260
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -1283,39 +1283,39 @@ export interface SearchFacesReturnsByGroupRequest {
|
|
|
1283
1283
|
*/
|
|
1284
1284
|
GroupIds: Array<string>;
|
|
1285
1285
|
/**
|
|
1286
|
-
|
|
1286
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1287
1287
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1288
|
-
|
|
1288
|
+
*/
|
|
1289
1289
|
Image?: string;
|
|
1290
1290
|
/**
|
|
1291
|
-
|
|
1291
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1292
1292
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1293
1293
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1294
1294
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1295
1295
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1296
|
-
|
|
1296
|
+
*/
|
|
1297
1297
|
Url?: string;
|
|
1298
1298
|
/**
|
|
1299
|
-
|
|
1299
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1300
1300
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1301
1301
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1302
|
-
|
|
1302
|
+
*/
|
|
1303
1303
|
MaxFaceNum?: number;
|
|
1304
1304
|
/**
|
|
1305
1305
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1306
1306
|
*/
|
|
1307
1307
|
MinFaceSize?: number;
|
|
1308
1308
|
/**
|
|
1309
|
-
|
|
1309
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
1310
1310
|
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
1311
|
-
|
|
1311
|
+
*/
|
|
1312
1312
|
MaxPersonNumPerGroup?: number;
|
|
1313
1313
|
/**
|
|
1314
1314
|
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1315
1315
|
*/
|
|
1316
1316
|
NeedPersonInfo?: number;
|
|
1317
1317
|
/**
|
|
1318
|
-
|
|
1318
|
+
* 图片质量控制。
|
|
1319
1319
|
0: 不进行控制;
|
|
1320
1320
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1321
1321
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1323,13 +1323,13 @@ export interface SearchFacesReturnsByGroupRequest {
|
|
|
1323
1323
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1324
1324
|
默认 0。
|
|
1325
1325
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1326
|
-
|
|
1326
|
+
*/
|
|
1327
1327
|
QualityControl?: number;
|
|
1328
1328
|
/**
|
|
1329
|
-
|
|
1329
|
+
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
|
1330
1330
|
默认为0。
|
|
1331
1331
|
取值范围[0.0,100.0) 。
|
|
1332
|
-
|
|
1332
|
+
*/
|
|
1333
1333
|
FaceMatchThreshold?: number;
|
|
1334
1334
|
/**
|
|
1335
1335
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1401,40 +1401,40 @@ export interface RevertGroupFaceModelVersionRequest {
|
|
|
1401
1401
|
*/
|
|
1402
1402
|
export interface FaceQualityCompleteness {
|
|
1403
1403
|
/**
|
|
1404
|
-
|
|
1404
|
+
* 眉毛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1405
1405
|
参考范围:[0,80]表示发生遮挡。
|
|
1406
1406
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1407
|
-
|
|
1407
|
+
*/
|
|
1408
1408
|
Eyebrow: number;
|
|
1409
1409
|
/**
|
|
1410
|
-
|
|
1410
|
+
* 眼睛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1411
1411
|
参考范围:[0,80]表示发生遮挡。
|
|
1412
1412
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1413
|
-
|
|
1413
|
+
*/
|
|
1414
1414
|
Eye: number;
|
|
1415
1415
|
/**
|
|
1416
|
-
|
|
1416
|
+
* 鼻子的遮挡分数[0,100],分数越高遮挡越少。
|
|
1417
1417
|
参考范围:[0,60]表示发生遮挡。
|
|
1418
1418
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1419
|
-
|
|
1419
|
+
*/
|
|
1420
1420
|
Nose: number;
|
|
1421
1421
|
/**
|
|
1422
|
-
|
|
1422
|
+
* 脸颊的遮挡分数[0,100],分数越高遮挡越少。
|
|
1423
1423
|
参考范围:[0,70]表示发生遮挡。
|
|
1424
1424
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1425
|
-
|
|
1425
|
+
*/
|
|
1426
1426
|
Cheek: number;
|
|
1427
1427
|
/**
|
|
1428
|
-
|
|
1428
|
+
* 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1429
1429
|
参考范围:[0,50]表示发生遮挡。
|
|
1430
1430
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1431
|
-
|
|
1431
|
+
*/
|
|
1432
1432
|
Mouth: number;
|
|
1433
1433
|
/**
|
|
1434
|
-
|
|
1434
|
+
* 下巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1435
1435
|
参考范围:[0,70]表示发生遮挡。
|
|
1436
1436
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1437
|
-
|
|
1437
|
+
*/
|
|
1438
1438
|
Chin: number;
|
|
1439
1439
|
}
|
|
1440
1440
|
/**
|
|
@@ -1459,43 +1459,43 @@ export interface FaceAttributesInfo {
|
|
|
1459
1459
|
*/
|
|
1460
1460
|
Glass: boolean;
|
|
1461
1461
|
/**
|
|
1462
|
-
|
|
1462
|
+
* 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1463
1463
|
建议:人脸入库选择[-10,10]的图片。
|
|
1464
|
-
|
|
1464
|
+
*/
|
|
1465
1465
|
Pitch: number;
|
|
1466
1466
|
/**
|
|
1467
|
-
|
|
1467
|
+
* 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1468
1468
|
建议:人脸入库选择[-10,10]的图片。
|
|
1469
|
-
|
|
1469
|
+
*/
|
|
1470
1470
|
Yaw: number;
|
|
1471
1471
|
/**
|
|
1472
|
-
|
|
1472
|
+
* 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1473
1473
|
建议:人脸入库选择[-20,20]的图片。
|
|
1474
|
-
|
|
1474
|
+
*/
|
|
1475
1475
|
Roll: number;
|
|
1476
1476
|
/**
|
|
1477
1477
|
* 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1478
1478
|
*/
|
|
1479
1479
|
Beauty: number;
|
|
1480
1480
|
/**
|
|
1481
|
-
|
|
1481
|
+
* 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1482
1482
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1483
|
-
|
|
1483
|
+
*/
|
|
1484
1484
|
Hat: boolean;
|
|
1485
1485
|
/**
|
|
1486
|
-
|
|
1486
|
+
* 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1487
1487
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1488
|
-
|
|
1488
|
+
*/
|
|
1489
1489
|
Mask: boolean;
|
|
1490
1490
|
/**
|
|
1491
|
-
|
|
1491
|
+
* 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1492
1492
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1493
|
-
|
|
1493
|
+
*/
|
|
1494
1494
|
Hair: FaceHairAttributesInfo;
|
|
1495
1495
|
/**
|
|
1496
|
-
|
|
1496
|
+
* 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1497
1497
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1498
|
-
|
|
1498
|
+
*/
|
|
1499
1499
|
EyeOpen: boolean;
|
|
1500
1500
|
}
|
|
1501
1501
|
/**
|
|
@@ -1507,21 +1507,21 @@ export interface VerifyPersonRequest {
|
|
|
1507
1507
|
*/
|
|
1508
1508
|
PersonId: string;
|
|
1509
1509
|
/**
|
|
1510
|
-
|
|
1510
|
+
* 图片 base64 数据。
|
|
1511
1511
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1512
1512
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1513
|
-
|
|
1513
|
+
*/
|
|
1514
1514
|
Image?: string;
|
|
1515
1515
|
/**
|
|
1516
|
-
|
|
1516
|
+
* 图片的 Url 。 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1517
1517
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1518
1518
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1519
1519
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1520
1520
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1521
|
-
|
|
1521
|
+
*/
|
|
1522
1522
|
Url?: string;
|
|
1523
1523
|
/**
|
|
1524
|
-
|
|
1524
|
+
* 图片质量控制。
|
|
1525
1525
|
0: 不进行控制;
|
|
1526
1526
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1527
1527
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1529,7 +1529,7 @@ export interface VerifyPersonRequest {
|
|
|
1529
1529
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1530
1530
|
默认 0。
|
|
1531
1531
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1532
|
-
|
|
1532
|
+
*/
|
|
1533
1533
|
QualityControl?: number;
|
|
1534
1534
|
/**
|
|
1535
1535
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1558,12 +1558,12 @@ export interface ModifyPersonBaseInfoRequest {
|
|
|
1558
1558
|
*/
|
|
1559
1559
|
export interface VerifyFaceResponse {
|
|
1560
1560
|
/**
|
|
1561
|
-
|
|
1561
|
+
* 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
|
1562
1562
|
|
|
1563
1563
|
不同算法版本返回的相似度分数不同。
|
|
1564
1564
|
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1565
1565
|
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1566
|
-
|
|
1566
|
+
*/
|
|
1567
1567
|
Score: number;
|
|
1568
1568
|
/**
|
|
1569
1569
|
* 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
|
|
@@ -1587,12 +1587,12 @@ export interface FaceDetailInfo {
|
|
|
1587
1587
|
*/
|
|
1588
1588
|
FaceRect: FaceRect;
|
|
1589
1589
|
/**
|
|
1590
|
-
|
|
1590
|
+
* 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
|
|
1591
1591
|
情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
|
|
1592
1592
|
头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
|
|
1593
1593
|
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1594
1594
|
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1595
|
-
|
|
1595
|
+
*/
|
|
1596
1596
|
FaceDetailAttributesInfo: FaceDetailAttributesInfo;
|
|
1597
1597
|
}
|
|
1598
1598
|
/**
|
|
@@ -1604,40 +1604,40 @@ export interface SearchFacesRequest {
|
|
|
1604
1604
|
*/
|
|
1605
1605
|
GroupIds: Array<string>;
|
|
1606
1606
|
/**
|
|
1607
|
-
|
|
1607
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1608
1608
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1609
|
-
|
|
1609
|
+
*/
|
|
1610
1610
|
Image?: string;
|
|
1611
1611
|
/**
|
|
1612
|
-
|
|
1612
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1613
1613
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1614
1614
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1615
1615
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1616
1616
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1617
|
-
|
|
1617
|
+
*/
|
|
1618
1618
|
Url?: string;
|
|
1619
1619
|
/**
|
|
1620
|
-
|
|
1620
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1621
1621
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1622
1622
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1623
|
-
|
|
1623
|
+
*/
|
|
1624
1624
|
MaxFaceNum?: number;
|
|
1625
1625
|
/**
|
|
1626
1626
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
|
|
1627
1627
|
*/
|
|
1628
1628
|
MinFaceSize?: number;
|
|
1629
1629
|
/**
|
|
1630
|
-
|
|
1630
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1631
1631
|
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1632
1632
|
值越大,需要处理的时间越长。建议不要超过10。
|
|
1633
|
-
|
|
1633
|
+
*/
|
|
1634
1634
|
MaxPersonNum?: number;
|
|
1635
1635
|
/**
|
|
1636
1636
|
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1637
1637
|
*/
|
|
1638
1638
|
NeedPersonInfo?: number;
|
|
1639
1639
|
/**
|
|
1640
|
-
|
|
1640
|
+
* 图片质量控制。
|
|
1641
1641
|
0: 不进行控制;
|
|
1642
1642
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1643
1643
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1645,7 +1645,7 @@ export interface SearchFacesRequest {
|
|
|
1645
1645
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1646
1646
|
默认 0。
|
|
1647
1647
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1648
|
-
|
|
1648
|
+
*/
|
|
1649
1649
|
QualityControl?: number;
|
|
1650
1650
|
/**
|
|
1651
1651
|
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
@@ -1665,37 +1665,37 @@ export interface SearchPersonsRequest {
|
|
|
1665
1665
|
*/
|
|
1666
1666
|
GroupIds: Array<string>;
|
|
1667
1667
|
/**
|
|
1668
|
-
|
|
1668
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1669
1669
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1670
1670
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1671
|
-
|
|
1671
|
+
*/
|
|
1672
1672
|
Image?: string;
|
|
1673
1673
|
/**
|
|
1674
|
-
|
|
1674
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1675
1675
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1676
1676
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1677
1677
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1678
1678
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1679
|
-
|
|
1679
|
+
*/
|
|
1680
1680
|
Url?: string;
|
|
1681
1681
|
/**
|
|
1682
|
-
|
|
1682
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1683
1683
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1684
1684
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1685
|
-
|
|
1685
|
+
*/
|
|
1686
1686
|
MaxFaceNum?: number;
|
|
1687
1687
|
/**
|
|
1688
1688
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1689
1689
|
*/
|
|
1690
1690
|
MinFaceSize?: number;
|
|
1691
1691
|
/**
|
|
1692
|
-
|
|
1692
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1693
1693
|
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1694
1694
|
值越大,需要处理的时间越长。建议不要超过10。
|
|
1695
|
-
|
|
1695
|
+
*/
|
|
1696
1696
|
MaxPersonNum?: number;
|
|
1697
1697
|
/**
|
|
1698
|
-
|
|
1698
|
+
* 图片质量控制。
|
|
1699
1699
|
0: 不进行控制;
|
|
1700
1700
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1701
1701
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1703,7 +1703,7 @@ export interface SearchPersonsRequest {
|
|
|
1703
1703
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1704
1704
|
默认 0。
|
|
1705
1705
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1706
|
-
|
|
1706
|
+
*/
|
|
1707
1707
|
QualityControl?: number;
|
|
1708
1708
|
/**
|
|
1709
1709
|
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
|
|
@@ -1743,9 +1743,9 @@ export interface PersonInfo {
|
|
|
1743
1743
|
*/
|
|
1744
1744
|
FaceIds: Array<string>;
|
|
1745
1745
|
/**
|
|
1746
|
-
|
|
1746
|
+
* 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
1747
1747
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
1748
|
-
|
|
1748
|
+
*/
|
|
1749
1749
|
CreationTimestamp: number;
|
|
1750
1750
|
}
|
|
1751
1751
|
/**
|
|
@@ -1791,48 +1791,48 @@ export interface AnalyzeFaceResponse {
|
|
|
1791
1791
|
*/
|
|
1792
1792
|
export interface DetectFaceRequest {
|
|
1793
1793
|
/**
|
|
1794
|
-
|
|
1794
|
+
* 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
1795
1795
|
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1796
|
-
|
|
1796
|
+
*/
|
|
1797
1797
|
MaxFaceNum?: number;
|
|
1798
1798
|
/**
|
|
1799
|
-
|
|
1799
|
+
* 人脸长和宽的最小尺寸,单位为像素。
|
|
1800
1800
|
默认为34。建议不低于34。
|
|
1801
1801
|
低于MinFaceSize值的人脸不会被检测。
|
|
1802
|
-
|
|
1802
|
+
*/
|
|
1803
1803
|
MinFaceSize?: number;
|
|
1804
1804
|
/**
|
|
1805
|
-
|
|
1805
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1806
1806
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1807
|
-
|
|
1807
|
+
*/
|
|
1808
1808
|
Image?: string;
|
|
1809
1809
|
/**
|
|
1810
|
-
|
|
1810
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1811
1811
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1812
1812
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1813
1813
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1814
1814
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1815
|
-
|
|
1815
|
+
*/
|
|
1816
1816
|
Url?: string;
|
|
1817
1817
|
/**
|
|
1818
|
-
|
|
1818
|
+
* 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
|
|
1819
1819
|
非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
|
1820
1820
|
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
|
1821
1821
|
提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
|
1822
|
-
|
|
1822
|
+
*/
|
|
1823
1823
|
NeedFaceAttributes?: number;
|
|
1824
1824
|
/**
|
|
1825
|
-
|
|
1825
|
+
* 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
|
|
1826
1826
|
非 1 值均视为不进行质量检测。
|
|
1827
1827
|
最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
|
1828
1828
|
建议:人脸入库操作建议开启此功能。
|
|
1829
|
-
|
|
1829
|
+
*/
|
|
1830
1830
|
NeedQualityDetection?: number;
|
|
1831
1831
|
/**
|
|
1832
|
-
|
|
1832
|
+
* 人脸识别服务所用的算法模型版本。目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
1833
1833
|
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
1834
1834
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
1835
|
-
|
|
1835
|
+
*/
|
|
1836
1836
|
FaceModelVersion?: string;
|
|
1837
1837
|
/**
|
|
1838
1838
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1913,9 +1913,9 @@ export interface GetGroupListResponse {
|
|
|
1913
1913
|
*/
|
|
1914
1914
|
GroupInfos: Array<GroupInfo>;
|
|
1915
1915
|
/**
|
|
1916
|
-
|
|
1916
|
+
* 人员库总数量
|
|
1917
1917
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1918
|
-
|
|
1918
|
+
*/
|
|
1919
1919
|
GroupNum: number;
|
|
1920
1920
|
/**
|
|
1921
1921
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -1927,36 +1927,36 @@ export interface GetGroupListResponse {
|
|
|
1927
1927
|
*/
|
|
1928
1928
|
export interface DetectFaceAttributesRequest {
|
|
1929
1929
|
/**
|
|
1930
|
-
|
|
1930
|
+
* 最多处理的人脸数目。
|
|
1931
1931
|
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
1932
1932
|
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1933
|
-
|
|
1933
|
+
*/
|
|
1934
1934
|
MaxFaceNum?: number;
|
|
1935
1935
|
/**
|
|
1936
|
-
|
|
1936
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1937
1937
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1938
1938
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1939
|
-
|
|
1939
|
+
*/
|
|
1940
1940
|
Image?: string;
|
|
1941
1941
|
/**
|
|
1942
|
-
|
|
1942
|
+
* 图片的 Url 。
|
|
1943
1943
|
对应图片 base64 编码后大小不可超过5M。
|
|
1944
1944
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1945
1945
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1946
1946
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1947
1947
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1948
1948
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1949
|
-
|
|
1949
|
+
*/
|
|
1950
1950
|
Url?: string;
|
|
1951
1951
|
/**
|
|
1952
|
-
|
|
1952
|
+
* 是否返回年龄、性别、情绪等属性。
|
|
1953
1953
|
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
|
1954
1954
|
Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
|
1955
1955
|
None为不需要返回。默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
|
1956
1956
|
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
1957
1957
|
关于各属性的详细描述,参见下文出参。
|
|
1958
1958
|
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
1959
|
-
|
|
1959
|
+
*/
|
|
1960
1960
|
FaceAttributesType?: string;
|
|
1961
1961
|
/**
|
|
1962
1962
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -2005,12 +2005,12 @@ export interface GetGroupInfoResponse {
|
|
|
2005
2005
|
*/
|
|
2006
2006
|
export interface CompareFaceResponse {
|
|
2007
2007
|
/**
|
|
2008
|
-
|
|
2008
|
+
* 两张图片中人脸的相似度分数。
|
|
2009
2009
|
不同算法版本返回的相似度分数不同。
|
|
2010
2010
|
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
2011
2011
|
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
2012
2012
|
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
2013
|
-
|
|
2013
|
+
*/
|
|
2014
2014
|
Score: number;
|
|
2015
2015
|
/**
|
|
2016
2016
|
* 人脸识别所用的算法模型版本。
|
|
@@ -2026,9 +2026,9 @@ export interface CompareFaceResponse {
|
|
|
2026
2026
|
*/
|
|
2027
2027
|
export interface Mouth {
|
|
2028
2028
|
/**
|
|
2029
|
-
|
|
2029
|
+
* 是否张嘴信息。
|
|
2030
2030
|
AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
|
|
2031
|
-
|
|
2031
|
+
*/
|
|
2032
2032
|
MouthOpen: AttributeItem;
|
|
2033
2033
|
}
|
|
2034
2034
|
/**
|
|
@@ -2095,37 +2095,37 @@ export interface FaceShape {
|
|
|
2095
2095
|
*/
|
|
2096
2096
|
export interface CompareFaceRequest {
|
|
2097
2097
|
/**
|
|
2098
|
-
|
|
2098
|
+
* A 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2099
2099
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2100
2100
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2101
|
-
|
|
2101
|
+
*/
|
|
2102
2102
|
ImageA?: string;
|
|
2103
2103
|
/**
|
|
2104
|
-
|
|
2104
|
+
* B 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2105
2105
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2106
2106
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2107
|
-
|
|
2107
|
+
*/
|
|
2108
2108
|
ImageB?: string;
|
|
2109
2109
|
/**
|
|
2110
|
-
|
|
2110
|
+
* A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2111
2111
|
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2112
2112
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2113
2113
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2114
2114
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2115
2115
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2116
|
-
|
|
2116
|
+
*/
|
|
2117
2117
|
UrlA?: string;
|
|
2118
2118
|
/**
|
|
2119
|
-
|
|
2119
|
+
* B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2120
2120
|
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2121
2121
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2122
2122
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2123
2123
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2124
2124
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2125
|
-
|
|
2125
|
+
*/
|
|
2126
2126
|
UrlB?: string;
|
|
2127
2127
|
/**
|
|
2128
|
-
|
|
2128
|
+
* 人脸识别服务所用的算法模型版本。
|
|
2129
2129
|
|
|
2130
2130
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2131
2131
|
|
|
@@ -2134,10 +2134,10 @@ export interface CompareFaceRequest {
|
|
|
2134
2134
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2135
2135
|
|
|
2136
2136
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2137
|
-
|
|
2137
|
+
*/
|
|
2138
2138
|
FaceModelVersion?: string;
|
|
2139
2139
|
/**
|
|
2140
|
-
|
|
2140
|
+
* 图片质量控制。
|
|
2141
2141
|
0: 不进行控制;
|
|
2142
2142
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
2143
2143
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -2145,7 +2145,7 @@ export interface CompareFaceRequest {
|
|
|
2145
2145
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
2146
2146
|
默认 0。
|
|
2147
2147
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
2148
|
-
|
|
2148
|
+
*/
|
|
2149
2149
|
QualityControl?: number;
|
|
2150
2150
|
/**
|
|
2151
2151
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -2190,7 +2190,7 @@ export interface DetectFaceResponse {
|
|
|
2190
2190
|
*/
|
|
2191
2191
|
FaceInfos: Array<FaceInfo>;
|
|
2192
2192
|
/**
|
|
2193
|
-
|
|
2193
|
+
* 人脸识别服务所用的算法模型版本。
|
|
2194
2194
|
|
|
2195
2195
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2196
2196
|
|
|
@@ -2199,7 +2199,7 @@ export interface DetectFaceResponse {
|
|
|
2199
2199
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2200
2200
|
|
|
2201
2201
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2202
|
-
|
|
2202
|
+
*/
|
|
2203
2203
|
FaceModelVersion: string;
|
|
2204
2204
|
/**
|
|
2205
2205
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -2245,11 +2245,11 @@ export interface UpgradeJobInfo {
|
|
|
2245
2245
|
*/
|
|
2246
2246
|
ToFaceModelVersion: string;
|
|
2247
2247
|
/**
|
|
2248
|
-
|
|
2248
|
+
* 升级起始时间。
|
|
2249
2249
|
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
2250
2250
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
2251
2251
|
有关更多信息,请参阅 Unix 时间。
|
|
2252
|
-
|
|
2252
|
+
*/
|
|
2253
2253
|
StartTime: number;
|
|
2254
2254
|
/**
|
|
2255
2255
|
* 0表示升级中,1表示升级完毕,2表示回滚完毕。
|
|
@@ -2291,91 +2291,91 @@ export interface GetPersonListRequest {
|
|
|
2291
2291
|
*/
|
|
2292
2292
|
export interface FaceDetailAttributesInfo {
|
|
2293
2293
|
/**
|
|
2294
|
-
|
|
2294
|
+
* 年龄 [0,65],其中65代表“65岁及以上”。
|
|
2295
2295
|
FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2296
|
-
|
|
2296
|
+
*/
|
|
2297
2297
|
Age: number;
|
|
2298
2298
|
/**
|
|
2299
|
-
|
|
2299
|
+
* 美丑打分[0,100]。
|
|
2300
2300
|
FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2301
|
-
|
|
2301
|
+
*/
|
|
2302
2302
|
Beauty: number;
|
|
2303
2303
|
/**
|
|
2304
|
-
|
|
2304
|
+
* 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
|
2305
2305
|
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
|
|
2306
2306
|
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2307
|
-
|
|
2307
|
+
*/
|
|
2308
2308
|
Emotion: AttributeItem;
|
|
2309
2309
|
/**
|
|
2310
|
-
|
|
2310
|
+
* 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
|
2311
2311
|
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2312
|
-
|
|
2312
|
+
*/
|
|
2313
2313
|
Eye: Eye;
|
|
2314
2314
|
/**
|
|
2315
|
-
|
|
2315
|
+
* 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
|
|
2316
2316
|
FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2317
|
-
|
|
2317
|
+
*/
|
|
2318
2318
|
Eyebrow: Eyebrow;
|
|
2319
2319
|
/**
|
|
2320
|
-
|
|
2320
|
+
* 性别信息。
|
|
2321
2321
|
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2322
2322
|
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2323
|
-
|
|
2323
|
+
*/
|
|
2324
2324
|
Gender: AttributeItem;
|
|
2325
2325
|
/**
|
|
2326
|
-
|
|
2326
|
+
* 头发信息,包含头发长度、有无刘海、头发颜色。
|
|
2327
2327
|
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2328
|
-
|
|
2328
|
+
*/
|
|
2329
2329
|
Hair: Hair;
|
|
2330
2330
|
/**
|
|
2331
|
-
|
|
2331
|
+
* 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
|
2332
2332
|
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2333
|
-
|
|
2333
|
+
*/
|
|
2334
2334
|
Hat: Hat;
|
|
2335
2335
|
/**
|
|
2336
|
-
|
|
2336
|
+
* 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
|
2337
2337
|
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2338
|
-
|
|
2338
|
+
*/
|
|
2339
2339
|
HeadPose: HeadPose;
|
|
2340
2340
|
/**
|
|
2341
|
-
|
|
2341
|
+
* 口罩佩戴信息。
|
|
2342
2342
|
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2343
2343
|
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2344
|
-
|
|
2344
|
+
*/
|
|
2345
2345
|
Mask: AttributeItem;
|
|
2346
2346
|
/**
|
|
2347
|
-
|
|
2347
|
+
* 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
|
2348
2348
|
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2349
|
-
|
|
2349
|
+
*/
|
|
2350
2350
|
Mouth: Mouth;
|
|
2351
2351
|
/**
|
|
2352
|
-
|
|
2352
|
+
* 胡子信息。
|
|
2353
2353
|
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2354
2354
|
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2355
|
-
|
|
2355
|
+
*/
|
|
2356
2356
|
Moustache: AttributeItem;
|
|
2357
2357
|
/**
|
|
2358
|
-
|
|
2358
|
+
* 鼻子信息。
|
|
2359
2359
|
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2360
2360
|
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2361
|
-
|
|
2361
|
+
*/
|
|
2362
2362
|
Nose: AttributeItem;
|
|
2363
2363
|
/**
|
|
2364
|
-
|
|
2364
|
+
* 脸型信息。
|
|
2365
2365
|
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2366
2366
|
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2367
|
-
|
|
2367
|
+
*/
|
|
2368
2368
|
Shape: AttributeItem;
|
|
2369
2369
|
/**
|
|
2370
|
-
|
|
2370
|
+
* 肤色信息。
|
|
2371
2371
|
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2372
2372
|
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2373
|
-
|
|
2373
|
+
*/
|
|
2374
2374
|
Skin: AttributeItem;
|
|
2375
2375
|
/**
|
|
2376
|
-
|
|
2376
|
+
* 微笑程度,[0,100]。
|
|
2377
2377
|
FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2378
|
-
|
|
2378
|
+
*/
|
|
2379
2379
|
Smile: number;
|
|
2380
2380
|
}
|
|
2381
2381
|
/**
|
|
@@ -2396,16 +2396,16 @@ export interface AttributeItem {
|
|
|
2396
2396
|
*/
|
|
2397
2397
|
export interface FaceRect {
|
|
2398
2398
|
/**
|
|
2399
|
-
|
|
2399
|
+
* 人脸框左上角横坐标。
|
|
2400
2400
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2401
2401
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2402
|
-
|
|
2402
|
+
*/
|
|
2403
2403
|
X: number;
|
|
2404
2404
|
/**
|
|
2405
|
-
|
|
2405
|
+
* 人脸框左上角纵坐标。
|
|
2406
2406
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2407
2407
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2408
|
-
|
|
2408
|
+
*/
|
|
2409
2409
|
Y: number;
|
|
2410
2410
|
/**
|
|
2411
2411
|
* 人脸宽度
|