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,22 +160,22 @@ export interface CreatePersonRequest {
|
|
|
160
160
|
*/
|
|
161
161
|
PersonExDescriptionInfos?: Array<PersonExDescriptionInfo>;
|
|
162
162
|
/**
|
|
163
|
-
|
|
163
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
164
164
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
165
165
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
166
|
-
|
|
166
|
+
*/
|
|
167
167
|
Image?: string;
|
|
168
168
|
/**
|
|
169
|
-
|
|
169
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
170
170
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
171
171
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
172
172
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
173
173
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
174
174
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
175
|
-
|
|
175
|
+
*/
|
|
176
176
|
Url?: string;
|
|
177
177
|
/**
|
|
178
|
-
|
|
178
|
+
* 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
|
179
179
|
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
180
180
|
如果判断没有,则完成创建人员。
|
|
181
181
|
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
|
@@ -185,10 +185,10 @@ export interface CreatePersonRequest {
|
|
|
185
185
|
4: 很高的同一人判断要求(十万一误识别率)。
|
|
186
186
|
默认 0。
|
|
187
187
|
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
188
|
-
|
|
188
|
+
*/
|
|
189
189
|
UniquePersonControl?: number;
|
|
190
190
|
/**
|
|
191
|
-
|
|
191
|
+
* 图片质量控制。
|
|
192
192
|
0: 不进行控制;
|
|
193
193
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
194
194
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -196,7 +196,7 @@ export interface CreatePersonRequest {
|
|
|
196
196
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
197
197
|
默认 0。
|
|
198
198
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
199
|
-
|
|
199
|
+
*/
|
|
200
200
|
QualityControl?: number;
|
|
201
201
|
/**
|
|
202
202
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -216,16 +216,16 @@ export interface CreateFaceResponse {
|
|
|
216
216
|
*/
|
|
217
217
|
SucFaceIds: Array<string>;
|
|
218
218
|
/**
|
|
219
|
-
|
|
219
|
+
* 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
|
|
220
220
|
-1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
|
|
221
221
|
其他非 0 值代表算法服务异常。
|
|
222
222
|
RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
223
|
-
|
|
223
|
+
*/
|
|
224
224
|
RetCode: Array<number>;
|
|
225
225
|
/**
|
|
226
|
-
|
|
226
|
+
* 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
|
|
227
227
|
例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
|
228
|
-
|
|
228
|
+
*/
|
|
229
229
|
SucIndexes: Array<number>;
|
|
230
230
|
/**
|
|
231
231
|
* 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
|
|
@@ -245,19 +245,19 @@ export interface CreateFaceResponse {
|
|
|
245
245
|
*/
|
|
246
246
|
export interface FaceHairAttributesInfo {
|
|
247
247
|
/**
|
|
248
|
-
|
|
248
|
+
* 0:光头,1:短发,2:中发,3:长发,4:绑发
|
|
249
249
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
250
|
-
|
|
250
|
+
*/
|
|
251
251
|
Length: number;
|
|
252
252
|
/**
|
|
253
|
-
|
|
253
|
+
* 0:有刘海,1:无刘海
|
|
254
254
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
255
|
-
|
|
255
|
+
*/
|
|
256
256
|
Bang: number;
|
|
257
257
|
/**
|
|
258
|
-
|
|
258
|
+
* 0:黑色,1:金色,2:棕色,3:灰白色
|
|
259
259
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
260
|
-
|
|
260
|
+
*/
|
|
261
261
|
Color: number;
|
|
262
262
|
}
|
|
263
263
|
/**
|
|
@@ -269,15 +269,15 @@ export interface CreateFaceRequest {
|
|
|
269
269
|
*/
|
|
270
270
|
PersonId: string;
|
|
271
271
|
/**
|
|
272
|
-
|
|
272
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
273
273
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
274
274
|
人员人脸总数量不可超过5张。
|
|
275
275
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
276
276
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
277
|
-
|
|
277
|
+
*/
|
|
278
278
|
Images?: Array<string>;
|
|
279
279
|
/**
|
|
280
|
-
|
|
280
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
281
281
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
282
282
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
283
283
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
@@ -285,15 +285,15 @@ export interface CreateFaceRequest {
|
|
|
285
285
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
286
286
|
人员人脸总数量不可超过5张。
|
|
287
287
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
288
|
-
|
|
288
|
+
*/
|
|
289
289
|
Urls?: Array<string>;
|
|
290
290
|
/**
|
|
291
|
-
|
|
291
|
+
* 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
|
292
292
|
默认值60分。取值范围[0,100] 。
|
|
293
|
-
|
|
293
|
+
*/
|
|
294
294
|
FaceMatchThreshold?: number;
|
|
295
295
|
/**
|
|
296
|
-
|
|
296
|
+
* 图片质量控制。
|
|
297
297
|
0: 不进行控制;
|
|
298
298
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
299
299
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -301,7 +301,7 @@ export interface CreateFaceRequest {
|
|
|
301
301
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
302
302
|
默认 0。
|
|
303
303
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
304
|
-
|
|
304
|
+
*/
|
|
305
305
|
QualityControl?: number;
|
|
306
306
|
/**
|
|
307
307
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -321,21 +321,21 @@ export interface CreateGroupRequest {
|
|
|
321
321
|
*/
|
|
322
322
|
GroupId: string;
|
|
323
323
|
/**
|
|
324
|
-
|
|
324
|
+
* 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
|
325
325
|
最多可以创建5个。
|
|
326
326
|
每个自定义描述字段支持[1,30]个字符。
|
|
327
327
|
在同一人员库中自定义描述字段不可重复。
|
|
328
328
|
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
|
329
329
|
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
|
330
330
|
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
331
|
-
|
|
331
|
+
*/
|
|
332
332
|
GroupExDescriptions?: Array<string>;
|
|
333
333
|
/**
|
|
334
334
|
* 人员库信息备注,[0,40]个字符。
|
|
335
335
|
*/
|
|
336
336
|
Tag?: string;
|
|
337
337
|
/**
|
|
338
|
-
|
|
338
|
+
* 人脸识别服务所用的算法模型版本。
|
|
339
339
|
|
|
340
340
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
341
341
|
|
|
@@ -344,7 +344,7 @@ export interface CreateGroupRequest {
|
|
|
344
344
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
345
345
|
|
|
346
346
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
347
|
-
|
|
347
|
+
*/
|
|
348
348
|
FaceModelVersion?: string;
|
|
349
349
|
}
|
|
350
350
|
/**
|
|
@@ -369,16 +369,16 @@ export interface GetPersonGroupInfoRequest {
|
|
|
369
369
|
*/
|
|
370
370
|
export interface FaceInfo {
|
|
371
371
|
/**
|
|
372
|
-
|
|
372
|
+
* 人脸框左上角横坐标。
|
|
373
373
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
374
374
|
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
375
|
-
|
|
375
|
+
*/
|
|
376
376
|
X: number;
|
|
377
377
|
/**
|
|
378
|
-
|
|
378
|
+
* 人脸框左上角纵坐标。
|
|
379
379
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
380
380
|
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
381
|
-
|
|
381
|
+
*/
|
|
382
382
|
Y: number;
|
|
383
383
|
/**
|
|
384
384
|
* 人脸框宽度。
|
|
@@ -389,14 +389,14 @@ export interface FaceInfo {
|
|
|
389
389
|
*/
|
|
390
390
|
Height: number;
|
|
391
391
|
/**
|
|
392
|
-
|
|
392
|
+
* 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
|
|
393
393
|
魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
|
394
|
-
|
|
394
|
+
*/
|
|
395
395
|
FaceAttributesInfo: FaceAttributesInfo;
|
|
396
396
|
/**
|
|
397
|
-
|
|
397
|
+
* 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
|
|
398
398
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
399
|
-
|
|
399
|
+
*/
|
|
400
400
|
FaceQualityInfo: FaceQualityInfo;
|
|
401
401
|
}
|
|
402
402
|
/**
|
|
@@ -404,19 +404,19 @@ export interface FaceInfo {
|
|
|
404
404
|
*/
|
|
405
405
|
export interface Eyebrow {
|
|
406
406
|
/**
|
|
407
|
-
|
|
407
|
+
* 眉毛浓密。
|
|
408
408
|
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
409
|
-
|
|
409
|
+
*/
|
|
410
410
|
EyebrowDensity: AttributeItem;
|
|
411
411
|
/**
|
|
412
|
-
|
|
412
|
+
* 眉毛弯曲。
|
|
413
413
|
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
414
|
-
|
|
414
|
+
*/
|
|
415
415
|
EyebrowCurve: AttributeItem;
|
|
416
416
|
/**
|
|
417
|
-
|
|
417
|
+
* 眉毛长短。
|
|
418
418
|
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
419
|
-
|
|
419
|
+
*/
|
|
420
420
|
EyebrowLength: AttributeItem;
|
|
421
421
|
}
|
|
422
422
|
/**
|
|
@@ -424,25 +424,25 @@ export interface Eyebrow {
|
|
|
424
424
|
*/
|
|
425
425
|
export interface AnalyzeDenseLandmarksRequest {
|
|
426
426
|
/**
|
|
427
|
-
|
|
427
|
+
* 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
|
428
428
|
默认为 0。
|
|
429
429
|
最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
430
|
-
|
|
430
|
+
*/
|
|
431
431
|
Mode?: number;
|
|
432
432
|
/**
|
|
433
|
-
|
|
433
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
434
434
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
435
435
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
436
|
-
|
|
436
|
+
*/
|
|
437
437
|
Image?: string;
|
|
438
438
|
/**
|
|
439
|
-
|
|
439
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
440
440
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
441
441
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
442
442
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
443
443
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
444
444
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
445
|
-
|
|
445
|
+
*/
|
|
446
446
|
Url?: string;
|
|
447
447
|
/**
|
|
448
448
|
* 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
|
@@ -484,10 +484,10 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
|
|
|
484
484
|
*/
|
|
485
485
|
export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
486
486
|
/**
|
|
487
|
-
|
|
487
|
+
* 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
|
|
488
488
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
489
489
|
如果为0表示这个任务已经执行完毕。
|
|
490
|
-
|
|
490
|
+
*/
|
|
491
491
|
EndTimestamp: number;
|
|
492
492
|
/**
|
|
493
493
|
* 升级任务完成进度。取值[0.0,100.0]。
|
|
@@ -498,11 +498,11 @@ export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
|
498
498
|
*/
|
|
499
499
|
Status: number;
|
|
500
500
|
/**
|
|
501
|
-
|
|
501
|
+
* 升级起始时间。
|
|
502
502
|
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
503
503
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
504
504
|
有关更多信息,请参阅 Unix 时间。
|
|
505
|
-
|
|
505
|
+
*/
|
|
506
506
|
StartTime: number;
|
|
507
507
|
/**
|
|
508
508
|
* 当前算法模型版本。
|
|
@@ -551,22 +551,22 @@ export interface AnalyzeFaceRequest {
|
|
|
551
551
|
*/
|
|
552
552
|
Mode?: number;
|
|
553
553
|
/**
|
|
554
|
-
|
|
554
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
555
555
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
556
556
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
557
|
-
|
|
557
|
+
*/
|
|
558
558
|
Image?: string;
|
|
559
559
|
/**
|
|
560
|
-
|
|
560
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
561
561
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
562
562
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
563
563
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
564
564
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
565
565
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
566
|
-
|
|
566
|
+
*/
|
|
567
567
|
Url?: string;
|
|
568
568
|
/**
|
|
569
|
-
|
|
569
|
+
* 人脸识别服务所用的算法模型版本。
|
|
570
570
|
|
|
571
571
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
572
572
|
|
|
@@ -575,7 +575,7 @@ export interface AnalyzeFaceRequest {
|
|
|
575
575
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
576
576
|
|
|
577
577
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
578
|
-
|
|
578
|
+
*/
|
|
579
579
|
FaceModelVersion?: string;
|
|
580
580
|
/**
|
|
581
581
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -591,14 +591,14 @@ export interface CreatePersonResponse {
|
|
|
591
591
|
*/
|
|
592
592
|
FaceId: string;
|
|
593
593
|
/**
|
|
594
|
-
|
|
594
|
+
* 检测出的人脸框的位置。
|
|
595
595
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
596
|
-
|
|
596
|
+
*/
|
|
597
597
|
FaceRect: FaceRect;
|
|
598
598
|
/**
|
|
599
|
-
|
|
599
|
+
* 疑似同一人的PersonId。
|
|
600
600
|
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
601
|
-
|
|
601
|
+
*/
|
|
602
602
|
SimilarPersonId: string;
|
|
603
603
|
/**
|
|
604
604
|
* 人脸识别所用的算法模型版本。
|
|
@@ -691,18 +691,18 @@ export interface DeletePersonRequest {
|
|
|
691
691
|
*/
|
|
692
692
|
export interface DetectLiveFaceResponse {
|
|
693
693
|
/**
|
|
694
|
-
|
|
694
|
+
* 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
|
|
695
695
|
本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
|
|
696
|
-
|
|
696
|
+
*/
|
|
697
697
|
Score: number;
|
|
698
698
|
/**
|
|
699
699
|
* 人脸识别所用的算法模型版本。
|
|
700
700
|
*/
|
|
701
701
|
FaceModelVersion: string;
|
|
702
702
|
/**
|
|
703
|
-
|
|
703
|
+
* 活体检测是否通过。
|
|
704
704
|
本字段只有FaceModelVersion为3.0时才具备参考意义。
|
|
705
|
-
|
|
705
|
+
*/
|
|
706
706
|
IsLiveness: boolean;
|
|
707
707
|
/**
|
|
708
708
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -770,23 +770,23 @@ export interface UpgradeGroupFaceModelVersionRequest {
|
|
|
770
770
|
*/
|
|
771
771
|
export interface DetectLiveFaceRequest {
|
|
772
772
|
/**
|
|
773
|
-
|
|
773
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
774
774
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
|
|
775
775
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
776
|
-
|
|
776
|
+
*/
|
|
777
777
|
Image?: string;
|
|
778
778
|
/**
|
|
779
|
-
|
|
779
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
780
780
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
781
781
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
782
782
|
(图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
|
|
783
783
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
784
784
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
785
785
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
786
|
-
|
|
786
|
+
*/
|
|
787
787
|
Url?: string;
|
|
788
788
|
/**
|
|
789
|
-
|
|
789
|
+
* 人脸识别服务所用的算法模型版本。
|
|
790
790
|
|
|
791
791
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
792
792
|
|
|
@@ -795,7 +795,7 @@ export interface DetectLiveFaceRequest {
|
|
|
795
795
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
796
796
|
|
|
797
797
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
798
|
-
|
|
798
|
+
*/
|
|
799
799
|
FaceModelVersion?: string;
|
|
800
800
|
}
|
|
801
801
|
/**
|
|
@@ -832,9 +832,9 @@ export interface SearchPersonsResponse {
|
|
|
832
832
|
*/
|
|
833
833
|
PersonNum: number;
|
|
834
834
|
/**
|
|
835
|
-
|
|
835
|
+
* 人脸识别所用的算法模型版本。
|
|
836
836
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
837
|
-
|
|
837
|
+
*/
|
|
838
838
|
FaceModelVersion: string;
|
|
839
839
|
/**
|
|
840
840
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -863,25 +863,25 @@ export interface GroupInfo {
|
|
|
863
863
|
*/
|
|
864
864
|
GroupId: string;
|
|
865
865
|
/**
|
|
866
|
-
|
|
866
|
+
* 人员库自定义描述字段
|
|
867
867
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
868
|
-
|
|
868
|
+
*/
|
|
869
869
|
GroupExDescriptions: Array<string>;
|
|
870
870
|
/**
|
|
871
|
-
|
|
871
|
+
* 人员库信息备注
|
|
872
872
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
873
|
-
|
|
873
|
+
*/
|
|
874
874
|
Tag: string;
|
|
875
875
|
/**
|
|
876
|
-
|
|
876
|
+
* 人脸识别所用的算法模型版本。
|
|
877
877
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
878
|
-
|
|
878
|
+
*/
|
|
879
879
|
FaceModelVersion: string;
|
|
880
880
|
/**
|
|
881
|
-
|
|
881
|
+
* Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
882
882
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
883
883
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
884
|
-
|
|
884
|
+
*/
|
|
885
885
|
CreationTimestamp: number;
|
|
886
886
|
}
|
|
887
887
|
/**
|
|
@@ -889,31 +889,31 @@ export interface GroupInfo {
|
|
|
889
889
|
*/
|
|
890
890
|
export interface FaceQualityInfo {
|
|
891
891
|
/**
|
|
892
|
-
|
|
892
|
+
* 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
|
893
893
|
正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
|
894
894
|
参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
|
895
895
|
建议:人脸入库选取70以上的图片。
|
|
896
896
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
897
|
-
|
|
897
|
+
*/
|
|
898
898
|
Score: number;
|
|
899
899
|
/**
|
|
900
|
-
|
|
900
|
+
* 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
|
|
901
901
|
参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
|
902
902
|
建议:人脸入库选取80以上的图片。
|
|
903
903
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
904
|
-
|
|
904
|
+
*/
|
|
905
905
|
Sharpness: number;
|
|
906
906
|
/**
|
|
907
|
-
|
|
907
|
+
* 光照分:[0,100],评价图片光照程度,分数越高越亮。
|
|
908
908
|
参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
|
909
909
|
建议:人脸入库选取[30,70]的图片。
|
|
910
910
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
911
|
-
|
|
911
|
+
*/
|
|
912
912
|
Brightness: number;
|
|
913
913
|
/**
|
|
914
|
-
|
|
914
|
+
* 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
|
915
915
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
916
|
-
|
|
916
|
+
*/
|
|
917
917
|
Completeness: FaceQualityCompleteness;
|
|
918
918
|
}
|
|
919
919
|
/**
|
|
@@ -959,37 +959,37 @@ export interface SearchPersonsReturnsByGroupRequest {
|
|
|
959
959
|
*/
|
|
960
960
|
GroupIds: Array<string>;
|
|
961
961
|
/**
|
|
962
|
-
|
|
962
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
963
963
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
964
964
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
965
|
-
|
|
965
|
+
*/
|
|
966
966
|
Image?: string;
|
|
967
967
|
/**
|
|
968
|
-
|
|
968
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
969
969
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
970
970
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
971
971
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
972
972
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
973
973
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
974
|
-
|
|
974
|
+
*/
|
|
975
975
|
Url?: string;
|
|
976
976
|
/**
|
|
977
|
-
|
|
977
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
978
978
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
979
979
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
980
|
-
|
|
980
|
+
*/
|
|
981
981
|
MaxFaceNum?: number;
|
|
982
982
|
/**
|
|
983
983
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
984
984
|
*/
|
|
985
985
|
MinFaceSize?: number;
|
|
986
986
|
/**
|
|
987
|
-
|
|
987
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
988
988
|
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
989
|
-
|
|
989
|
+
*/
|
|
990
990
|
MaxPersonNumPerGroup?: number;
|
|
991
991
|
/**
|
|
992
|
-
|
|
992
|
+
* 图片质量控制。
|
|
993
993
|
0: 不进行控制;
|
|
994
994
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
995
995
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -997,7 +997,7 @@ export interface SearchPersonsReturnsByGroupRequest {
|
|
|
997
997
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
998
998
|
默认 0。
|
|
999
999
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1000
|
-
|
|
1000
|
+
*/
|
|
1001
1001
|
QualityControl?: number;
|
|
1002
1002
|
/**
|
|
1003
1003
|
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
@@ -1112,9 +1112,9 @@ export interface ResultsReturnsByGroup {
|
|
|
1112
1112
|
*/
|
|
1113
1113
|
GroupCandidates: Array<GroupCandidate>;
|
|
1114
1114
|
/**
|
|
1115
|
-
|
|
1115
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1116
1116
|
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1117
|
-
|
|
1117
|
+
*/
|
|
1118
1118
|
RetCode: number;
|
|
1119
1119
|
}
|
|
1120
1120
|
/**
|
|
@@ -1169,24 +1169,24 @@ export interface VerifyFaceRequest {
|
|
|
1169
1169
|
*/
|
|
1170
1170
|
PersonId: string;
|
|
1171
1171
|
/**
|
|
1172
|
-
|
|
1172
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1173
1173
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1174
1174
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1175
1175
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1176
|
-
|
|
1176
|
+
*/
|
|
1177
1177
|
Image?: string;
|
|
1178
1178
|
/**
|
|
1179
|
-
|
|
1179
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1180
1180
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1181
1181
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1182
1182
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1183
1183
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1184
1184
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1185
1185
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1186
|
-
|
|
1186
|
+
*/
|
|
1187
1187
|
Url?: string;
|
|
1188
1188
|
/**
|
|
1189
|
-
|
|
1189
|
+
* 图片质量控制。
|
|
1190
1190
|
0: 不进行控制;
|
|
1191
1191
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1192
1192
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1194,7 +1194,7 @@ export interface VerifyFaceRequest {
|
|
|
1194
1194
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1195
1195
|
默认 0。
|
|
1196
1196
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1197
|
-
|
|
1197
|
+
*/
|
|
1198
1198
|
QualityControl?: number;
|
|
1199
1199
|
/**
|
|
1200
1200
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1210,19 +1210,19 @@ export interface GetPersonListResponse {
|
|
|
1210
1210
|
*/
|
|
1211
1211
|
PersonInfos?: Array<PersonInfo>;
|
|
1212
1212
|
/**
|
|
1213
|
-
|
|
1213
|
+
* 该人员库的人员数量
|
|
1214
1214
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1215
|
-
|
|
1215
|
+
*/
|
|
1216
1216
|
PersonNum?: number;
|
|
1217
1217
|
/**
|
|
1218
|
-
|
|
1218
|
+
* 该人员库的人脸数量
|
|
1219
1219
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1220
|
-
|
|
1220
|
+
*/
|
|
1221
1221
|
FaceNum?: number;
|
|
1222
1222
|
/**
|
|
1223
|
-
|
|
1223
|
+
* 人脸识别所用的算法模型版本。
|
|
1224
1224
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1225
|
-
|
|
1225
|
+
*/
|
|
1226
1226
|
FaceModelVersion?: string;
|
|
1227
1227
|
/**
|
|
1228
1228
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -1234,19 +1234,19 @@ export interface GetPersonListResponse {
|
|
|
1234
1234
|
*/
|
|
1235
1235
|
export interface Hair {
|
|
1236
1236
|
/**
|
|
1237
|
-
|
|
1237
|
+
* 头发长度信息。
|
|
1238
1238
|
AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
|
|
1239
|
-
|
|
1239
|
+
*/
|
|
1240
1240
|
Length: AttributeItem;
|
|
1241
1241
|
/**
|
|
1242
|
-
|
|
1242
|
+
* 刘海信息。
|
|
1243
1243
|
AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
|
|
1244
|
-
|
|
1244
|
+
*/
|
|
1245
1245
|
Bang: AttributeItem;
|
|
1246
1246
|
/**
|
|
1247
|
-
|
|
1247
|
+
* 头发颜色信息。
|
|
1248
1248
|
AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
|
|
1249
|
-
|
|
1249
|
+
*/
|
|
1250
1250
|
Color: AttributeItem;
|
|
1251
1251
|
}
|
|
1252
1252
|
/**
|
|
@@ -1262,9 +1262,9 @@ export interface Result {
|
|
|
1262
1262
|
*/
|
|
1263
1263
|
FaceRect: FaceRect;
|
|
1264
1264
|
/**
|
|
1265
|
-
|
|
1265
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1266
1266
|
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1267
|
-
|
|
1267
|
+
*/
|
|
1268
1268
|
RetCode: number;
|
|
1269
1269
|
}
|
|
1270
1270
|
/**
|
|
@@ -1276,14 +1276,14 @@ export interface GetPersonGroupInfoResponse {
|
|
|
1276
1276
|
*/
|
|
1277
1277
|
PersonGroupInfos?: Array<PersonGroupInfo>;
|
|
1278
1278
|
/**
|
|
1279
|
-
|
|
1279
|
+
* 人员库总数量
|
|
1280
1280
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1281
|
-
|
|
1281
|
+
*/
|
|
1282
1282
|
GroupNum?: number;
|
|
1283
1283
|
/**
|
|
1284
|
-
|
|
1284
|
+
* 人脸识别服务所用的算法模型版本。
|
|
1285
1285
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1286
|
-
|
|
1286
|
+
*/
|
|
1287
1287
|
FaceModelVersion?: string;
|
|
1288
1288
|
/**
|
|
1289
1289
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -1308,46 +1308,46 @@ export interface UpgradeGroupFaceModelVersionResponse {
|
|
|
1308
1308
|
*/
|
|
1309
1309
|
export interface SearchFacesReturnsByGroupRequest {
|
|
1310
1310
|
/**
|
|
1311
|
-
|
|
1311
|
+
* 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
|
|
1312
1312
|
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1313
|
-
|
|
1313
|
+
*/
|
|
1314
1314
|
GroupIds: Array<string>;
|
|
1315
1315
|
/**
|
|
1316
|
-
|
|
1316
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1317
1317
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1318
1318
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1319
|
-
|
|
1319
|
+
*/
|
|
1320
1320
|
Image?: string;
|
|
1321
1321
|
/**
|
|
1322
|
-
|
|
1322
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1323
1323
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1324
1324
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1325
1325
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1326
1326
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1327
1327
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1328
|
-
|
|
1328
|
+
*/
|
|
1329
1329
|
Url?: string;
|
|
1330
1330
|
/**
|
|
1331
|
-
|
|
1331
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1332
1332
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1333
1333
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1334
|
-
|
|
1334
|
+
*/
|
|
1335
1335
|
MaxFaceNum?: number;
|
|
1336
1336
|
/**
|
|
1337
1337
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1338
1338
|
*/
|
|
1339
1339
|
MinFaceSize?: number;
|
|
1340
1340
|
/**
|
|
1341
|
-
|
|
1341
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
1342
1342
|
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
1343
|
-
|
|
1343
|
+
*/
|
|
1344
1344
|
MaxPersonNumPerGroup?: number;
|
|
1345
1345
|
/**
|
|
1346
1346
|
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1347
1347
|
*/
|
|
1348
1348
|
NeedPersonInfo?: number;
|
|
1349
1349
|
/**
|
|
1350
|
-
|
|
1350
|
+
* 图片质量控制。
|
|
1351
1351
|
0: 不进行控制;
|
|
1352
1352
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1353
1353
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1355,13 +1355,13 @@ export interface SearchFacesReturnsByGroupRequest {
|
|
|
1355
1355
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1356
1356
|
默认 0。
|
|
1357
1357
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1358
|
-
|
|
1358
|
+
*/
|
|
1359
1359
|
QualityControl?: number;
|
|
1360
1360
|
/**
|
|
1361
|
-
|
|
1361
|
+
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
|
1362
1362
|
默认为0。
|
|
1363
1363
|
取值范围[0.0,100.0) 。
|
|
1364
|
-
|
|
1364
|
+
*/
|
|
1365
1365
|
FaceMatchThreshold?: number;
|
|
1366
1366
|
/**
|
|
1367
1367
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1433,40 +1433,40 @@ export interface RevertGroupFaceModelVersionRequest {
|
|
|
1433
1433
|
*/
|
|
1434
1434
|
export interface FaceQualityCompleteness {
|
|
1435
1435
|
/**
|
|
1436
|
-
|
|
1436
|
+
* 眉毛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1437
1437
|
参考范围:[0,80]表示发生遮挡。
|
|
1438
1438
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1439
|
-
|
|
1439
|
+
*/
|
|
1440
1440
|
Eyebrow: number;
|
|
1441
1441
|
/**
|
|
1442
|
-
|
|
1442
|
+
* 眼睛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1443
1443
|
参考范围:[0,80]表示发生遮挡。
|
|
1444
1444
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1445
|
-
|
|
1445
|
+
*/
|
|
1446
1446
|
Eye: number;
|
|
1447
1447
|
/**
|
|
1448
|
-
|
|
1448
|
+
* 鼻子的遮挡分数[0,100],分数越高遮挡越少。
|
|
1449
1449
|
参考范围:[0,60]表示发生遮挡。
|
|
1450
1450
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1451
|
-
|
|
1451
|
+
*/
|
|
1452
1452
|
Nose: number;
|
|
1453
1453
|
/**
|
|
1454
|
-
|
|
1454
|
+
* 脸颊的遮挡分数[0,100],分数越高遮挡越少。
|
|
1455
1455
|
参考范围:[0,70]表示发生遮挡。
|
|
1456
1456
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1457
|
-
|
|
1457
|
+
*/
|
|
1458
1458
|
Cheek: number;
|
|
1459
1459
|
/**
|
|
1460
|
-
|
|
1460
|
+
* 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1461
1461
|
参考范围:[0,50]表示发生遮挡。
|
|
1462
1462
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1463
|
-
|
|
1463
|
+
*/
|
|
1464
1464
|
Mouth: number;
|
|
1465
1465
|
/**
|
|
1466
|
-
|
|
1466
|
+
* 下巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1467
1467
|
参考范围:[0,70]表示发生遮挡。
|
|
1468
1468
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1469
|
-
|
|
1469
|
+
*/
|
|
1470
1470
|
Chin: number;
|
|
1471
1471
|
}
|
|
1472
1472
|
/**
|
|
@@ -1491,43 +1491,43 @@ export interface FaceAttributesInfo {
|
|
|
1491
1491
|
*/
|
|
1492
1492
|
Glass: boolean;
|
|
1493
1493
|
/**
|
|
1494
|
-
|
|
1494
|
+
* 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1495
1495
|
建议:人脸入库选择[-10,10]的图片。
|
|
1496
|
-
|
|
1496
|
+
*/
|
|
1497
1497
|
Pitch: number;
|
|
1498
1498
|
/**
|
|
1499
|
-
|
|
1499
|
+
* 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1500
1500
|
建议:人脸入库选择[-10,10]的图片。
|
|
1501
|
-
|
|
1501
|
+
*/
|
|
1502
1502
|
Yaw: number;
|
|
1503
1503
|
/**
|
|
1504
|
-
|
|
1504
|
+
* 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1505
1505
|
建议:人脸入库选择[-20,20]的图片。
|
|
1506
|
-
|
|
1506
|
+
*/
|
|
1507
1507
|
Roll: number;
|
|
1508
1508
|
/**
|
|
1509
1509
|
* 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1510
1510
|
*/
|
|
1511
1511
|
Beauty: number;
|
|
1512
1512
|
/**
|
|
1513
|
-
|
|
1513
|
+
* 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1514
1514
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1515
|
-
|
|
1515
|
+
*/
|
|
1516
1516
|
Hat: boolean;
|
|
1517
1517
|
/**
|
|
1518
|
-
|
|
1518
|
+
* 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1519
1519
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1520
|
-
|
|
1520
|
+
*/
|
|
1521
1521
|
Mask: boolean;
|
|
1522
1522
|
/**
|
|
1523
|
-
|
|
1523
|
+
* 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1524
1524
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1525
|
-
|
|
1525
|
+
*/
|
|
1526
1526
|
Hair: FaceHairAttributesInfo;
|
|
1527
1527
|
/**
|
|
1528
|
-
|
|
1528
|
+
* 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1529
1529
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1530
|
-
|
|
1530
|
+
*/
|
|
1531
1531
|
EyeOpen: boolean;
|
|
1532
1532
|
}
|
|
1533
1533
|
/**
|
|
@@ -1539,24 +1539,24 @@ export interface VerifyPersonRequest {
|
|
|
1539
1539
|
*/
|
|
1540
1540
|
PersonId: string;
|
|
1541
1541
|
/**
|
|
1542
|
-
|
|
1542
|
+
* 图片 base64 数据。
|
|
1543
1543
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1544
1544
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1545
1545
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1546
|
-
|
|
1546
|
+
*/
|
|
1547
1547
|
Image?: string;
|
|
1548
1548
|
/**
|
|
1549
|
-
|
|
1549
|
+
* 图片的 Url
|
|
1550
1550
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
|
|
1551
1551
|
图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1552
1552
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1553
1553
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1554
1554
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1555
1555
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1556
|
-
|
|
1556
|
+
*/
|
|
1557
1557
|
Url?: string;
|
|
1558
1558
|
/**
|
|
1559
|
-
|
|
1559
|
+
* 图片质量控制。
|
|
1560
1560
|
0: 不进行控制;
|
|
1561
1561
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1562
1562
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1564,7 +1564,7 @@ export interface VerifyPersonRequest {
|
|
|
1564
1564
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1565
1565
|
默认 0。
|
|
1566
1566
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1567
|
-
|
|
1567
|
+
*/
|
|
1568
1568
|
QualityControl?: number;
|
|
1569
1569
|
/**
|
|
1570
1570
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -1576,12 +1576,12 @@ export interface VerifyPersonRequest {
|
|
|
1576
1576
|
*/
|
|
1577
1577
|
export interface CompareMaskFaceResponse {
|
|
1578
1578
|
/**
|
|
1579
|
-
|
|
1579
|
+
* 两张图片中人脸的相似度分数。
|
|
1580
1580
|
不同算法版本返回的相似度分数不同。
|
|
1581
1581
|
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1582
1582
|
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1583
1583
|
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
1584
|
-
|
|
1584
|
+
*/
|
|
1585
1585
|
Score: number;
|
|
1586
1586
|
/**
|
|
1587
1587
|
* 人脸识别所用的算法模型版本。
|
|
@@ -1614,22 +1614,22 @@ export interface ModifyPersonBaseInfoRequest {
|
|
|
1614
1614
|
*/
|
|
1615
1615
|
export interface DetectLiveFaceAccurateRequest {
|
|
1616
1616
|
/**
|
|
1617
|
-
|
|
1617
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1618
1618
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1619
1619
|
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1620
1620
|
人脸尺寸大于100X100像素。
|
|
1621
1621
|
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1622
|
-
|
|
1622
|
+
*/
|
|
1623
1623
|
Image?: string;
|
|
1624
1624
|
/**
|
|
1625
|
-
|
|
1625
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1626
1626
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1627
1627
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1628
1628
|
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1629
1629
|
人脸尺寸大于100X100像素。
|
|
1630
1630
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1631
1631
|
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1632
|
-
|
|
1632
|
+
*/
|
|
1633
1633
|
Url?: string;
|
|
1634
1634
|
/**
|
|
1635
1635
|
* 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
|
|
@@ -1641,12 +1641,12 @@ export interface DetectLiveFaceAccurateRequest {
|
|
|
1641
1641
|
*/
|
|
1642
1642
|
export interface VerifyFaceResponse {
|
|
1643
1643
|
/**
|
|
1644
|
-
|
|
1644
|
+
* 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
|
1645
1645
|
|
|
1646
1646
|
不同算法版本返回的相似度分数不同。
|
|
1647
1647
|
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1648
1648
|
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1649
|
-
|
|
1649
|
+
*/
|
|
1650
1650
|
Score: number;
|
|
1651
1651
|
/**
|
|
1652
1652
|
* 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
|
|
@@ -1670,12 +1670,12 @@ export interface FaceDetailInfo {
|
|
|
1670
1670
|
*/
|
|
1671
1671
|
FaceRect: FaceRect;
|
|
1672
1672
|
/**
|
|
1673
|
-
|
|
1673
|
+
* 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
|
|
1674
1674
|
情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
|
|
1675
1675
|
头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
|
|
1676
1676
|
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1677
1677
|
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1678
|
-
|
|
1678
|
+
*/
|
|
1679
1679
|
FaceDetailAttributesInfo: FaceDetailAttributesInfo;
|
|
1680
1680
|
}
|
|
1681
1681
|
/**
|
|
@@ -1683,47 +1683,47 @@ export interface FaceDetailInfo {
|
|
|
1683
1683
|
*/
|
|
1684
1684
|
export interface SearchFacesRequest {
|
|
1685
1685
|
/**
|
|
1686
|
-
|
|
1686
|
+
* 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
|
|
1687
1687
|
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1688
|
-
|
|
1688
|
+
*/
|
|
1689
1689
|
GroupIds: Array<string>;
|
|
1690
1690
|
/**
|
|
1691
|
-
|
|
1691
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1692
1692
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1693
1693
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1694
|
-
|
|
1694
|
+
*/
|
|
1695
1695
|
Image?: string;
|
|
1696
1696
|
/**
|
|
1697
|
-
|
|
1697
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1698
1698
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1699
1699
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1700
1700
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1701
1701
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1702
1702
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1703
|
-
|
|
1703
|
+
*/
|
|
1704
1704
|
Url?: string;
|
|
1705
1705
|
/**
|
|
1706
|
-
|
|
1706
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1707
1707
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1708
1708
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1709
|
-
|
|
1709
|
+
*/
|
|
1710
1710
|
MaxFaceNum?: number;
|
|
1711
1711
|
/**
|
|
1712
1712
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
|
|
1713
1713
|
*/
|
|
1714
1714
|
MinFaceSize?: number;
|
|
1715
1715
|
/**
|
|
1716
|
-
|
|
1716
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1717
1717
|
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1718
1718
|
值越大,需要处理的时间越长。建议不要超过10。
|
|
1719
|
-
|
|
1719
|
+
*/
|
|
1720
1720
|
MaxPersonNum?: number;
|
|
1721
1721
|
/**
|
|
1722
1722
|
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1723
1723
|
*/
|
|
1724
1724
|
NeedPersonInfo?: number;
|
|
1725
1725
|
/**
|
|
1726
|
-
|
|
1726
|
+
* 图片质量控制。
|
|
1727
1727
|
0: 不进行控制;
|
|
1728
1728
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1729
1729
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1731,7 +1731,7 @@ export interface SearchFacesRequest {
|
|
|
1731
1731
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1732
1732
|
默认 0。
|
|
1733
1733
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1734
|
-
|
|
1734
|
+
*/
|
|
1735
1735
|
QualityControl?: number;
|
|
1736
1736
|
/**
|
|
1737
1737
|
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
@@ -1751,39 +1751,39 @@ export interface SearchPersonsRequest {
|
|
|
1751
1751
|
*/
|
|
1752
1752
|
GroupIds: Array<string>;
|
|
1753
1753
|
/**
|
|
1754
|
-
|
|
1754
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1755
1755
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1756
1756
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1757
1757
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1758
|
-
|
|
1758
|
+
*/
|
|
1759
1759
|
Image?: string;
|
|
1760
1760
|
/**
|
|
1761
|
-
|
|
1761
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1762
1762
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1763
1763
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1764
1764
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1765
1765
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1766
1766
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1767
|
-
|
|
1767
|
+
*/
|
|
1768
1768
|
Url?: string;
|
|
1769
1769
|
/**
|
|
1770
|
-
|
|
1770
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1771
1771
|
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1772
1772
|
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1773
|
-
|
|
1773
|
+
*/
|
|
1774
1774
|
MaxFaceNum?: number;
|
|
1775
1775
|
/**
|
|
1776
1776
|
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1777
1777
|
*/
|
|
1778
1778
|
MinFaceSize?: number;
|
|
1779
1779
|
/**
|
|
1780
|
-
|
|
1780
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1781
1781
|
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1782
1782
|
值越大,需要处理的时间越长。建议不要超过10。
|
|
1783
|
-
|
|
1783
|
+
*/
|
|
1784
1784
|
MaxPersonNum?: number;
|
|
1785
1785
|
/**
|
|
1786
|
-
|
|
1786
|
+
* 图片质量控制。
|
|
1787
1787
|
0: 不进行控制;
|
|
1788
1788
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1789
1789
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1791,7 +1791,7 @@ export interface SearchPersonsRequest {
|
|
|
1791
1791
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1792
1792
|
默认 0。
|
|
1793
1793
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1794
|
-
|
|
1794
|
+
*/
|
|
1795
1795
|
QualityControl?: number;
|
|
1796
1796
|
/**
|
|
1797
1797
|
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
|
|
@@ -1831,9 +1831,9 @@ export interface PersonInfo {
|
|
|
1831
1831
|
*/
|
|
1832
1832
|
FaceIds: Array<string>;
|
|
1833
1833
|
/**
|
|
1834
|
-
|
|
1834
|
+
* 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
|
1835
1835
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
1836
|
-
|
|
1836
|
+
*/
|
|
1837
1837
|
CreationTimestamp: number;
|
|
1838
1838
|
}
|
|
1839
1839
|
/**
|
|
@@ -1854,45 +1854,45 @@ export interface GroupExDescriptionInfo {
|
|
|
1854
1854
|
*/
|
|
1855
1855
|
export interface CompareMaskFaceRequest {
|
|
1856
1856
|
/**
|
|
1857
|
-
|
|
1857
|
+
* A 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1858
1858
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1859
1859
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1860
1860
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1861
|
-
|
|
1861
|
+
*/
|
|
1862
1862
|
ImageA?: string;
|
|
1863
1863
|
/**
|
|
1864
|
-
|
|
1864
|
+
* B 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1865
1865
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1866
1866
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1867
1867
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1868
|
-
|
|
1868
|
+
*/
|
|
1869
1869
|
ImageB?: string;
|
|
1870
1870
|
/**
|
|
1871
|
-
|
|
1871
|
+
* A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
1872
1872
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1873
1873
|
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1874
1874
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1875
1875
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1876
1876
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1877
1877
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1878
|
-
|
|
1878
|
+
*/
|
|
1879
1879
|
UrlA?: string;
|
|
1880
1880
|
/**
|
|
1881
|
-
|
|
1881
|
+
* B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
1882
1882
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1883
1883
|
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1884
1884
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1885
1885
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1886
1886
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1887
1887
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1888
|
-
|
|
1888
|
+
*/
|
|
1889
1889
|
UrlB?: string;
|
|
1890
1890
|
/**
|
|
1891
1891
|
* 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
|
|
1892
1892
|
*/
|
|
1893
1893
|
FaceModelVersion?: string;
|
|
1894
1894
|
/**
|
|
1895
|
-
|
|
1895
|
+
* 图片质量控制。
|
|
1896
1896
|
0: 不进行控制;
|
|
1897
1897
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1898
1898
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -1900,7 +1900,7 @@ export interface CompareMaskFaceRequest {
|
|
|
1900
1900
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1901
1901
|
默认 0。
|
|
1902
1902
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1903
|
-
|
|
1903
|
+
*/
|
|
1904
1904
|
QualityControl?: number;
|
|
1905
1905
|
}
|
|
1906
1906
|
/**
|
|
@@ -1933,47 +1933,47 @@ export interface AnalyzeFaceResponse {
|
|
|
1933
1933
|
*/
|
|
1934
1934
|
export interface DetectFaceRequest {
|
|
1935
1935
|
/**
|
|
1936
|
-
|
|
1936
|
+
* 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
1937
1937
|
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1938
|
-
|
|
1938
|
+
*/
|
|
1939
1939
|
MaxFaceNum?: number;
|
|
1940
1940
|
/**
|
|
1941
|
-
|
|
1941
|
+
* 人脸长和宽的最小尺寸,单位为像素。
|
|
1942
1942
|
默认为34。建议不低于34。
|
|
1943
1943
|
低于MinFaceSize值的人脸不会被检测。
|
|
1944
|
-
|
|
1944
|
+
*/
|
|
1945
1945
|
MinFaceSize?: number;
|
|
1946
1946
|
/**
|
|
1947
|
-
|
|
1947
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1948
1948
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1949
1949
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1950
|
-
|
|
1950
|
+
*/
|
|
1951
1951
|
Image?: string;
|
|
1952
1952
|
/**
|
|
1953
|
-
|
|
1953
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1954
1954
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1955
1955
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1956
1956
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1957
1957
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1958
1958
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1959
|
-
|
|
1959
|
+
*/
|
|
1960
1960
|
Url?: string;
|
|
1961
1961
|
/**
|
|
1962
|
-
|
|
1962
|
+
* 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
|
|
1963
1963
|
非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
|
1964
1964
|
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
|
1965
1965
|
提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
|
1966
|
-
|
|
1966
|
+
*/
|
|
1967
1967
|
NeedFaceAttributes?: number;
|
|
1968
1968
|
/**
|
|
1969
|
-
|
|
1969
|
+
* 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
|
|
1970
1970
|
非 1 值均视为不进行质量检测。
|
|
1971
1971
|
最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
|
1972
1972
|
建议:人脸入库操作建议开启此功能。
|
|
1973
|
-
|
|
1973
|
+
*/
|
|
1974
1974
|
NeedQualityDetection?: number;
|
|
1975
1975
|
/**
|
|
1976
|
-
|
|
1976
|
+
* 人脸识别服务所用的算法模型版本。
|
|
1977
1977
|
|
|
1978
1978
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
1979
1979
|
|
|
@@ -1982,7 +1982,7 @@ export interface DetectFaceRequest {
|
|
|
1982
1982
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
1983
1983
|
|
|
1984
1984
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
1985
|
-
|
|
1985
|
+
*/
|
|
1986
1986
|
FaceModelVersion?: string;
|
|
1987
1987
|
/**
|
|
1988
1988
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -2063,9 +2063,9 @@ export interface GetGroupListResponse {
|
|
|
2063
2063
|
*/
|
|
2064
2064
|
GroupInfos: Array<GroupInfo>;
|
|
2065
2065
|
/**
|
|
2066
|
-
|
|
2066
|
+
* 人员库总数量
|
|
2067
2067
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
2068
|
-
|
|
2068
|
+
*/
|
|
2069
2069
|
GroupNum: number;
|
|
2070
2070
|
/**
|
|
2071
2071
|
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
@@ -2077,36 +2077,36 @@ export interface GetGroupListResponse {
|
|
|
2077
2077
|
*/
|
|
2078
2078
|
export interface DetectFaceAttributesRequest {
|
|
2079
2079
|
/**
|
|
2080
|
-
|
|
2080
|
+
* 最多处理的人脸数目。
|
|
2081
2081
|
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2082
2082
|
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
2083
|
-
|
|
2083
|
+
*/
|
|
2084
2084
|
MaxFaceNum?: number;
|
|
2085
2085
|
/**
|
|
2086
|
-
|
|
2086
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2087
2087
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2088
2088
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2089
|
-
|
|
2089
|
+
*/
|
|
2090
2090
|
Image?: string;
|
|
2091
2091
|
/**
|
|
2092
|
-
|
|
2092
|
+
* 图片的 Url 。
|
|
2093
2093
|
对应图片 base64 编码后大小不可超过5M。
|
|
2094
2094
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2095
2095
|
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2096
2096
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2097
2097
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2098
2098
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2099
|
-
|
|
2099
|
+
*/
|
|
2100
2100
|
Url?: string;
|
|
2101
2101
|
/**
|
|
2102
|
-
|
|
2102
|
+
* 是否返回年龄、性别、情绪等属性。
|
|
2103
2103
|
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
|
2104
2104
|
Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
|
2105
2105
|
None为不需要返回。默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
|
2106
2106
|
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
2107
2107
|
关于各属性的详细描述,参见下文出参。
|
|
2108
2108
|
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
2109
|
-
|
|
2109
|
+
*/
|
|
2110
2110
|
FaceAttributesType?: string;
|
|
2111
2111
|
/**
|
|
2112
2112
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -2155,12 +2155,12 @@ export interface GetGroupInfoResponse {
|
|
|
2155
2155
|
*/
|
|
2156
2156
|
export interface CompareFaceResponse {
|
|
2157
2157
|
/**
|
|
2158
|
-
|
|
2158
|
+
* 两张图片中人脸的相似度分数。
|
|
2159
2159
|
不同算法版本返回的相似度分数不同。
|
|
2160
2160
|
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
2161
2161
|
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
2162
2162
|
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
2163
|
-
|
|
2163
|
+
*/
|
|
2164
2164
|
Score: number;
|
|
2165
2165
|
/**
|
|
2166
2166
|
* 人脸识别所用的算法模型版本。
|
|
@@ -2176,9 +2176,9 @@ export interface CompareFaceResponse {
|
|
|
2176
2176
|
*/
|
|
2177
2177
|
export interface Mouth {
|
|
2178
2178
|
/**
|
|
2179
|
-
|
|
2179
|
+
* 是否张嘴信息。
|
|
2180
2180
|
AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
|
|
2181
|
-
|
|
2181
|
+
*/
|
|
2182
2182
|
MouthOpen: AttributeItem;
|
|
2183
2183
|
}
|
|
2184
2184
|
/**
|
|
@@ -2245,41 +2245,41 @@ export interface FaceShape {
|
|
|
2245
2245
|
*/
|
|
2246
2246
|
export interface CompareFaceRequest {
|
|
2247
2247
|
/**
|
|
2248
|
-
|
|
2248
|
+
* A 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2249
2249
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2250
2250
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2251
2251
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2252
|
-
|
|
2252
|
+
*/
|
|
2253
2253
|
ImageA?: string;
|
|
2254
2254
|
/**
|
|
2255
|
-
|
|
2255
|
+
* B 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2256
2256
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2257
2257
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2258
2258
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2259
|
-
|
|
2259
|
+
*/
|
|
2260
2260
|
ImageB?: string;
|
|
2261
2261
|
/**
|
|
2262
|
-
|
|
2262
|
+
* A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2263
2263
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2264
2264
|
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2265
2265
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2266
2266
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2267
2267
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2268
2268
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2269
|
-
|
|
2269
|
+
*/
|
|
2270
2270
|
UrlA?: string;
|
|
2271
2271
|
/**
|
|
2272
|
-
|
|
2272
|
+
* B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2273
2273
|
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2274
2274
|
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2275
2275
|
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2276
2276
|
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2277
2277
|
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2278
2278
|
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2279
|
-
|
|
2279
|
+
*/
|
|
2280
2280
|
UrlB?: string;
|
|
2281
2281
|
/**
|
|
2282
|
-
|
|
2282
|
+
* 人脸识别服务所用的算法模型版本。
|
|
2283
2283
|
|
|
2284
2284
|
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2285
2285
|
|
|
@@ -2288,10 +2288,10 @@ export interface CompareFaceRequest {
|
|
|
2288
2288
|
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2289
2289
|
|
|
2290
2290
|
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2291
|
-
|
|
2291
|
+
*/
|
|
2292
2292
|
FaceModelVersion?: string;
|
|
2293
2293
|
/**
|
|
2294
|
-
|
|
2294
|
+
* 图片质量控制。
|
|
2295
2295
|
0: 不进行控制;
|
|
2296
2296
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
2297
2297
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
@@ -2299,7 +2299,7 @@ export interface CompareFaceRequest {
|
|
|
2299
2299
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
2300
2300
|
默认 0。
|
|
2301
2301
|
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
2302
|
-
|
|
2302
|
+
*/
|
|
2303
2303
|
QualityControl?: number;
|
|
2304
2304
|
/**
|
|
2305
2305
|
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
@@ -2391,11 +2391,11 @@ export interface UpgradeJobInfo {
|
|
|
2391
2391
|
*/
|
|
2392
2392
|
ToFaceModelVersion: string;
|
|
2393
2393
|
/**
|
|
2394
|
-
|
|
2394
|
+
* 升级起始时间。
|
|
2395
2395
|
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
2396
2396
|
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
2397
2397
|
有关更多信息,请参阅 Unix 时间。
|
|
2398
|
-
|
|
2398
|
+
*/
|
|
2399
2399
|
StartTime: number;
|
|
2400
2400
|
/**
|
|
2401
2401
|
* 0表示升级中,1表示升级完毕,2表示回滚完毕,3表示升级失败。
|
|
@@ -2437,91 +2437,91 @@ export interface GetPersonListRequest {
|
|
|
2437
2437
|
*/
|
|
2438
2438
|
export interface FaceDetailAttributesInfo {
|
|
2439
2439
|
/**
|
|
2440
|
-
|
|
2440
|
+
* 年龄 [0,65],其中65代表“65岁及以上”。
|
|
2441
2441
|
FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2442
|
-
|
|
2442
|
+
*/
|
|
2443
2443
|
Age: number;
|
|
2444
2444
|
/**
|
|
2445
|
-
|
|
2445
|
+
* 美丑打分[0,100]。
|
|
2446
2446
|
FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2447
|
-
|
|
2447
|
+
*/
|
|
2448
2448
|
Beauty: number;
|
|
2449
2449
|
/**
|
|
2450
|
-
|
|
2450
|
+
* 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
|
2451
2451
|
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
|
|
2452
2452
|
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2453
|
-
|
|
2453
|
+
*/
|
|
2454
2454
|
Emotion: AttributeItem;
|
|
2455
2455
|
/**
|
|
2456
|
-
|
|
2456
|
+
* 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
|
2457
2457
|
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2458
|
-
|
|
2458
|
+
*/
|
|
2459
2459
|
Eye: Eye;
|
|
2460
2460
|
/**
|
|
2461
|
-
|
|
2461
|
+
* 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
|
|
2462
2462
|
FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2463
|
-
|
|
2463
|
+
*/
|
|
2464
2464
|
Eyebrow: Eyebrow;
|
|
2465
2465
|
/**
|
|
2466
|
-
|
|
2466
|
+
* 性别信息。
|
|
2467
2467
|
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2468
2468
|
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2469
|
-
|
|
2469
|
+
*/
|
|
2470
2470
|
Gender: AttributeItem;
|
|
2471
2471
|
/**
|
|
2472
|
-
|
|
2472
|
+
* 头发信息,包含头发长度、有无刘海、头发颜色。
|
|
2473
2473
|
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2474
|
-
|
|
2474
|
+
*/
|
|
2475
2475
|
Hair: Hair;
|
|
2476
2476
|
/**
|
|
2477
|
-
|
|
2477
|
+
* 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
|
2478
2478
|
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2479
|
-
|
|
2479
|
+
*/
|
|
2480
2480
|
Hat: Hat;
|
|
2481
2481
|
/**
|
|
2482
|
-
|
|
2482
|
+
* 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
|
2483
2483
|
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2484
|
-
|
|
2484
|
+
*/
|
|
2485
2485
|
HeadPose: HeadPose;
|
|
2486
2486
|
/**
|
|
2487
|
-
|
|
2487
|
+
* 口罩佩戴信息。
|
|
2488
2488
|
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2489
2489
|
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2490
|
-
|
|
2490
|
+
*/
|
|
2491
2491
|
Mask: AttributeItem;
|
|
2492
2492
|
/**
|
|
2493
|
-
|
|
2493
|
+
* 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
|
2494
2494
|
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2495
|
-
|
|
2495
|
+
*/
|
|
2496
2496
|
Mouth: Mouth;
|
|
2497
2497
|
/**
|
|
2498
|
-
|
|
2498
|
+
* 胡子信息。
|
|
2499
2499
|
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2500
2500
|
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2501
|
-
|
|
2501
|
+
*/
|
|
2502
2502
|
Moustache: AttributeItem;
|
|
2503
2503
|
/**
|
|
2504
|
-
|
|
2504
|
+
* 鼻子信息。
|
|
2505
2505
|
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2506
2506
|
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2507
|
-
|
|
2507
|
+
*/
|
|
2508
2508
|
Nose: AttributeItem;
|
|
2509
2509
|
/**
|
|
2510
|
-
|
|
2510
|
+
* 脸型信息。
|
|
2511
2511
|
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2512
2512
|
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2513
|
-
|
|
2513
|
+
*/
|
|
2514
2514
|
Shape: AttributeItem;
|
|
2515
2515
|
/**
|
|
2516
|
-
|
|
2516
|
+
* 肤色信息。
|
|
2517
2517
|
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2518
2518
|
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2519
|
-
|
|
2519
|
+
*/
|
|
2520
2520
|
Skin: AttributeItem;
|
|
2521
2521
|
/**
|
|
2522
|
-
|
|
2522
|
+
* 微笑程度,[0,100]。
|
|
2523
2523
|
FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2524
|
-
|
|
2524
|
+
*/
|
|
2525
2525
|
Smile: number;
|
|
2526
2526
|
}
|
|
2527
2527
|
/**
|
|
@@ -2542,16 +2542,16 @@ export interface AttributeItem {
|
|
|
2542
2542
|
*/
|
|
2543
2543
|
export interface FaceRect {
|
|
2544
2544
|
/**
|
|
2545
|
-
|
|
2545
|
+
* 人脸框左上角横坐标。
|
|
2546
2546
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2547
2547
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2548
|
-
|
|
2548
|
+
*/
|
|
2549
2549
|
X: number;
|
|
2550
2550
|
/**
|
|
2551
|
-
|
|
2551
|
+
* 人脸框左上角纵坐标。
|
|
2552
2552
|
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2553
2553
|
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2554
|
-
|
|
2554
|
+
*/
|
|
2555
2555
|
Y: number;
|
|
2556
2556
|
/**
|
|
2557
2557
|
* 人脸宽度
|