tencentcloud-sdk-nodejs 4.0.970 → 4.0.972
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 +468 -0
- package/SERVICE_CHANGELOG.md +453 -394
- package/package.json +1 -1
- package/products.md +35 -34
- package/src/common/sdk_version.ts +1 -1
- package/src/services/as/v20180419/as_models.ts +189 -150
- package/src/services/asr/v20190614/asr_models.ts +3 -3
- package/src/services/ccc/v20200210/ccc_models.ts +79 -123
- package/src/services/cdb/v20170320/cdb_client.ts +32 -20
- package/src/services/cdb/v20170320/cdb_models.ts +159 -101
- package/src/services/cdc/v20201214/cdc_models.ts +11 -11
- package/src/services/cls/v20201016/cls_client.ts +63 -14
- package/src/services/cls/v20201016/cls_models.ts +373 -112
- package/src/services/cwp/v20180228/cwp_client.ts +3 -16
- package/src/services/cwp/v20180228/cwp_models.ts +822 -1570
- package/src/services/dasb/v20191018/dasb_models.ts +0 -4
- package/src/services/emr/v20190103/emr_models.ts +20 -5
- package/src/services/ess/v20201111/ess_models.ts +5 -4
- package/src/services/essbasic/v20210526/essbasic_models.ts +5 -6
- package/src/services/hai/v20230812/hai_client.ts +2 -0
- package/src/services/hai/v20230812/hai_models.ts +64 -2
- package/src/services/hunyuan/v20230901/hunyuan_client.ts +1 -1
- package/src/services/hunyuan/v20230901/hunyuan_models.ts +7 -3
- package/src/services/iai/v20180301/iai_models.ts +4 -4
- package/src/services/iai/v20200303/iai_models.ts +450 -351
- package/src/services/ig/index.ts +5 -0
- package/src/services/ig/v20210518/ig_client.ts +40 -0
- package/src/services/ig/v20210518/ig_models.ts +52 -0
- package/src/services/ig/v20210518/index.ts +6 -0
- package/src/services/index.ts +1 -0
- package/src/services/iss/v20230517/iss_client.ts +20 -32
- package/src/services/iss/v20230517/iss_models.ts +150 -178
- package/src/services/lke/v20231130/lke_models.ts +8 -8
- package/src/services/mmps/v20200710/mmps_models.ts +9 -9
- package/src/services/mrs/v20200910/mrs_models.ts +8 -0
- package/src/services/redis/v20180412/redis_client.ts +1 -1
- package/src/services/redis/v20180412/redis_models.ts +3 -5
- package/src/services/soe/v20180724/soe_models.ts +10 -10
- package/src/services/ssl/v20191205/ssl_client.ts +3 -2
- package/src/services/ssl/v20191205/ssl_models.ts +147 -108
- package/src/services/tat/v20201028/tat_models.ts +3 -12
- package/src/services/tcr/v20190924/tcr_models.ts +1 -1
- package/src/services/tdmq/v20200217/tdmq_models.ts +2 -2
- package/src/services/vpc/v20170312/vpc_client.ts +12 -0
- package/src/services/vpc/v20170312/vpc_models.ts +24 -0
- package/src/services/wedata/v20210820/wedata_client.ts +36 -0
- package/src/services/wedata/v20210820/wedata_models.ts +128 -0
- package/tencentcloud/common/sdk_version.d.ts +1 -1
- package/tencentcloud/common/sdk_version.js +1 -1
- package/tencentcloud/services/as/v20180419/as_models.d.ts +189 -150
- package/tencentcloud/services/asr/v20190614/asr_models.d.ts +3 -3
- package/tencentcloud/services/ccc/v20200210/ccc_models.d.ts +71 -115
- package/tencentcloud/services/cdb/v20170320/cdb_client.d.ts +22 -18
- package/tencentcloud/services/cdb/v20170320/cdb_client.js +23 -17
- package/tencentcloud/services/cdb/v20170320/cdb_models.d.ts +156 -100
- package/tencentcloud/services/cdc/v20201214/cdc_models.d.ts +11 -11
- package/tencentcloud/services/cls/v20201016/cls_client.d.ts +19 -3
- package/tencentcloud/services/cls/v20201016/cls_client.js +27 -3
- package/tencentcloud/services/cls/v20201016/cls_models.d.ts +364 -112
- package/tencentcloud/services/cwp/v20180228/cwp_client.d.ts +1 -7
- package/tencentcloud/services/cwp/v20180228/cwp_client.js +0 -8
- package/tencentcloud/services/cwp/v20180228/cwp_models.d.ts +821 -1568
- package/tencentcloud/services/dasb/v20191018/dasb_models.d.ts +0 -4
- package/tencentcloud/services/emr/v20190103/emr_models.d.ts +20 -5
- package/tencentcloud/services/ess/v20201111/ess_models.d.ts +5 -4
- package/tencentcloud/services/essbasic/v20210526/essbasic_models.d.ts +5 -6
- package/tencentcloud/services/hai/v20230812/hai_models.d.ts +62 -2
- package/tencentcloud/services/hunyuan/v20230901/hunyuan_client.d.ts +1 -1
- package/tencentcloud/services/hunyuan/v20230901/hunyuan_client.js +1 -1
- package/tencentcloud/services/hunyuan/v20230901/hunyuan_models.d.ts +7 -3
- package/tencentcloud/services/iai/v20180301/iai_models.d.ts +4 -4
- package/tencentcloud/services/iai/v20200303/iai_models.d.ts +450 -351
- package/tencentcloud/services/ig/index.d.ts +6 -0
- package/tencentcloud/services/ig/index.js +7 -0
- package/tencentcloud/services/ig/v20210518/ig_client.d.ts +14 -0
- package/tencentcloud/services/ig/v20210518/ig_client.js +37 -0
- package/tencentcloud/services/ig/v20210518/ig_models.d.ts +34 -0
- package/tencentcloud/services/ig/v20210518/ig_models.js +18 -0
- package/tencentcloud/services/ig/v20210518/index.d.ts +6 -0
- package/tencentcloud/services/ig/v20210518/index.js +9 -0
- package/tencentcloud/services/index.d.ts +1 -0
- package/tencentcloud/services/index.js +2 -0
- package/tencentcloud/services/iss/v20230517/iss_client.d.ts +7 -11
- package/tencentcloud/services/iss/v20230517/iss_client.js +9 -15
- package/tencentcloud/services/iss/v20230517/iss_models.d.ts +150 -176
- package/tencentcloud/services/lke/v20231130/lke_models.d.ts +8 -8
- package/tencentcloud/services/mmps/v20200710/mmps_models.d.ts +9 -9
- package/tencentcloud/services/mrs/v20200910/mrs_models.d.ts +8 -0
- package/tencentcloud/services/redis/v20180412/redis_client.d.ts +1 -1
- package/tencentcloud/services/redis/v20180412/redis_client.js +1 -1
- package/tencentcloud/services/redis/v20180412/redis_models.d.ts +3 -5
- package/tencentcloud/services/soe/v20180724/soe_models.d.ts +10 -10
- package/tencentcloud/services/ssl/v20191205/ssl_client.d.ts +1 -1
- package/tencentcloud/services/ssl/v20191205/ssl_models.d.ts +146 -108
- package/tencentcloud/services/tat/v20201028/tat_models.d.ts +3 -12
- package/tencentcloud/services/tcr/v20190924/tcr_models.d.ts +1 -1
- package/tencentcloud/services/tdmq/v20200217/tdmq_models.d.ts +2 -2
- package/tencentcloud/services/vpc/v20170312/vpc_client.d.ts +5 -1
- package/tencentcloud/services/vpc/v20170312/vpc_client.js +6 -0
- package/tencentcloud/services/vpc/v20170312/vpc_models.d.ts +22 -0
- package/tencentcloud/services/wedata/v20210820/wedata_client.d.ts +13 -1
- package/tencentcloud/services/wedata/v20210820/wedata_client.js +18 -0
- package/tencentcloud/services/wedata/v20210820/wedata_models.d.ts +122 -0
- package/test/cdb.v20170320.test.js +10 -0
- package/test/cls.v20201016.test.js +42 -2
- package/test/cwp.v20180228.test.js +0 -10
- package/test/ig.v20210518.test.js +31 -0
- package/test/iss.v20230517.test.js +6 -16
- package/test/vpc.v20170312.test.js +10 -0
- package/test/wedata.v20210820.test.js +30 -0
|
@@ -4,62 +4,62 @@
|
|
|
4
4
|
export interface Eye {
|
|
5
5
|
/**
|
|
6
6
|
* 识别是否佩戴眼镜。
|
|
7
|
-
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
|
7
|
+
- AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
|
8
8
|
*/
|
|
9
|
-
Glass
|
|
9
|
+
Glass?: AttributeItem;
|
|
10
10
|
/**
|
|
11
11
|
* 识别眼睛的睁开、闭合状态。
|
|
12
|
-
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
12
|
+
- AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
13
13
|
*/
|
|
14
|
-
EyeOpen
|
|
14
|
+
EyeOpen?: AttributeItem;
|
|
15
15
|
/**
|
|
16
16
|
* 识别是否双眼皮。
|
|
17
|
-
AttributeItem对应的Type为 —— 0:无,1:有。
|
|
17
|
+
- AttributeItem对应的Type为 —— 0:无,1:有。
|
|
18
18
|
*/
|
|
19
|
-
EyelidType
|
|
19
|
+
EyelidType?: AttributeItem;
|
|
20
20
|
/**
|
|
21
21
|
* 眼睛大小。
|
|
22
|
-
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
|
22
|
+
- AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
|
23
23
|
*/
|
|
24
|
-
EyeSize
|
|
24
|
+
EyeSize?: AttributeItem;
|
|
25
25
|
}
|
|
26
26
|
/**
|
|
27
27
|
* 识别出的最相似候选人
|
|
28
28
|
*/
|
|
29
29
|
export interface Candidate {
|
|
30
30
|
/**
|
|
31
|
-
* 人员ID
|
|
31
|
+
* 人员ID。
|
|
32
32
|
*/
|
|
33
|
-
PersonId
|
|
33
|
+
PersonId?: string;
|
|
34
34
|
/**
|
|
35
|
-
* 人脸ID
|
|
35
|
+
* 人脸ID。
|
|
36
|
+
- 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
|
|
37
|
+
- 人员搜索类接口采用融合特征方式检索,该字段无意义。
|
|
36
38
|
*/
|
|
37
|
-
FaceId
|
|
39
|
+
FaceId?: string;
|
|
38
40
|
/**
|
|
39
41
|
* 候选者的匹配得分。
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
|
42
|
+
- 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分。
|
|
43
|
+
- 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分。
|
|
44
|
+
- 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
|
45
|
+
- 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
|
46
46
|
*/
|
|
47
|
-
Score
|
|
47
|
+
Score?: number;
|
|
48
48
|
/**
|
|
49
|
-
*
|
|
49
|
+
* 人员名称。
|
|
50
50
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
51
51
|
*/
|
|
52
|
-
PersonName
|
|
52
|
+
PersonName?: string;
|
|
53
53
|
/**
|
|
54
|
-
*
|
|
54
|
+
* 人员性别。
|
|
55
55
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
56
56
|
*/
|
|
57
|
-
Gender
|
|
57
|
+
Gender?: number;
|
|
58
58
|
/**
|
|
59
|
-
*
|
|
59
|
+
* 包含此人员的人员库及描述字段内容列表。
|
|
60
60
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
61
61
|
*/
|
|
62
|
-
PersonGroupInfos
|
|
62
|
+
PersonGroupInfos?: Array<PersonGroupInfo>;
|
|
63
63
|
}
|
|
64
64
|
/**
|
|
65
65
|
* DetectFaceAttributes返回参数结构体
|
|
@@ -112,13 +112,13 @@ export interface SearchPersonsReturnsByGroupResponse {
|
|
|
112
112
|
*/
|
|
113
113
|
export interface PersonGroupInfo {
|
|
114
114
|
/**
|
|
115
|
-
* 包含此人员的人员库ID
|
|
115
|
+
* 包含此人员的人员库ID。
|
|
116
116
|
*/
|
|
117
|
-
GroupId
|
|
117
|
+
GroupId?: string;
|
|
118
118
|
/**
|
|
119
|
-
*
|
|
119
|
+
* 人员描述字段内容。
|
|
120
120
|
*/
|
|
121
|
-
PersonExDescriptions
|
|
121
|
+
PersonExDescriptions?: Array<string>;
|
|
122
122
|
}
|
|
123
123
|
/**
|
|
124
124
|
* 帽子信息
|
|
@@ -245,20 +245,20 @@ export interface CreateFaceResponse {
|
|
|
245
245
|
*/
|
|
246
246
|
export interface FaceHairAttributesInfo {
|
|
247
247
|
/**
|
|
248
|
-
* 0:光头,1:短发,2:中发,3:长发,4
|
|
248
|
+
* 取值范围:0:光头,1:短发,2:中发,3:长发,4:绑发。
|
|
249
249
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
250
250
|
*/
|
|
251
|
-
Length
|
|
251
|
+
Length?: number;
|
|
252
252
|
/**
|
|
253
|
-
* 0:有刘海,1
|
|
253
|
+
* 取值范围:0:有刘海,1:无刘海。
|
|
254
254
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
255
255
|
*/
|
|
256
|
-
Bang
|
|
256
|
+
Bang?: number;
|
|
257
257
|
/**
|
|
258
|
-
* 0:黑色,1:金色,2:棕色,3
|
|
258
|
+
* 取值范围:0:黑色,1:金色,2:棕色,3:灰白色。
|
|
259
259
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
260
260
|
*/
|
|
261
|
-
Color
|
|
261
|
+
Color?: number;
|
|
262
262
|
}
|
|
263
263
|
/**
|
|
264
264
|
* CreateFace请求参数结构体
|
|
@@ -366,34 +366,37 @@ export interface GetPersonGroupInfoRequest {
|
|
|
366
366
|
export interface FaceInfo {
|
|
367
367
|
/**
|
|
368
368
|
* 人脸框左上角横坐标。
|
|
369
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
370
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
369
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
370
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
371
371
|
*/
|
|
372
|
-
X
|
|
372
|
+
X?: number;
|
|
373
373
|
/**
|
|
374
374
|
* 人脸框左上角纵坐标。
|
|
375
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
376
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
375
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
376
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
377
377
|
*/
|
|
378
|
-
Y
|
|
378
|
+
Y?: number;
|
|
379
379
|
/**
|
|
380
380
|
* 人脸框宽度。
|
|
381
381
|
*/
|
|
382
|
-
Width
|
|
382
|
+
Width?: number;
|
|
383
383
|
/**
|
|
384
384
|
* 人脸框高度。
|
|
385
385
|
*/
|
|
386
|
-
Height
|
|
386
|
+
Height?: number;
|
|
387
387
|
/**
|
|
388
|
-
*
|
|
389
|
-
|
|
388
|
+
* 人脸属性信息。
|
|
389
|
+
- 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。
|
|
390
|
+
- 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
|
390
391
|
*/
|
|
391
|
-
FaceAttributesInfo
|
|
392
|
+
FaceAttributesInfo?: FaceAttributesInfo;
|
|
392
393
|
/**
|
|
393
|
-
*
|
|
394
|
+
* 人脸质量信息。
|
|
395
|
+
- 包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。
|
|
396
|
+
- 只有当NeedFaceDetection设为1时才返回有效信息。
|
|
394
397
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
395
398
|
*/
|
|
396
|
-
FaceQualityInfo
|
|
399
|
+
FaceQualityInfo?: FaceQualityInfo;
|
|
397
400
|
}
|
|
398
401
|
/**
|
|
399
402
|
* 眉毛信息
|
|
@@ -401,43 +404,46 @@ export interface FaceInfo {
|
|
|
401
404
|
export interface Eyebrow {
|
|
402
405
|
/**
|
|
403
406
|
* 眉毛浓密。
|
|
404
|
-
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
407
|
+
- AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
405
408
|
*/
|
|
406
|
-
EyebrowDensity
|
|
409
|
+
EyebrowDensity?: AttributeItem;
|
|
407
410
|
/**
|
|
408
411
|
* 眉毛弯曲。
|
|
409
|
-
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
412
|
+
- AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
410
413
|
*/
|
|
411
|
-
EyebrowCurve
|
|
414
|
+
EyebrowCurve?: AttributeItem;
|
|
412
415
|
/**
|
|
413
416
|
* 眉毛长短。
|
|
414
|
-
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
417
|
+
- AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
415
418
|
*/
|
|
416
|
-
EyebrowLength
|
|
419
|
+
EyebrowLength?: AttributeItem;
|
|
417
420
|
}
|
|
418
421
|
/**
|
|
419
422
|
* AnalyzeDenseLandmarks请求参数结构体
|
|
420
423
|
*/
|
|
421
424
|
export interface AnalyzeDenseLandmarksRequest {
|
|
422
425
|
/**
|
|
423
|
-
* 检测模式。
|
|
424
|
-
|
|
425
|
-
|
|
426
|
+
* 检测模式。
|
|
427
|
+
- 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
|
428
|
+
- 默认为 0。
|
|
429
|
+
- 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
426
430
|
*/
|
|
427
431
|
Mode?: number;
|
|
428
432
|
/**
|
|
429
|
-
* 图片 base64
|
|
430
|
-
|
|
431
|
-
|
|
433
|
+
* 图片 base64 数据。
|
|
434
|
+
- base64 编码后大小不可超过5M。
|
|
435
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
436
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
432
437
|
*/
|
|
433
438
|
Image?: string;
|
|
434
439
|
/**
|
|
435
|
-
* 图片的 Url
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
440
|
+
* 图片的 Url 。
|
|
441
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
442
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
443
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
444
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
445
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
446
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
441
447
|
*/
|
|
442
448
|
Url?: string;
|
|
443
449
|
/**
|
|
@@ -445,7 +451,11 @@ export interface AnalyzeDenseLandmarksRequest {
|
|
|
445
451
|
*/
|
|
446
452
|
FaceModelVersion?: string;
|
|
447
453
|
/**
|
|
448
|
-
* 是否开启图片旋转识别支持。
|
|
454
|
+
* 是否开启图片旋转识别支持。
|
|
455
|
+
- 取值范围:0为不开启,1为开启。
|
|
456
|
+
- 默认为0。
|
|
457
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
458
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
449
459
|
*/
|
|
450
460
|
NeedRotateDetection?: number;
|
|
451
461
|
}
|
|
@@ -526,13 +536,16 @@ export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
|
526
536
|
*/
|
|
527
537
|
export interface DetectLiveFaceAccurateResponse {
|
|
528
538
|
/**
|
|
529
|
-
*
|
|
539
|
+
* 活体打分。
|
|
540
|
+
- 取值范围 [0,100]。
|
|
541
|
+
- 根据活体分数对应的阈值区间来判断是否为翻拍。
|
|
542
|
+
- 目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
|
|
530
543
|
*/
|
|
531
|
-
Score
|
|
544
|
+
Score?: number;
|
|
532
545
|
/**
|
|
533
546
|
* 人脸识别所用的算法模型版本。
|
|
534
547
|
*/
|
|
535
|
-
FaceModelVersion
|
|
548
|
+
FaceModelVersion?: string;
|
|
536
549
|
/**
|
|
537
550
|
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
538
551
|
*/
|
|
@@ -543,38 +556,45 @@ export interface DetectLiveFaceAccurateResponse {
|
|
|
543
556
|
*/
|
|
544
557
|
export interface AnalyzeFaceRequest {
|
|
545
558
|
/**
|
|
546
|
-
* 检测模式。
|
|
559
|
+
* 检测模式。
|
|
560
|
+
- 取值范围:
|
|
561
|
+
0 为检测所有出现的人脸。
|
|
562
|
+
1 为检测面积最大的人脸。
|
|
563
|
+
- 默认为 0。
|
|
564
|
+
- 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
|
547
565
|
*/
|
|
548
566
|
Mode?: number;
|
|
549
567
|
/**
|
|
550
|
-
* 图片 base64
|
|
551
|
-
|
|
552
|
-
|
|
568
|
+
* 图片 base64 数据。
|
|
569
|
+
- base64 编码后大小不可超过5M。
|
|
570
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
571
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
553
572
|
*/
|
|
554
573
|
Image?: string;
|
|
555
574
|
/**
|
|
556
|
-
* 图片的 Url
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
575
|
+
* 图片的 Url 。
|
|
576
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
577
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
578
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
579
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
580
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
581
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
562
582
|
*/
|
|
563
583
|
Url?: string;
|
|
564
584
|
/**
|
|
565
585
|
* 人脸识别服务所用的算法模型版本。
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
572
|
-
|
|
573
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
586
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
587
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
588
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
589
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
574
590
|
*/
|
|
575
591
|
FaceModelVersion?: string;
|
|
576
592
|
/**
|
|
577
|
-
* 是否开启图片旋转识别支持。
|
|
593
|
+
* 是否开启图片旋转识别支持。
|
|
594
|
+
- 0为不开启,1为开启。
|
|
595
|
+
- 默认为0。
|
|
596
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
597
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
578
598
|
*/
|
|
579
599
|
NeedRotateDetection?: number;
|
|
580
600
|
}
|
|
@@ -650,11 +670,11 @@ export interface GroupCandidate {
|
|
|
650
670
|
/**
|
|
651
671
|
* 人员库ID 。
|
|
652
672
|
*/
|
|
653
|
-
GroupId
|
|
673
|
+
GroupId?: string;
|
|
654
674
|
/**
|
|
655
675
|
* 识别出的最相似候选人。
|
|
656
676
|
*/
|
|
657
|
-
Candidates
|
|
677
|
+
Candidates?: Array<Candidate>;
|
|
658
678
|
}
|
|
659
679
|
/**
|
|
660
680
|
* DeleteFace返回参数结构体
|
|
@@ -851,66 +871,71 @@ export interface GetUpgradeGroupFaceModelVersionResultRequest {
|
|
|
851
871
|
*/
|
|
852
872
|
export interface GroupInfo {
|
|
853
873
|
/**
|
|
854
|
-
*
|
|
874
|
+
* 人员库名称。
|
|
855
875
|
*/
|
|
856
|
-
GroupName
|
|
876
|
+
GroupName?: string;
|
|
857
877
|
/**
|
|
858
|
-
* 人员库ID
|
|
878
|
+
* 人员库ID。
|
|
859
879
|
*/
|
|
860
|
-
GroupId
|
|
880
|
+
GroupId?: string;
|
|
861
881
|
/**
|
|
862
|
-
*
|
|
882
|
+
* 人员库自定义描述字段。
|
|
863
883
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
864
884
|
*/
|
|
865
|
-
GroupExDescriptions
|
|
885
|
+
GroupExDescriptions?: Array<string>;
|
|
866
886
|
/**
|
|
867
|
-
*
|
|
887
|
+
* 人员库信息备注。
|
|
868
888
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
869
889
|
*/
|
|
870
|
-
Tag
|
|
890
|
+
Tag?: string;
|
|
871
891
|
/**
|
|
872
892
|
* 人脸识别所用的算法模型版本。
|
|
873
893
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
874
894
|
*/
|
|
875
|
-
FaceModelVersion
|
|
895
|
+
FaceModelVersion?: string;
|
|
876
896
|
/**
|
|
877
|
-
* Group的创建时间和日期 CreationTimestamp。
|
|
878
|
-
|
|
897
|
+
* Group的创建时间和日期 CreationTimestamp。
|
|
898
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
899
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
900
|
+
- 有关更多信息,请参阅 Unix 时间。
|
|
879
901
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
880
902
|
*/
|
|
881
|
-
CreationTimestamp
|
|
903
|
+
CreationTimestamp?: number;
|
|
882
904
|
}
|
|
883
905
|
/**
|
|
884
906
|
* 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
|
|
885
907
|
*/
|
|
886
908
|
export interface FaceQualityInfo {
|
|
887
909
|
/**
|
|
888
|
-
*
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
910
|
+
* 质量分。
|
|
911
|
+
- 取值范围:[0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
|
912
|
+
- 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
|
913
|
+
- 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
|
914
|
+
- 建议:人脸入库选取70以上的图片。
|
|
892
915
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
893
916
|
*/
|
|
894
|
-
Score
|
|
917
|
+
Score?: number;
|
|
895
918
|
/**
|
|
896
|
-
*
|
|
897
|
-
|
|
898
|
-
|
|
919
|
+
* 清晰分。
|
|
920
|
+
- 取值范围:[0,100],评价图片清晰程度,分数越高越清晰。
|
|
921
|
+
- 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
|
922
|
+
- 建议:人脸入库选取80以上的图片。
|
|
899
923
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
900
924
|
*/
|
|
901
|
-
Sharpness
|
|
925
|
+
Sharpness?: number;
|
|
902
926
|
/**
|
|
903
|
-
*
|
|
904
|
-
|
|
905
|
-
|
|
927
|
+
* 光照分。
|
|
928
|
+
- 取值范围:[0,100],评价图片光照程度,分数越高越亮。
|
|
929
|
+
- 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
|
930
|
+
- 建议:人脸入库选取[30,70]的图片。
|
|
906
931
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
907
932
|
*/
|
|
908
|
-
Brightness
|
|
933
|
+
Brightness?: number;
|
|
909
934
|
/**
|
|
910
935
|
* 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
|
911
936
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
912
937
|
*/
|
|
913
|
-
Completeness
|
|
938
|
+
Completeness?: FaceQualityCompleteness;
|
|
914
939
|
}
|
|
915
940
|
/**
|
|
916
941
|
* SearchFacesReturnsByGroup返回参数结构体
|
|
@@ -1024,107 +1049,107 @@ export interface DenseFaceShape {
|
|
|
1024
1049
|
/**
|
|
1025
1050
|
* 人脸框左上角横坐标。
|
|
1026
1051
|
*/
|
|
1027
|
-
X
|
|
1052
|
+
X?: number;
|
|
1028
1053
|
/**
|
|
1029
1054
|
* 人脸框左上角纵坐标。
|
|
1030
1055
|
*/
|
|
1031
|
-
Y
|
|
1056
|
+
Y?: number;
|
|
1032
1057
|
/**
|
|
1033
1058
|
* 人脸框宽度。
|
|
1034
1059
|
*/
|
|
1035
|
-
Width
|
|
1060
|
+
Width?: number;
|
|
1036
1061
|
/**
|
|
1037
1062
|
* 人脸框高度。
|
|
1038
1063
|
*/
|
|
1039
|
-
Height
|
|
1064
|
+
Height?: number;
|
|
1040
1065
|
/**
|
|
1041
1066
|
* 描述左侧眼睛轮廓的 XX 点。
|
|
1042
1067
|
*/
|
|
1043
|
-
LeftEye
|
|
1068
|
+
LeftEye?: Array<Point>;
|
|
1044
1069
|
/**
|
|
1045
1070
|
* 描述右侧眼睛轮廓的 XX 点。
|
|
1046
1071
|
*/
|
|
1047
|
-
RightEye
|
|
1072
|
+
RightEye?: Array<Point>;
|
|
1048
1073
|
/**
|
|
1049
1074
|
* 描述左侧眉毛轮廓的 XX 点。
|
|
1050
1075
|
*/
|
|
1051
|
-
LeftEyeBrow
|
|
1076
|
+
LeftEyeBrow?: Array<Point>;
|
|
1052
1077
|
/**
|
|
1053
1078
|
* 描述右侧眉毛轮廓的 XX 点。
|
|
1054
1079
|
*/
|
|
1055
|
-
RightEyeBrow
|
|
1080
|
+
RightEyeBrow?: Array<Point>;
|
|
1056
1081
|
/**
|
|
1057
1082
|
* 描述外嘴巴轮廓的 XX 点, 从左侧开始逆时针返回。
|
|
1058
1083
|
*/
|
|
1059
|
-
MouthOutside
|
|
1084
|
+
MouthOutside?: Array<Point>;
|
|
1060
1085
|
/**
|
|
1061
1086
|
* 描述内嘴巴轮廓的 XX 点,从左侧开始逆时针返回。
|
|
1062
1087
|
*/
|
|
1063
|
-
MouthInside
|
|
1088
|
+
MouthInside?: Array<Point>;
|
|
1064
1089
|
/**
|
|
1065
1090
|
* 描述鼻子轮廓的 XX 点。
|
|
1066
1091
|
*/
|
|
1067
|
-
Nose
|
|
1092
|
+
Nose?: Array<Point>;
|
|
1068
1093
|
/**
|
|
1069
1094
|
* 左瞳孔轮廓的 XX 个点。
|
|
1070
1095
|
*/
|
|
1071
|
-
LeftPupil
|
|
1096
|
+
LeftPupil?: Array<Point>;
|
|
1072
1097
|
/**
|
|
1073
1098
|
* 右瞳孔轮廓的 XX 个点。
|
|
1074
1099
|
*/
|
|
1075
|
-
RightPupil
|
|
1100
|
+
RightPupil?: Array<Point>;
|
|
1076
1101
|
/**
|
|
1077
1102
|
* 中轴线轮廓的 XX 个点。
|
|
1078
1103
|
*/
|
|
1079
|
-
CentralAxis
|
|
1104
|
+
CentralAxis?: Array<Point>;
|
|
1080
1105
|
/**
|
|
1081
1106
|
* 下巴轮廓的 XX 个点。
|
|
1082
1107
|
*/
|
|
1083
|
-
Chin
|
|
1108
|
+
Chin?: Array<Point>;
|
|
1084
1109
|
/**
|
|
1085
1110
|
* 左眼袋的 XX 个点。
|
|
1086
1111
|
*/
|
|
1087
|
-
LeftEyeBags
|
|
1112
|
+
LeftEyeBags?: Array<Point>;
|
|
1088
1113
|
/**
|
|
1089
1114
|
* 右眼袋的 XX 个点。
|
|
1090
1115
|
*/
|
|
1091
|
-
RightEyeBags
|
|
1116
|
+
RightEyeBags?: Array<Point>;
|
|
1092
1117
|
/**
|
|
1093
1118
|
* 额头的 XX 个点。
|
|
1094
1119
|
*/
|
|
1095
|
-
Forehead
|
|
1120
|
+
Forehead?: Array<Point>;
|
|
1096
1121
|
}
|
|
1097
1122
|
/**
|
|
1098
1123
|
* 识别结果。
|
|
1099
|
-
|
|
1100
1124
|
*/
|
|
1101
1125
|
export interface ResultsReturnsByGroup {
|
|
1102
1126
|
/**
|
|
1103
1127
|
* 检测出的人脸框位置。
|
|
1104
1128
|
*/
|
|
1105
|
-
FaceRect
|
|
1129
|
+
FaceRect?: FaceRect;
|
|
1106
1130
|
/**
|
|
1107
1131
|
* 识别结果。
|
|
1108
1132
|
*/
|
|
1109
|
-
GroupCandidates
|
|
1133
|
+
GroupCandidates?: Array<GroupCandidate>;
|
|
1110
1134
|
/**
|
|
1111
|
-
* 检测出的人脸图片状态返回码。
|
|
1112
|
-
-
|
|
1135
|
+
* 检测出的人脸图片状态返回码。
|
|
1136
|
+
- 0 表示正常。
|
|
1137
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1113
1138
|
*/
|
|
1114
|
-
RetCode
|
|
1139
|
+
RetCode?: number;
|
|
1115
1140
|
}
|
|
1116
1141
|
/**
|
|
1117
1142
|
* 坐标
|
|
1118
1143
|
*/
|
|
1119
1144
|
export interface Point {
|
|
1120
1145
|
/**
|
|
1121
|
-
* x
|
|
1146
|
+
* x坐标。
|
|
1122
1147
|
*/
|
|
1123
|
-
X
|
|
1148
|
+
X?: number;
|
|
1124
1149
|
/**
|
|
1125
|
-
* Y
|
|
1150
|
+
* Y坐标。
|
|
1126
1151
|
*/
|
|
1127
|
-
Y
|
|
1152
|
+
Y?: number;
|
|
1128
1153
|
}
|
|
1129
1154
|
/**
|
|
1130
1155
|
* GetPersonListNum返回参数结构体
|
|
@@ -1165,35 +1190,44 @@ export interface VerifyFaceRequest {
|
|
|
1165
1190
|
*/
|
|
1166
1191
|
PersonId: string;
|
|
1167
1192
|
/**
|
|
1168
|
-
* 图片 base64
|
|
1169
|
-
|
|
1170
|
-
|
|
1171
|
-
|
|
1193
|
+
* 图片 base64 数据。
|
|
1194
|
+
- base64 编码后大小不可超过5M。
|
|
1195
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1196
|
+
- 所有格式的图片短边像素不小于64。
|
|
1197
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1198
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1172
1199
|
*/
|
|
1173
1200
|
Image?: string;
|
|
1174
1201
|
/**
|
|
1175
|
-
* 图片的 Url
|
|
1176
|
-
|
|
1177
|
-
|
|
1178
|
-
|
|
1179
|
-
|
|
1180
|
-
|
|
1181
|
-
|
|
1202
|
+
* 图片的 Url 。
|
|
1203
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
1204
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1205
|
+
- 所有格式的图片短边像素不小于64。
|
|
1206
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1207
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1208
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1209
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1210
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1182
1211
|
*/
|
|
1183
1212
|
Url?: string;
|
|
1184
1213
|
/**
|
|
1185
1214
|
* 图片质量控制。
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
|
|
1189
|
-
|
|
1190
|
-
|
|
1191
|
-
|
|
1192
|
-
|
|
1215
|
+
- 取值范围:
|
|
1216
|
+
0: 不进行控制。
|
|
1217
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
1218
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
1219
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
1220
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
1221
|
+
- 默认 0。
|
|
1222
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1193
1223
|
*/
|
|
1194
1224
|
QualityControl?: number;
|
|
1195
1225
|
/**
|
|
1196
|
-
* 是否开启图片旋转识别支持。
|
|
1226
|
+
* 是否开启图片旋转识别支持。
|
|
1227
|
+
- 取值范围:0为不开启,1为开启。
|
|
1228
|
+
- 默认为0。
|
|
1229
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
1230
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1197
1231
|
*/
|
|
1198
1232
|
NeedRotateDetection?: number;
|
|
1199
1233
|
}
|
|
@@ -1250,18 +1284,19 @@ export interface Hair {
|
|
|
1250
1284
|
*/
|
|
1251
1285
|
export interface Result {
|
|
1252
1286
|
/**
|
|
1253
|
-
*
|
|
1287
|
+
* 识别出的最相似候选人。
|
|
1254
1288
|
*/
|
|
1255
|
-
Candidates
|
|
1289
|
+
Candidates?: Array<Candidate>;
|
|
1256
1290
|
/**
|
|
1257
|
-
*
|
|
1291
|
+
* 检测出的人脸框位置。
|
|
1258
1292
|
*/
|
|
1259
|
-
FaceRect
|
|
1293
|
+
FaceRect?: FaceRect;
|
|
1260
1294
|
/**
|
|
1261
|
-
* 检测出的人脸图片状态返回码。
|
|
1262
|
-
-
|
|
1295
|
+
* 检测出的人脸图片状态返回码。
|
|
1296
|
+
- 0 表示正常。
|
|
1297
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1263
1298
|
*/
|
|
1264
|
-
RetCode
|
|
1299
|
+
RetCode?: number;
|
|
1265
1300
|
}
|
|
1266
1301
|
/**
|
|
1267
1302
|
* GetPersonGroupInfo返回参数结构体
|
|
@@ -1429,41 +1464,47 @@ export interface RevertGroupFaceModelVersionRequest {
|
|
|
1429
1464
|
*/
|
|
1430
1465
|
export interface FaceQualityCompleteness {
|
|
1431
1466
|
/**
|
|
1432
|
-
*
|
|
1433
|
-
|
|
1467
|
+
* 眉毛的遮挡分数。
|
|
1468
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1469
|
+
- 参考范围:[0,80]表示发生遮挡。
|
|
1434
1470
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1435
1471
|
*/
|
|
1436
|
-
Eyebrow
|
|
1472
|
+
Eyebrow?: number;
|
|
1437
1473
|
/**
|
|
1438
|
-
*
|
|
1439
|
-
|
|
1474
|
+
* 眼睛的遮挡分数。
|
|
1475
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1476
|
+
- 参考范围:[0,80]表示发生遮挡。
|
|
1440
1477
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1441
1478
|
*/
|
|
1442
|
-
Eye
|
|
1479
|
+
Eye?: number;
|
|
1443
1480
|
/**
|
|
1444
|
-
*
|
|
1445
|
-
|
|
1481
|
+
* 鼻子的遮挡分数。
|
|
1482
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1483
|
+
- 参考范围:[0,60]表示发生遮挡。
|
|
1446
1484
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1447
1485
|
*/
|
|
1448
|
-
Nose
|
|
1486
|
+
Nose?: number;
|
|
1449
1487
|
/**
|
|
1450
|
-
*
|
|
1451
|
-
|
|
1488
|
+
* 脸颊的遮挡分数。
|
|
1489
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1490
|
+
- 参考范围:[0,70]表示发生遮挡。
|
|
1452
1491
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1453
1492
|
*/
|
|
1454
|
-
Cheek
|
|
1493
|
+
Cheek?: number;
|
|
1455
1494
|
/**
|
|
1456
|
-
*
|
|
1457
|
-
|
|
1495
|
+
* 嘴巴的遮挡分数。
|
|
1496
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1497
|
+
- 参考范围:[0,50]表示发生遮挡。
|
|
1458
1498
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1459
1499
|
*/
|
|
1460
|
-
Mouth
|
|
1500
|
+
Mouth?: number;
|
|
1461
1501
|
/**
|
|
1462
|
-
*
|
|
1463
|
-
|
|
1502
|
+
* 下巴的遮挡分数。
|
|
1503
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
|
1504
|
+
- 参考范围:[0,70]表示发生遮挡。
|
|
1464
1505
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1465
1506
|
*/
|
|
1466
|
-
Chin
|
|
1507
|
+
Chin?: number;
|
|
1467
1508
|
}
|
|
1468
1509
|
/**
|
|
1469
1510
|
* 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
|
|
@@ -1471,57 +1512,81 @@ export interface FaceQualityCompleteness {
|
|
|
1471
1512
|
*/
|
|
1472
1513
|
export interface FaceAttributesInfo {
|
|
1473
1514
|
/**
|
|
1474
|
-
*
|
|
1515
|
+
* 性别。
|
|
1516
|
+
- 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
|
|
1517
|
+
- NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1475
1518
|
*/
|
|
1476
1519
|
Gender?: number;
|
|
1477
1520
|
/**
|
|
1478
|
-
* 年龄
|
|
1521
|
+
* 年龄 。
|
|
1522
|
+
- 取值范围:[0~100]。
|
|
1523
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1479
1524
|
*/
|
|
1480
1525
|
Age?: number;
|
|
1481
1526
|
/**
|
|
1482
|
-
*
|
|
1527
|
+
* 微笑。
|
|
1528
|
+
- 取值说明:[0(normal,正常)~100(laugh,大笑)]。
|
|
1529
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1483
1530
|
*/
|
|
1484
1531
|
Expression?: number;
|
|
1485
1532
|
/**
|
|
1486
|
-
*
|
|
1533
|
+
* 是否有眼镜。
|
|
1534
|
+
- 取值范围: [true,false]。
|
|
1535
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1487
1536
|
*/
|
|
1488
1537
|
Glass?: boolean;
|
|
1489
1538
|
/**
|
|
1490
|
-
*
|
|
1491
|
-
|
|
1539
|
+
* 上下偏移。
|
|
1540
|
+
- 取值范围:[-30,30],单位角度。
|
|
1541
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1542
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
|
1492
1543
|
*/
|
|
1493
1544
|
Pitch?: number;
|
|
1494
1545
|
/**
|
|
1495
|
-
*
|
|
1496
|
-
|
|
1546
|
+
* 左右偏移。
|
|
1547
|
+
- 取值范围:[-30,30],单位角度。
|
|
1548
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1549
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
|
1497
1550
|
*/
|
|
1498
1551
|
Yaw?: number;
|
|
1499
1552
|
/**
|
|
1500
|
-
*
|
|
1501
|
-
|
|
1553
|
+
* 平面旋转。
|
|
1554
|
+
- 取值范围:[-180,180],单位角度。
|
|
1555
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1556
|
+
- 建议:人脸入库选择[-20,20]的图片。
|
|
1502
1557
|
*/
|
|
1503
1558
|
Roll?: number;
|
|
1504
1559
|
/**
|
|
1505
|
-
*
|
|
1560
|
+
* 魅力。
|
|
1561
|
+
- 取值范围:[0~100]。
|
|
1562
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1506
1563
|
*/
|
|
1507
1564
|
Beauty?: number;
|
|
1508
1565
|
/**
|
|
1509
|
-
*
|
|
1566
|
+
* 是否有帽子。
|
|
1567
|
+
- 取值范围: [true,false]。
|
|
1568
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1510
1569
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1511
1570
|
*/
|
|
1512
1571
|
Hat?: boolean;
|
|
1513
1572
|
/**
|
|
1514
|
-
*
|
|
1573
|
+
* 是否有口罩。
|
|
1574
|
+
- 取值范围: [true,false]。
|
|
1575
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1515
1576
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1516
1577
|
*/
|
|
1517
1578
|
Mask?: boolean;
|
|
1518
1579
|
/**
|
|
1519
|
-
* 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
|
1580
|
+
* 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
|
1581
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1520
1582
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1521
1583
|
*/
|
|
1522
1584
|
Hair?: FaceHairAttributesInfo;
|
|
1523
1585
|
/**
|
|
1524
|
-
*
|
|
1586
|
+
* 双眼是否睁开。
|
|
1587
|
+
- 取值范围: [true,false]。
|
|
1588
|
+
- 只要有超过一只眼睛闭眼,就返回false。
|
|
1589
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1525
1590
|
注意:此字段可能返回 null,表示取不到有效值。
|
|
1526
1591
|
*/
|
|
1527
1592
|
EyeOpen?: boolean;
|
|
@@ -1536,34 +1601,41 @@ export interface VerifyPersonRequest {
|
|
|
1536
1601
|
PersonId: string;
|
|
1537
1602
|
/**
|
|
1538
1603
|
* 图片 base64 数据。
|
|
1539
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1540
|
-
|
|
1541
|
-
|
|
1604
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1605
|
+
- 所有格式的图片短边像素不小于64。
|
|
1606
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1607
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1542
1608
|
*/
|
|
1543
1609
|
Image?: string;
|
|
1544
1610
|
/**
|
|
1545
1611
|
* 图片的 Url
|
|
1546
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
|
|
1547
|
-
|
|
1548
|
-
|
|
1549
|
-
|
|
1550
|
-
|
|
1551
|
-
|
|
1612
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1613
|
+
- 所有格式的图片短边像素不小于64。
|
|
1614
|
+
- 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1615
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1616
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1617
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1618
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1552
1619
|
*/
|
|
1553
1620
|
Url?: string;
|
|
1554
1621
|
/**
|
|
1555
1622
|
* 图片质量控制。
|
|
1556
|
-
|
|
1557
|
-
|
|
1558
|
-
|
|
1559
|
-
|
|
1560
|
-
|
|
1561
|
-
|
|
1562
|
-
|
|
1623
|
+
- 取值范围:
|
|
1624
|
+
0: 不进行控制。
|
|
1625
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
1626
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
1627
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
1628
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
1629
|
+
- 默认 0。
|
|
1630
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1563
1631
|
*/
|
|
1564
1632
|
QualityControl?: number;
|
|
1565
1633
|
/**
|
|
1566
|
-
* 是否开启图片旋转识别支持。
|
|
1634
|
+
* 是否开启图片旋转识别支持。
|
|
1635
|
+
- 取值范围:0为不开启,1为开启。
|
|
1636
|
+
- 默认为0。
|
|
1637
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
1638
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1567
1639
|
*/
|
|
1568
1640
|
NeedRotateDetection?: number;
|
|
1569
1641
|
}
|
|
@@ -1610,21 +1682,23 @@ export interface ModifyPersonBaseInfoRequest {
|
|
|
1610
1682
|
*/
|
|
1611
1683
|
export interface DetectLiveFaceAccurateRequest {
|
|
1612
1684
|
/**
|
|
1613
|
-
* 图片 base64
|
|
1614
|
-
|
|
1615
|
-
|
|
1616
|
-
|
|
1617
|
-
|
|
1685
|
+
* 图片 base64 数据。
|
|
1686
|
+
- base64 编码后大小不可超过5M。
|
|
1687
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1688
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1689
|
+
- 人脸尺寸大于100X100像素。
|
|
1690
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1618
1691
|
*/
|
|
1619
1692
|
Image?: string;
|
|
1620
1693
|
/**
|
|
1621
|
-
* 图片的 Url
|
|
1622
|
-
|
|
1623
|
-
|
|
1624
|
-
|
|
1625
|
-
|
|
1626
|
-
|
|
1627
|
-
|
|
1694
|
+
* 图片的 Url 。
|
|
1695
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
1696
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1697
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1698
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1699
|
+
- 人脸尺寸大于100X100像素。
|
|
1700
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1701
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1628
1702
|
*/
|
|
1629
1703
|
Url?: string;
|
|
1630
1704
|
/**
|
|
@@ -1637,21 +1711,22 @@ export interface DetectLiveFaceAccurateRequest {
|
|
|
1637
1711
|
*/
|
|
1638
1712
|
export interface VerifyFaceResponse {
|
|
1639
1713
|
/**
|
|
1640
|
-
* 给定的人脸图片与 PersonId
|
|
1641
|
-
|
|
1642
|
-
不同算法版本返回的相似度分数不同。
|
|
1643
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1644
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1714
|
+
* 给定的人脸图片与 PersonId 对应人脸的相似度。
|
|
1715
|
+
- 若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
|
1716
|
+
- 不同算法版本返回的相似度分数不同。
|
|
1717
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1718
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1645
1719
|
*/
|
|
1646
|
-
Score
|
|
1720
|
+
Score?: number;
|
|
1647
1721
|
/**
|
|
1648
|
-
* 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score
|
|
1722
|
+
* 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断。
|
|
1649
1723
|
*/
|
|
1650
|
-
IsMatch
|
|
1724
|
+
IsMatch?: boolean;
|
|
1651
1725
|
/**
|
|
1652
|
-
* 人脸识别所用的算法模型版本,是该 Person
|
|
1726
|
+
* 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
|
1727
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
|
1653
1728
|
*/
|
|
1654
|
-
FaceModelVersion
|
|
1729
|
+
FaceModelVersion?: string;
|
|
1655
1730
|
/**
|
|
1656
1731
|
* 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
1657
1732
|
*/
|
|
@@ -1666,11 +1741,9 @@ export interface FaceDetailInfo {
|
|
|
1666
1741
|
*/
|
|
1667
1742
|
FaceRect?: FaceRect;
|
|
1668
1743
|
/**
|
|
1669
|
-
*
|
|
1670
|
-
|
|
1671
|
-
|
|
1672
|
-
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1673
|
-
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1744
|
+
* 人脸属性信息。
|
|
1745
|
+
- 根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)、情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)、头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache) 、鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1746
|
+
- 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1674
1747
|
*/
|
|
1675
1748
|
FaceDetailAttributesInfo?: FaceDetailAttributesInfo;
|
|
1676
1749
|
}
|
|
@@ -1807,41 +1880,43 @@ export interface SearchPersonsRequest {
|
|
|
1807
1880
|
*/
|
|
1808
1881
|
export interface PersonInfo {
|
|
1809
1882
|
/**
|
|
1810
|
-
*
|
|
1883
|
+
* 人员名称。
|
|
1811
1884
|
*/
|
|
1812
|
-
PersonName
|
|
1885
|
+
PersonName?: string;
|
|
1813
1886
|
/**
|
|
1814
|
-
* 人员Id
|
|
1887
|
+
* 人员Id。
|
|
1815
1888
|
*/
|
|
1816
|
-
PersonId
|
|
1889
|
+
PersonId?: string;
|
|
1817
1890
|
/**
|
|
1818
|
-
*
|
|
1891
|
+
* 人员性别。
|
|
1819
1892
|
*/
|
|
1820
|
-
Gender
|
|
1893
|
+
Gender?: number;
|
|
1821
1894
|
/**
|
|
1822
|
-
*
|
|
1895
|
+
* 人员描述字段内容。
|
|
1823
1896
|
*/
|
|
1824
|
-
PersonExDescriptions
|
|
1897
|
+
PersonExDescriptions?: Array<string>;
|
|
1825
1898
|
/**
|
|
1826
|
-
*
|
|
1899
|
+
* 包含的人脸照片列表。
|
|
1827
1900
|
*/
|
|
1828
|
-
FaceIds
|
|
1901
|
+
FaceIds?: Array<string>;
|
|
1829
1902
|
/**
|
|
1830
|
-
* 人员的创建时间和日期 CreationTimestamp。
|
|
1831
|
-
|
|
1903
|
+
* 人员的创建时间和日期 CreationTimestamp。
|
|
1904
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
|
1905
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
1906
|
+
- 有关更多信息,请参阅 Unix 时间。
|
|
1832
1907
|
*/
|
|
1833
|
-
CreationTimestamp
|
|
1908
|
+
CreationTimestamp?: number;
|
|
1834
1909
|
}
|
|
1835
1910
|
/**
|
|
1836
1911
|
* 需要修改的人员库自定义描述字段key-value
|
|
1837
1912
|
*/
|
|
1838
1913
|
export interface GroupExDescriptionInfo {
|
|
1839
1914
|
/**
|
|
1840
|
-
* 人员库自定义描述字段Index,从0
|
|
1915
|
+
* 人员库自定义描述字段Index,从0开始。
|
|
1841
1916
|
*/
|
|
1842
1917
|
GroupExDescriptionIndex: number;
|
|
1843
1918
|
/**
|
|
1844
|
-
*
|
|
1919
|
+
* 需要更新的人员库自定义描述字段内容。
|
|
1845
1920
|
*/
|
|
1846
1921
|
GroupExDescription: string;
|
|
1847
1922
|
}
|
|
@@ -1929,55 +2004,67 @@ export interface AnalyzeFaceResponse {
|
|
|
1929
2004
|
*/
|
|
1930
2005
|
export interface DetectFaceRequest {
|
|
1931
2006
|
/**
|
|
1932
|
-
*
|
|
1933
|
-
|
|
2007
|
+
* 最多处理的人脸数目。
|
|
2008
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2009
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1934
2010
|
*/
|
|
1935
2011
|
MaxFaceNum?: number;
|
|
1936
2012
|
/**
|
|
1937
2013
|
* 人脸长和宽的最小尺寸,单位为像素,低于MinFaceSize值的人脸不会被检测。
|
|
1938
|
-
只支持设置34和20,建议使用34。
|
|
1939
|
-
|
|
2014
|
+
- 只支持设置34和20,建议使用34。
|
|
1940
2015
|
*/
|
|
1941
2016
|
MinFaceSize?: number;
|
|
1942
2017
|
/**
|
|
1943
|
-
* 图片 base64
|
|
1944
|
-
|
|
1945
|
-
|
|
2018
|
+
* 图片 base64 数据。
|
|
2019
|
+
- base64 编码后大小不可超过5M。
|
|
2020
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2021
|
+
- 所有格式的图片短边像素不小于64。
|
|
2022
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1946
2023
|
*/
|
|
1947
2024
|
Image?: string;
|
|
1948
2025
|
/**
|
|
1949
|
-
* 图片的 Url
|
|
1950
|
-
|
|
1951
|
-
|
|
1952
|
-
|
|
1953
|
-
|
|
1954
|
-
|
|
2026
|
+
* 图片的 Url 。
|
|
2027
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
2028
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2029
|
+
- 所有格式的图片短边像素不小于64。
|
|
2030
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2031
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2032
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2033
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1955
2034
|
*/
|
|
1956
2035
|
Url?: string;
|
|
1957
2036
|
/**
|
|
1958
|
-
* 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
|
1959
|
-
|
|
1960
|
-
|
|
1961
|
-
|
|
2037
|
+
* 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
|
2038
|
+
- 0 为不需要返回,1 为需要返回。
|
|
2039
|
+
- 默认为 0。
|
|
2040
|
+
- 非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
|
2041
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
|
2042
|
+
- 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
|
1962
2043
|
*/
|
|
1963
2044
|
NeedFaceAttributes?: number;
|
|
1964
2045
|
/**
|
|
1965
|
-
* 是否开启质量检测。
|
|
1966
|
-
|
|
1967
|
-
|
|
1968
|
-
|
|
2046
|
+
* 是否开启质量检测。
|
|
2047
|
+
- 0 为关闭,1 为开启。
|
|
2048
|
+
- 默认为 0。
|
|
2049
|
+
- 非 1 值均视为不进行质量检测。
|
|
2050
|
+
- 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
|
2051
|
+
- 建议:人脸入库操作建议开启此功能。
|
|
1969
2052
|
*/
|
|
1970
2053
|
NeedQualityDetection?: number;
|
|
1971
2054
|
/**
|
|
1972
2055
|
* 人脸识别服务所用的算法模型版本。
|
|
1973
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
1974
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
1975
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
1976
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2056
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2057
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
2058
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2059
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
1977
2060
|
*/
|
|
1978
2061
|
FaceModelVersion?: string;
|
|
1979
2062
|
/**
|
|
1980
|
-
* 是否开启图片旋转识别支持。
|
|
2063
|
+
* 是否开启图片旋转识别支持。
|
|
2064
|
+
- 0为不开启,1为开启。
|
|
2065
|
+
- 默认为0。
|
|
2066
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
2067
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1981
2068
|
*/
|
|
1982
2069
|
NeedRotateDetection?: number;
|
|
1983
2070
|
}
|
|
@@ -2004,11 +2091,11 @@ export interface DeletePersonResponse {
|
|
|
2004
2091
|
*/
|
|
2005
2092
|
export interface PersonExDescriptionInfo {
|
|
2006
2093
|
/**
|
|
2007
|
-
* 人员描述字段Index,从0
|
|
2094
|
+
* 人员描述字段Index,从0开始。
|
|
2008
2095
|
*/
|
|
2009
2096
|
PersonExDescriptionIndex: number;
|
|
2010
2097
|
/**
|
|
2011
|
-
*
|
|
2098
|
+
* 需要更新的人员描述字段内容。
|
|
2012
2099
|
*/
|
|
2013
2100
|
PersonExDescription: string;
|
|
2014
2101
|
}
|
|
@@ -2036,15 +2123,15 @@ export interface HeadPose {
|
|
|
2036
2123
|
/**
|
|
2037
2124
|
* 上下偏移[-30,30]。
|
|
2038
2125
|
*/
|
|
2039
|
-
Pitch
|
|
2126
|
+
Pitch?: number;
|
|
2040
2127
|
/**
|
|
2041
2128
|
* 左右偏移[-30,30]。
|
|
2042
2129
|
*/
|
|
2043
|
-
Yaw
|
|
2130
|
+
Yaw?: number;
|
|
2044
2131
|
/**
|
|
2045
2132
|
* 平面旋转[-180,180]。
|
|
2046
2133
|
*/
|
|
2047
|
-
Roll
|
|
2134
|
+
Roll?: number;
|
|
2048
2135
|
}
|
|
2049
2136
|
/**
|
|
2050
2137
|
* GetGroupList返回参数结构体
|
|
@@ -2070,38 +2157,44 @@ export interface GetGroupListResponse {
|
|
|
2070
2157
|
export interface DetectFaceAttributesRequest {
|
|
2071
2158
|
/**
|
|
2072
2159
|
* 最多处理的人脸数目。
|
|
2073
|
-
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2074
|
-
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
2160
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2161
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
2075
2162
|
*/
|
|
2076
2163
|
MaxFaceNum?: number;
|
|
2077
2164
|
/**
|
|
2078
|
-
* 图片 base64
|
|
2079
|
-
|
|
2080
|
-
|
|
2165
|
+
* 图片 base64 数据。
|
|
2166
|
+
- base64 编码后大小不可超过5M。
|
|
2167
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2168
|
+
- 所有格式的图片短边像素不小于64。
|
|
2169
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2081
2170
|
*/
|
|
2082
2171
|
Image?: string;
|
|
2083
2172
|
/**
|
|
2084
2173
|
* 图片的 Url 。
|
|
2085
|
-
对应图片 base64 编码后大小不可超过5M。
|
|
2086
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
2087
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2088
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2089
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2090
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2174
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
|
2175
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
2176
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2177
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2178
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2179
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2091
2180
|
*/
|
|
2092
2181
|
Url?: string;
|
|
2093
2182
|
/**
|
|
2094
2183
|
* 是否返回年龄、性别、情绪等属性。
|
|
2095
|
-
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
|
2096
|
-
|
|
2097
|
-
|
|
2098
|
-
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
2099
|
-
关于各属性的详细描述,参见下文出参。
|
|
2100
|
-
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
2184
|
+
- 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
|
2185
|
+
- None为不需要返回。
|
|
2186
|
+
- 默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
|
2187
|
+
- 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
2188
|
+
- 关于各属性的详细描述,参见下文出参。
|
|
2189
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
2101
2190
|
*/
|
|
2102
2191
|
FaceAttributesType?: string;
|
|
2103
2192
|
/**
|
|
2104
|
-
* 是否开启图片旋转识别支持。
|
|
2193
|
+
* 是否开启图片旋转识别支持。
|
|
2194
|
+
- 0为不开启,1为开启。
|
|
2195
|
+
- 默认为0。
|
|
2196
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
2197
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
2105
2198
|
*/
|
|
2106
2199
|
NeedRotateDetection?: number;
|
|
2107
2200
|
/**
|
|
@@ -2311,7 +2404,8 @@ export interface VerifyPersonResponse {
|
|
|
2311
2404
|
*/
|
|
2312
2405
|
IsMatch?: boolean;
|
|
2313
2406
|
/**
|
|
2314
|
-
* 人脸识别所用的算法模型版本,是该 Person
|
|
2407
|
+
* 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
|
2408
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
|
2315
2409
|
*/
|
|
2316
2410
|
FaceModelVersion?: string;
|
|
2317
2411
|
/**
|
|
@@ -2332,7 +2426,8 @@ export interface DetectFaceResponse {
|
|
|
2332
2426
|
*/
|
|
2333
2427
|
ImageHeight?: number;
|
|
2334
2428
|
/**
|
|
2335
|
-
*
|
|
2429
|
+
* 人脸信息列表。
|
|
2430
|
+
- 包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
|
|
2336
2431
|
*/
|
|
2337
2432
|
FaceInfos?: Array<FaceInfo>;
|
|
2338
2433
|
/**
|
|
@@ -2429,24 +2524,26 @@ export interface GetPersonListRequest {
|
|
|
2429
2524
|
*/
|
|
2430
2525
|
export interface FaceDetailAttributesInfo {
|
|
2431
2526
|
/**
|
|
2432
|
-
*
|
|
2433
|
-
|
|
2527
|
+
* 年龄。
|
|
2528
|
+
- 取值范围: [0,65],其中65代表“65岁及以上”。
|
|
2529
|
+
- FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2434
2530
|
*/
|
|
2435
2531
|
Age?: number;
|
|
2436
2532
|
/**
|
|
2437
|
-
*
|
|
2438
|
-
|
|
2533
|
+
* 美丑打分。
|
|
2534
|
+
- 取值范围:[0,100]。
|
|
2535
|
+
- FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2439
2536
|
*/
|
|
2440
2537
|
Beauty?: number;
|
|
2441
2538
|
/**
|
|
2442
2539
|
* 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
|
2443
|
-
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6
|
|
2444
|
-
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2540
|
+
- AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕。
|
|
2541
|
+
- FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2445
2542
|
*/
|
|
2446
2543
|
Emotion?: AttributeItem;
|
|
2447
2544
|
/**
|
|
2448
2545
|
* 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
|
2449
|
-
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2546
|
+
- FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2450
2547
|
*/
|
|
2451
2548
|
Eye?: Eye;
|
|
2452
2549
|
/**
|
|
@@ -2456,63 +2553,64 @@ export interface FaceDetailAttributesInfo {
|
|
|
2456
2553
|
Eyebrow?: Eyebrow;
|
|
2457
2554
|
/**
|
|
2458
2555
|
* 性别信息。
|
|
2459
|
-
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2460
|
-
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2556
|
+
- AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2557
|
+
- FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2461
2558
|
*/
|
|
2462
2559
|
Gender?: AttributeItem;
|
|
2463
2560
|
/**
|
|
2464
2561
|
* 头发信息,包含头发长度、有无刘海、头发颜色。
|
|
2465
|
-
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2562
|
+
- FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2466
2563
|
*/
|
|
2467
2564
|
Hair?: Hair;
|
|
2468
2565
|
/**
|
|
2469
2566
|
* 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
|
2470
|
-
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2567
|
+
- FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2471
2568
|
*/
|
|
2472
2569
|
Hat?: Hat;
|
|
2473
2570
|
/**
|
|
2474
2571
|
* 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
|
2475
|
-
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2572
|
+
- FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2476
2573
|
*/
|
|
2477
2574
|
HeadPose?: HeadPose;
|
|
2478
2575
|
/**
|
|
2479
2576
|
* 口罩佩戴信息。
|
|
2480
|
-
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2481
|
-
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2577
|
+
- AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2578
|
+
- FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2482
2579
|
*/
|
|
2483
2580
|
Mask?: AttributeItem;
|
|
2484
2581
|
/**
|
|
2485
2582
|
* 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
|
2486
|
-
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2583
|
+
- FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2487
2584
|
*/
|
|
2488
2585
|
Mouth?: Mouth;
|
|
2489
2586
|
/**
|
|
2490
2587
|
* 胡子信息。
|
|
2491
|
-
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2492
|
-
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2588
|
+
- AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2589
|
+
- FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2493
2590
|
*/
|
|
2494
2591
|
Moustache?: AttributeItem;
|
|
2495
2592
|
/**
|
|
2496
2593
|
* 鼻子信息。
|
|
2497
|
-
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2498
|
-
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2594
|
+
- AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2595
|
+
- FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2499
2596
|
*/
|
|
2500
2597
|
Nose?: AttributeItem;
|
|
2501
2598
|
/**
|
|
2502
2599
|
* 脸型信息。
|
|
2503
|
-
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2504
|
-
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2600
|
+
- AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2601
|
+
- FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2505
2602
|
*/
|
|
2506
2603
|
Shape?: AttributeItem;
|
|
2507
2604
|
/**
|
|
2508
2605
|
* 肤色信息。
|
|
2509
|
-
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2510
|
-
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2606
|
+
- AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2607
|
+
- FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2511
2608
|
*/
|
|
2512
2609
|
Skin?: AttributeItem;
|
|
2513
2610
|
/**
|
|
2514
|
-
*
|
|
2515
|
-
|
|
2611
|
+
* 微笑程度
|
|
2612
|
+
- 取值范围:[0,100]。
|
|
2613
|
+
- FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2516
2614
|
*/
|
|
2517
2615
|
Smile?: number;
|
|
2518
2616
|
}
|
|
@@ -2521,11 +2619,12 @@ export interface FaceDetailAttributesInfo {
|
|
|
2521
2619
|
*/
|
|
2522
2620
|
export interface AttributeItem {
|
|
2523
2621
|
/**
|
|
2524
|
-
*
|
|
2622
|
+
* 属性值。
|
|
2525
2623
|
*/
|
|
2526
2624
|
Type?: number;
|
|
2527
2625
|
/**
|
|
2528
|
-
* Type
|
|
2626
|
+
* Type识别概率值。
|
|
2627
|
+
- 取值范围:[0,1],代表判断正确的概率。
|
|
2529
2628
|
*/
|
|
2530
2629
|
Probability?: number;
|
|
2531
2630
|
}
|
|
@@ -2535,24 +2634,24 @@ export interface AttributeItem {
|
|
|
2535
2634
|
export interface FaceRect {
|
|
2536
2635
|
/**
|
|
2537
2636
|
* 人脸框左上角横坐标。
|
|
2538
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2539
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2637
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2638
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2540
2639
|
*/
|
|
2541
|
-
X
|
|
2640
|
+
X?: number;
|
|
2542
2641
|
/**
|
|
2543
2642
|
* 人脸框左上角纵坐标。
|
|
2544
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2545
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2643
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2644
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2546
2645
|
*/
|
|
2547
|
-
Y
|
|
2646
|
+
Y?: number;
|
|
2548
2647
|
/**
|
|
2549
|
-
*
|
|
2648
|
+
* 人脸宽度。
|
|
2550
2649
|
*/
|
|
2551
|
-
Width
|
|
2650
|
+
Width?: number;
|
|
2552
2651
|
/**
|
|
2553
|
-
*
|
|
2652
|
+
* 人脸高度。
|
|
2554
2653
|
*/
|
|
2555
|
-
Height
|
|
2654
|
+
Height?: number;
|
|
2556
2655
|
}
|
|
2557
2656
|
/**
|
|
2558
2657
|
* ModifyPersonGroupInfo返回参数结构体
|