tencentcloud-sdk-nodejs-iai 4.0.431 → 4.0.434
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 +251 -1
- package/SERVICE_CHANGELOG.md +162 -62
- package/package.json +1 -1
- package/products.md +11 -11
- package/src/services/iai/index.ts +6 -9
- package/src/services/iai/v20180301/iai_client.ts +373 -278
- package/src/services/iai/v20180301/iai_models.ts +1532 -1627
- package/src/services/iai/v20180301/index.ts +3 -3
- package/src/services/iai/v20200303/iai_client.ts +394 -293
- package/src/services/iai/v20200303/iai_models.ts +1585 -1684
- package/src/services/iai/v20200303/index.ts +3 -3
- package/tencentcloud/services/iai/v20180301/iai_client.d.ts +186 -186
- package/tencentcloud/services/iai/v20180301/iai_client.js +186 -186
- package/tencentcloud/services/iai/v20180301/iai_models.d.ts +1174 -1174
- package/tencentcloud/services/iai/v20180301/index.js +1 -1
- package/tencentcloud/services/iai/v20200303/iai_client.d.ts +189 -189
- package/tencentcloud/services/iai/v20200303/iai_client.js +189 -189
- package/tencentcloud/services/iai/v20200303/iai_models.d.ts +1270 -1270
- package/tencentcloud/services/iai/v20200303/index.js +1 -1
|
@@ -3,24 +3,24 @@
|
|
|
3
3
|
*/
|
|
4
4
|
export interface Eye {
|
|
5
5
|
/**
|
|
6
|
-
|
|
7
|
-
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
|
8
|
-
|
|
6
|
+
* 识别是否佩戴眼镜。
|
|
7
|
+
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
|
8
|
+
*/
|
|
9
9
|
Glass: AttributeItem;
|
|
10
10
|
/**
|
|
11
|
-
|
|
12
|
-
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
13
|
-
|
|
11
|
+
* 识别眼睛的睁开、闭合状态。
|
|
12
|
+
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
13
|
+
*/
|
|
14
14
|
EyeOpen: AttributeItem;
|
|
15
15
|
/**
|
|
16
|
-
|
|
17
|
-
AttributeItem对应的Type为 —— 0:无,1:有。
|
|
18
|
-
|
|
16
|
+
* 识别是否双眼皮。
|
|
17
|
+
AttributeItem对应的Type为 —— 0:无,1:有。
|
|
18
|
+
*/
|
|
19
19
|
EyelidType: AttributeItem;
|
|
20
20
|
/**
|
|
21
|
-
|
|
22
|
-
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
|
23
|
-
|
|
21
|
+
* 眼睛大小。
|
|
22
|
+
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
|
23
|
+
*/
|
|
24
24
|
EyeSize: AttributeItem;
|
|
25
25
|
}
|
|
26
26
|
/**
|
|
@@ -28,37 +28,37 @@ AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大
|
|
|
28
28
|
*/
|
|
29
29
|
export interface Candidate {
|
|
30
30
|
/**
|
|
31
|
-
|
|
32
|
-
|
|
31
|
+
* 人员ID
|
|
32
|
+
*/
|
|
33
33
|
PersonId: string;
|
|
34
34
|
/**
|
|
35
|
-
|
|
36
|
-
|
|
35
|
+
* 人脸ID,仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索,该字段无意义
|
|
36
|
+
*/
|
|
37
37
|
FaceId: string;
|
|
38
38
|
/**
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
|
|
42
|
-
10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分;
|
|
43
|
-
30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
|
44
|
-
|
|
45
|
-
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
|
46
|
-
|
|
39
|
+
* 候选者的匹配得分。
|
|
40
|
+
|
|
41
|
+
1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
|
|
42
|
+
10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分;
|
|
43
|
+
30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
|
44
|
+
|
|
45
|
+
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
|
46
|
+
*/
|
|
47
47
|
Score: number;
|
|
48
48
|
/**
|
|
49
|
-
|
|
50
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
51
|
-
|
|
49
|
+
* 人员名称
|
|
50
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
51
|
+
*/
|
|
52
52
|
PersonName: string;
|
|
53
53
|
/**
|
|
54
|
-
|
|
55
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
56
|
-
|
|
54
|
+
* 人员性别
|
|
55
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
56
|
+
*/
|
|
57
57
|
Gender: number;
|
|
58
58
|
/**
|
|
59
|
-
|
|
60
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
61
|
-
|
|
59
|
+
* 包含此人员的人员库及描述字段内容列表
|
|
60
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
61
|
+
*/
|
|
62
62
|
PersonGroupInfos: Array<PersonGroupInfo>;
|
|
63
63
|
}
|
|
64
64
|
/**
|
|
@@ -66,24 +66,24 @@ export interface Candidate {
|
|
|
66
66
|
*/
|
|
67
67
|
export interface DetectFaceAttributesResponse {
|
|
68
68
|
/**
|
|
69
|
-
|
|
70
|
-
|
|
69
|
+
* 请求的图片宽度。
|
|
70
|
+
*/
|
|
71
71
|
ImageWidth: number;
|
|
72
72
|
/**
|
|
73
|
-
|
|
74
|
-
|
|
73
|
+
* 请求的图片高度。
|
|
74
|
+
*/
|
|
75
75
|
ImageHeight: number;
|
|
76
76
|
/**
|
|
77
|
-
|
|
78
|
-
|
|
77
|
+
* 人脸信息列表。
|
|
78
|
+
*/
|
|
79
79
|
FaceDetailInfos: Array<FaceDetailInfo>;
|
|
80
80
|
/**
|
|
81
|
-
|
|
82
|
-
|
|
81
|
+
* 人脸识别所用的算法模型版本。
|
|
82
|
+
*/
|
|
83
83
|
FaceModelVersion: string;
|
|
84
84
|
/**
|
|
85
|
-
|
|
86
|
-
|
|
85
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
86
|
+
*/
|
|
87
87
|
RequestId?: string;
|
|
88
88
|
}
|
|
89
89
|
/**
|
|
@@ -91,20 +91,20 @@ export interface DetectFaceAttributesResponse {
|
|
|
91
91
|
*/
|
|
92
92
|
export interface SearchPersonsReturnsByGroupResponse {
|
|
93
93
|
/**
|
|
94
|
-
|
|
95
|
-
|
|
94
|
+
* 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求,则返回0。
|
|
95
|
+
*/
|
|
96
96
|
PersonNum?: number;
|
|
97
97
|
/**
|
|
98
|
-
|
|
99
|
-
|
|
98
|
+
* 识别结果。
|
|
99
|
+
*/
|
|
100
100
|
ResultsReturnsByGroup?: Array<ResultsReturnsByGroup>;
|
|
101
101
|
/**
|
|
102
|
-
|
|
103
|
-
|
|
102
|
+
* 人脸识别所用的算法模型版本。
|
|
103
|
+
*/
|
|
104
104
|
FaceModelVersion?: string;
|
|
105
105
|
/**
|
|
106
|
-
|
|
107
|
-
|
|
106
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
107
|
+
*/
|
|
108
108
|
RequestId?: string;
|
|
109
109
|
}
|
|
110
110
|
/**
|
|
@@ -112,12 +112,12 @@ export interface SearchPersonsReturnsByGroupResponse {
|
|
|
112
112
|
*/
|
|
113
113
|
export interface PersonGroupInfo {
|
|
114
114
|
/**
|
|
115
|
-
|
|
116
|
-
|
|
115
|
+
* 包含此人员的人员库ID
|
|
116
|
+
*/
|
|
117
117
|
GroupId: string;
|
|
118
118
|
/**
|
|
119
|
-
|
|
120
|
-
|
|
119
|
+
* 人员描述字段内容
|
|
120
|
+
*/
|
|
121
121
|
PersonExDescriptions: Array<string>;
|
|
122
122
|
}
|
|
123
123
|
/**
|
|
@@ -125,14 +125,14 @@ export interface PersonGroupInfo {
|
|
|
125
125
|
*/
|
|
126
126
|
export interface Hat {
|
|
127
127
|
/**
|
|
128
|
-
|
|
129
|
-
AttributeItem对应的Type为 —— 0:不戴帽子,1:普通帽子,2:头盔,3:保安帽。
|
|
130
|
-
|
|
128
|
+
* 帽子佩戴状态信息。
|
|
129
|
+
AttributeItem对应的Type为 —— 0:不戴帽子,1:普通帽子,2:头盔,3:保安帽。
|
|
130
|
+
*/
|
|
131
131
|
Style: AttributeItem;
|
|
132
132
|
/**
|
|
133
|
-
|
|
134
|
-
AttributeItem对应的Type为 —— 0:不戴帽子,1:红色系,2:黄色系,3:蓝色系,4:黑色系,5:灰白色系,6:混色系子。
|
|
135
|
-
|
|
133
|
+
* 帽子颜色。
|
|
134
|
+
AttributeItem对应的Type为 —— 0:不戴帽子,1:红色系,2:黄色系,3:蓝色系,4:黑色系,5:灰白色系,6:混色系子。
|
|
135
|
+
*/
|
|
136
136
|
Color: AttributeItem;
|
|
137
137
|
}
|
|
138
138
|
/**
|
|
@@ -140,67 +140,67 @@ AttributeItem对应的Type为 —— 0:不戴帽子,1:红色系,2:黄
|
|
|
140
140
|
*/
|
|
141
141
|
export interface CreatePersonRequest {
|
|
142
142
|
/**
|
|
143
|
-
|
|
144
|
-
|
|
143
|
+
* 待加入的人员库ID,取值为创建人员库接口中的GroupId
|
|
144
|
+
*/
|
|
145
145
|
GroupId: string;
|
|
146
146
|
/**
|
|
147
|
-
|
|
148
|
-
|
|
147
|
+
* 人员名称。[1,60]个字符,可修改,可重复。
|
|
148
|
+
*/
|
|
149
149
|
PersonName: string;
|
|
150
150
|
/**
|
|
151
|
-
|
|
152
|
-
|
|
151
|
+
* 人员ID,单个腾讯云账号下不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
|
|
152
|
+
*/
|
|
153
153
|
PersonId: string;
|
|
154
154
|
/**
|
|
155
|
-
|
|
156
|
-
|
|
155
|
+
* 0代表未填写,1代表男性,2代表女性。
|
|
156
|
+
*/
|
|
157
157
|
Gender?: number;
|
|
158
158
|
/**
|
|
159
|
-
|
|
160
|
-
|
|
159
|
+
* 人员描述字段内容,key-value。[0,60]个字符,可修改,可重复。
|
|
160
|
+
*/
|
|
161
161
|
PersonExDescriptionInfos?: Array<PersonExDescriptionInfo>;
|
|
162
162
|
/**
|
|
163
|
-
|
|
164
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
165
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
166
|
-
|
|
163
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
164
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
165
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
166
|
+
*/
|
|
167
167
|
Image?: string;
|
|
168
168
|
/**
|
|
169
|
-
|
|
170
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
171
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
172
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
173
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
174
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
175
|
-
|
|
169
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
170
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
171
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
172
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
173
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
174
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
175
|
+
*/
|
|
176
176
|
Url?: string;
|
|
177
177
|
/**
|
|
178
|
-
|
|
179
|
-
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
180
|
-
如果判断没有,则完成创建人员。
|
|
181
|
-
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
|
182
|
-
1:较低的同一人判断要求(百一误识别率);
|
|
183
|
-
2: 一般的同一人判断要求(千一误识别率);
|
|
184
|
-
3: 较高的同一人判断要求(万一误识别率);
|
|
185
|
-
4: 很高的同一人判断要求(十万一误识别率)。
|
|
186
|
-
默认 0。
|
|
187
|
-
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
188
|
-
|
|
178
|
+
* 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
|
179
|
+
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
180
|
+
如果判断没有,则完成创建人员。
|
|
181
|
+
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
|
182
|
+
1:较低的同一人判断要求(百一误识别率);
|
|
183
|
+
2: 一般的同一人判断要求(千一误识别率);
|
|
184
|
+
3: 较高的同一人判断要求(万一误识别率);
|
|
185
|
+
4: 很高的同一人判断要求(十万一误识别率)。
|
|
186
|
+
默认 0。
|
|
187
|
+
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
188
|
+
*/
|
|
189
189
|
UniquePersonControl?: number;
|
|
190
190
|
/**
|
|
191
|
-
|
|
192
|
-
0: 不进行控制;
|
|
193
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
194
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
195
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
196
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
197
|
-
默认 0。
|
|
198
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
199
|
-
|
|
191
|
+
* 图片质量控制。
|
|
192
|
+
0: 不进行控制;
|
|
193
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
194
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
195
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
196
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
197
|
+
默认 0。
|
|
198
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
199
|
+
*/
|
|
200
200
|
QualityControl?: number;
|
|
201
201
|
/**
|
|
202
|
-
|
|
203
|
-
|
|
202
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
203
|
+
*/
|
|
204
204
|
NeedRotateDetection?: number;
|
|
205
205
|
}
|
|
206
206
|
/**
|
|
@@ -208,36 +208,36 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
208
208
|
*/
|
|
209
209
|
export interface CreateFaceResponse {
|
|
210
210
|
/**
|
|
211
|
-
|
|
212
|
-
|
|
211
|
+
* 加入成功的人脸数量
|
|
212
|
+
*/
|
|
213
213
|
SucFaceNum: number;
|
|
214
214
|
/**
|
|
215
|
-
|
|
216
|
-
|
|
215
|
+
* 加入成功的人脸ID列表
|
|
216
|
+
*/
|
|
217
217
|
SucFaceIds: Array<string>;
|
|
218
218
|
/**
|
|
219
|
-
|
|
220
|
-
-1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
|
|
221
|
-
其他非 0 值代表算法服务异常。
|
|
222
|
-
RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
223
|
-
|
|
219
|
+
* 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,
|
|
220
|
+
-1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
|
|
221
|
+
其他非 0 值代表算法服务异常。
|
|
222
|
+
RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
223
|
+
*/
|
|
224
224
|
RetCode: Array<number>;
|
|
225
225
|
/**
|
|
226
|
-
|
|
227
|
-
例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
|
228
|
-
|
|
226
|
+
* 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
|
|
227
|
+
例, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
|
228
|
+
*/
|
|
229
229
|
SucIndexes: Array<number>;
|
|
230
230
|
/**
|
|
231
|
-
|
|
232
|
-
|
|
231
|
+
* 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
|
|
232
|
+
*/
|
|
233
233
|
SucFaceRects: Array<FaceRect>;
|
|
234
234
|
/**
|
|
235
|
-
|
|
236
|
-
|
|
235
|
+
* 人脸识别所用的算法模型版本。
|
|
236
|
+
*/
|
|
237
237
|
FaceModelVersion: string;
|
|
238
238
|
/**
|
|
239
|
-
|
|
240
|
-
|
|
239
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
240
|
+
*/
|
|
241
241
|
RequestId?: string;
|
|
242
242
|
}
|
|
243
243
|
/**
|
|
@@ -245,19 +245,19 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
|
245
245
|
*/
|
|
246
246
|
export interface FaceHairAttributesInfo {
|
|
247
247
|
/**
|
|
248
|
-
|
|
249
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
250
|
-
|
|
248
|
+
* 0:光头,1:短发,2:中发,3:长发,4:绑发
|
|
249
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
250
|
+
*/
|
|
251
251
|
Length: number;
|
|
252
252
|
/**
|
|
253
|
-
|
|
254
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
255
|
-
|
|
253
|
+
* 0:有刘海,1:无刘海
|
|
254
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
255
|
+
*/
|
|
256
256
|
Bang: number;
|
|
257
257
|
/**
|
|
258
|
-
|
|
259
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
260
|
-
|
|
258
|
+
* 0:黑色,1:金色,2:棕色,3:灰白色
|
|
259
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
260
|
+
*/
|
|
261
261
|
Color: number;
|
|
262
262
|
}
|
|
263
263
|
/**
|
|
@@ -265,47 +265,47 @@ export interface FaceHairAttributesInfo {
|
|
|
265
265
|
*/
|
|
266
266
|
export interface CreateFaceRequest {
|
|
267
267
|
/**
|
|
268
|
-
|
|
269
|
-
|
|
268
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
269
|
+
*/
|
|
270
270
|
PersonId: string;
|
|
271
271
|
/**
|
|
272
|
-
|
|
273
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
274
|
-
人员人脸总数量不可超过5张。
|
|
275
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
276
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
277
|
-
|
|
272
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
273
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
274
|
+
人员人脸总数量不可超过5张。
|
|
275
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
276
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
277
|
+
*/
|
|
278
278
|
Images?: Array<string>;
|
|
279
279
|
/**
|
|
280
|
-
|
|
281
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
282
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
283
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
284
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
285
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
286
|
-
人员人脸总数量不可超过5张。
|
|
287
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
288
|
-
|
|
280
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
281
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
282
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
283
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
284
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
285
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
286
|
+
人员人脸总数量不可超过5张。
|
|
287
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
288
|
+
*/
|
|
289
289
|
Urls?: Array<string>;
|
|
290
290
|
/**
|
|
291
|
-
|
|
292
|
-
默认值60分。取值范围[0,100] 。
|
|
293
|
-
|
|
291
|
+
* 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
|
292
|
+
默认值60分。取值范围[0,100] 。
|
|
293
|
+
*/
|
|
294
294
|
FaceMatchThreshold?: number;
|
|
295
295
|
/**
|
|
296
|
-
|
|
297
|
-
0: 不进行控制;
|
|
298
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
299
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
300
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
301
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
302
|
-
默认 0。
|
|
303
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
304
|
-
|
|
296
|
+
* 图片质量控制。
|
|
297
|
+
0: 不进行控制;
|
|
298
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
299
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
300
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
301
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
302
|
+
默认 0。
|
|
303
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
304
|
+
*/
|
|
305
305
|
QualityControl?: number;
|
|
306
306
|
/**
|
|
307
|
-
|
|
308
|
-
|
|
307
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
308
|
+
*/
|
|
309
309
|
NeedRotateDetection?: number;
|
|
310
310
|
}
|
|
311
311
|
/**
|
|
@@ -313,38 +313,38 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
313
313
|
*/
|
|
314
314
|
export interface CreateGroupRequest {
|
|
315
315
|
/**
|
|
316
|
-
|
|
317
|
-
|
|
316
|
+
* 人员库名称,[1,60]个字符,可修改,不可重复。
|
|
317
|
+
*/
|
|
318
318
|
GroupName: string;
|
|
319
319
|
/**
|
|
320
|
-
|
|
321
|
-
|
|
320
|
+
* 人员库 ID,不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
|
|
321
|
+
*/
|
|
322
322
|
GroupId: string;
|
|
323
323
|
/**
|
|
324
|
-
|
|
325
|
-
最多可以创建5个。
|
|
326
|
-
每个自定义描述字段支持[1,30]个字符。
|
|
327
|
-
在同一人员库中自定义描述字段不可重复。
|
|
328
|
-
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
|
329
|
-
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
|
330
|
-
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
331
|
-
|
|
324
|
+
* 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
|
325
|
+
最多可以创建5个。
|
|
326
|
+
每个自定义描述字段支持[1,30]个字符。
|
|
327
|
+
在同一人员库中自定义描述字段不可重复。
|
|
328
|
+
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
|
329
|
+
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
|
330
|
+
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
331
|
+
*/
|
|
332
332
|
GroupExDescriptions?: Array<string>;
|
|
333
333
|
/**
|
|
334
|
-
|
|
335
|
-
|
|
334
|
+
* 人员库信息备注,[0,40]个字符。
|
|
335
|
+
*/
|
|
336
336
|
Tag?: string;
|
|
337
337
|
/**
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
341
|
-
|
|
342
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
343
|
-
|
|
344
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
345
|
-
|
|
346
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
347
|
-
|
|
338
|
+
* 人脸识别服务所用的算法模型版本。
|
|
339
|
+
|
|
340
|
+
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
341
|
+
|
|
342
|
+
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
343
|
+
|
|
344
|
+
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
345
|
+
|
|
346
|
+
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
347
|
+
*/
|
|
348
348
|
FaceModelVersion?: string;
|
|
349
349
|
}
|
|
350
350
|
/**
|
|
@@ -352,16 +352,16 @@ export interface CreateGroupRequest {
|
|
|
352
352
|
*/
|
|
353
353
|
export interface GetPersonGroupInfoRequest {
|
|
354
354
|
/**
|
|
355
|
-
|
|
356
|
-
|
|
355
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
356
|
+
*/
|
|
357
357
|
PersonId: string;
|
|
358
358
|
/**
|
|
359
|
-
|
|
360
|
-
|
|
359
|
+
* 起始序号,默认值为0
|
|
360
|
+
*/
|
|
361
361
|
Offset?: number;
|
|
362
362
|
/**
|
|
363
|
-
|
|
364
|
-
|
|
363
|
+
* 返回数量,默认值为10,最大值为100
|
|
364
|
+
*/
|
|
365
365
|
Limit?: number;
|
|
366
366
|
}
|
|
367
367
|
/**
|
|
@@ -369,34 +369,34 @@ export interface GetPersonGroupInfoRequest {
|
|
|
369
369
|
*/
|
|
370
370
|
export interface FaceInfo {
|
|
371
371
|
/**
|
|
372
|
-
|
|
373
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
374
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
375
|
-
|
|
372
|
+
* 人脸框左上角横坐标。
|
|
373
|
+
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
374
|
+
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
375
|
+
*/
|
|
376
376
|
X: number;
|
|
377
377
|
/**
|
|
378
|
-
|
|
379
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
380
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
381
|
-
|
|
378
|
+
* 人脸框左上角纵坐标。
|
|
379
|
+
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
380
|
+
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
|
381
|
+
*/
|
|
382
382
|
Y: number;
|
|
383
383
|
/**
|
|
384
|
-
|
|
385
|
-
|
|
384
|
+
* 人脸框宽度。
|
|
385
|
+
*/
|
|
386
386
|
Width: number;
|
|
387
387
|
/**
|
|
388
|
-
|
|
389
|
-
|
|
388
|
+
* 人脸框高度。
|
|
389
|
+
*/
|
|
390
390
|
Height: number;
|
|
391
391
|
/**
|
|
392
|
-
|
|
393
|
-
魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
|
394
|
-
|
|
392
|
+
* 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
|
|
393
|
+
魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
|
394
|
+
*/
|
|
395
395
|
FaceAttributesInfo: FaceAttributesInfo;
|
|
396
396
|
/**
|
|
397
|
-
|
|
398
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
399
|
-
|
|
397
|
+
* 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
|
|
398
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
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
|
-
|
|
408
|
-
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
409
|
-
|
|
407
|
+
* 眉毛浓密。
|
|
408
|
+
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
409
|
+
*/
|
|
410
410
|
EyebrowDensity: AttributeItem;
|
|
411
411
|
/**
|
|
412
|
-
|
|
413
|
-
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
414
|
-
|
|
412
|
+
* 眉毛弯曲。
|
|
413
|
+
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
414
|
+
*/
|
|
415
415
|
EyebrowCurve: AttributeItem;
|
|
416
416
|
/**
|
|
417
|
-
|
|
418
|
-
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
419
|
-
|
|
417
|
+
* 眉毛长短。
|
|
418
|
+
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
419
|
+
*/
|
|
420
420
|
EyebrowLength: AttributeItem;
|
|
421
421
|
}
|
|
422
422
|
/**
|
|
@@ -424,33 +424,33 @@ AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
|
424
424
|
*/
|
|
425
425
|
export interface AnalyzeDenseLandmarksRequest {
|
|
426
426
|
/**
|
|
427
|
-
|
|
428
|
-
默认为 0。
|
|
429
|
-
最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
430
|
-
|
|
427
|
+
* 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
|
428
|
+
默认为 0。
|
|
429
|
+
最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
430
|
+
*/
|
|
431
431
|
Mode?: number;
|
|
432
432
|
/**
|
|
433
|
-
|
|
434
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
435
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
436
|
-
|
|
433
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
434
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
435
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
436
|
+
*/
|
|
437
437
|
Image?: string;
|
|
438
438
|
/**
|
|
439
|
-
|
|
440
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
441
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
442
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
443
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
444
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
445
|
-
|
|
439
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
440
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
441
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
442
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
443
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
444
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
445
|
+
*/
|
|
446
446
|
Url?: string;
|
|
447
447
|
/**
|
|
448
|
-
|
|
449
|
-
|
|
448
|
+
* 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
|
449
|
+
*/
|
|
450
450
|
FaceModelVersion?: string;
|
|
451
451
|
/**
|
|
452
|
-
|
|
453
|
-
|
|
452
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
453
|
+
*/
|
|
454
454
|
NeedRotateDetection?: number;
|
|
455
455
|
}
|
|
456
456
|
/**
|
|
@@ -458,12 +458,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
458
458
|
*/
|
|
459
459
|
export interface GetGroupListRequest {
|
|
460
460
|
/**
|
|
461
|
-
|
|
462
|
-
|
|
461
|
+
* 起始序号,默认值为0
|
|
462
|
+
*/
|
|
463
463
|
Offset?: number;
|
|
464
464
|
/**
|
|
465
|
-
|
|
466
|
-
|
|
465
|
+
* 返回数量,默认值为10,最大值为1000
|
|
466
|
+
*/
|
|
467
467
|
Limit?: number;
|
|
468
468
|
}
|
|
469
469
|
/**
|
|
@@ -471,12 +471,12 @@ export interface GetGroupListRequest {
|
|
|
471
471
|
*/
|
|
472
472
|
export interface GetUpgradeGroupFaceModelVersionJobListRequest {
|
|
473
473
|
/**
|
|
474
|
-
|
|
475
|
-
|
|
474
|
+
* 起始序号,默认值为0。
|
|
475
|
+
*/
|
|
476
476
|
Offset?: number;
|
|
477
477
|
/**
|
|
478
|
-
|
|
479
|
-
|
|
478
|
+
* 返回数量,默认值为10,最大值为1000。
|
|
479
|
+
*/
|
|
480
480
|
Limit?: number;
|
|
481
481
|
}
|
|
482
482
|
/**
|
|
@@ -484,45 +484,45 @@ export interface GetUpgradeGroupFaceModelVersionJobListRequest {
|
|
|
484
484
|
*/
|
|
485
485
|
export interface GetUpgradeGroupFaceModelVersionResultResponse {
|
|
486
486
|
/**
|
|
487
|
-
|
|
488
|
-
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
489
|
-
如果为0表示这个任务已经执行完毕。
|
|
490
|
-
|
|
487
|
+
* 人员升级任务预估结束时间。 StartTimestamp的值是自 Unix 纪元时间到人员查重任务预估结束的毫秒数。
|
|
488
|
+
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
489
|
+
如果为0表示这个任务已经执行完毕。
|
|
490
|
+
*/
|
|
491
491
|
EndTimestamp: number;
|
|
492
492
|
/**
|
|
493
|
-
|
|
494
|
-
|
|
493
|
+
* 升级任务完成进度。取值[0.0,100.0]。
|
|
494
|
+
*/
|
|
495
495
|
Progress: number;
|
|
496
496
|
/**
|
|
497
|
-
|
|
498
|
-
|
|
497
|
+
* 0表示升级中,1表示升级完毕,2表示回滚完毕,3表示升级失败。
|
|
498
|
+
*/
|
|
499
499
|
Status: number;
|
|
500
500
|
/**
|
|
501
|
-
|
|
502
|
-
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
503
|
-
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
504
|
-
有关更多信息,请参阅 Unix 时间。
|
|
505
|
-
|
|
501
|
+
* 升级起始时间。
|
|
502
|
+
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
503
|
+
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
504
|
+
有关更多信息,请参阅 Unix 时间。
|
|
505
|
+
*/
|
|
506
506
|
StartTime: number;
|
|
507
507
|
/**
|
|
508
|
-
|
|
509
|
-
|
|
508
|
+
* 当前算法模型版本。
|
|
509
|
+
*/
|
|
510
510
|
FromFaceModelVersion: string;
|
|
511
511
|
/**
|
|
512
|
-
|
|
513
|
-
|
|
512
|
+
* 目标算法模型版本。
|
|
513
|
+
*/
|
|
514
514
|
ToFaceModelVersion: string;
|
|
515
515
|
/**
|
|
516
|
-
|
|
517
|
-
|
|
516
|
+
* 人员库ID。
|
|
517
|
+
*/
|
|
518
518
|
GroupId: string;
|
|
519
519
|
/**
|
|
520
|
-
|
|
521
|
-
|
|
520
|
+
* 无法升级的人脸Id信息,文件格式为json。内容参见下方示例。url有效期为半小时。
|
|
521
|
+
*/
|
|
522
522
|
FailedFacesUrl: string;
|
|
523
523
|
/**
|
|
524
|
-
|
|
525
|
-
|
|
524
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
525
|
+
*/
|
|
526
526
|
RequestId?: string;
|
|
527
527
|
}
|
|
528
528
|
/**
|
|
@@ -530,16 +530,16 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
|
530
530
|
*/
|
|
531
531
|
export interface DetectLiveFaceAccurateResponse {
|
|
532
532
|
/**
|
|
533
|
-
|
|
534
|
-
|
|
533
|
+
* 活体打分,取值范围 [0,100],根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
|
|
534
|
+
*/
|
|
535
535
|
Score: number;
|
|
536
536
|
/**
|
|
537
|
-
|
|
538
|
-
|
|
537
|
+
* 人脸识别所用的算法模型版本。
|
|
538
|
+
*/
|
|
539
539
|
FaceModelVersion: string;
|
|
540
540
|
/**
|
|
541
|
-
|
|
542
|
-
|
|
541
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
542
|
+
*/
|
|
543
543
|
RequestId?: string;
|
|
544
544
|
}
|
|
545
545
|
/**
|
|
@@ -547,39 +547,39 @@ export interface DetectLiveFaceAccurateResponse {
|
|
|
547
547
|
*/
|
|
548
548
|
export interface AnalyzeFaceRequest {
|
|
549
549
|
/**
|
|
550
|
-
|
|
551
|
-
|
|
550
|
+
* 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
|
551
|
+
*/
|
|
552
552
|
Mode?: number;
|
|
553
553
|
/**
|
|
554
|
-
|
|
555
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
556
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
557
|
-
|
|
554
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
555
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
556
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
557
|
+
*/
|
|
558
558
|
Image?: string;
|
|
559
559
|
/**
|
|
560
|
-
|
|
561
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
562
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
563
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
564
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
565
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
566
|
-
|
|
560
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
561
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
562
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
563
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
564
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
565
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
566
|
+
*/
|
|
567
567
|
Url?: string;
|
|
568
568
|
/**
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
572
|
-
|
|
573
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
574
|
-
|
|
575
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
576
|
-
|
|
577
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
578
|
-
|
|
569
|
+
* 人脸识别服务所用的算法模型版本。
|
|
570
|
+
|
|
571
|
+
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
572
|
+
|
|
573
|
+
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
574
|
+
|
|
575
|
+
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
576
|
+
|
|
577
|
+
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
578
|
+
*/
|
|
579
579
|
FaceModelVersion?: string;
|
|
580
580
|
/**
|
|
581
|
-
|
|
582
|
-
|
|
581
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
582
|
+
*/
|
|
583
583
|
NeedRotateDetection?: number;
|
|
584
584
|
}
|
|
585
585
|
/**
|
|
@@ -587,26 +587,26 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
587
587
|
*/
|
|
588
588
|
export interface CreatePersonResponse {
|
|
589
589
|
/**
|
|
590
|
-
|
|
591
|
-
|
|
590
|
+
* 人脸图片唯一标识。
|
|
591
|
+
*/
|
|
592
592
|
FaceId: string;
|
|
593
593
|
/**
|
|
594
|
-
|
|
595
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
596
|
-
|
|
594
|
+
* 检测出的人脸框的位置。
|
|
595
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
596
|
+
*/
|
|
597
597
|
FaceRect: FaceRect;
|
|
598
598
|
/**
|
|
599
|
-
|
|
600
|
-
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
601
|
-
|
|
599
|
+
* 疑似同一人的PersonId。
|
|
600
|
+
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
601
|
+
*/
|
|
602
602
|
SimilarPersonId: string;
|
|
603
603
|
/**
|
|
604
|
-
|
|
605
|
-
|
|
604
|
+
* 人脸识别所用的算法模型版本。
|
|
605
|
+
*/
|
|
606
606
|
FaceModelVersion: string;
|
|
607
607
|
/**
|
|
608
|
-
|
|
609
|
-
|
|
608
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
609
|
+
*/
|
|
610
610
|
RequestId?: string;
|
|
611
611
|
}
|
|
612
612
|
/**
|
|
@@ -614,20 +614,20 @@ export interface CreatePersonResponse {
|
|
|
614
614
|
*/
|
|
615
615
|
export interface SearchFacesResponse {
|
|
616
616
|
/**
|
|
617
|
-
|
|
618
|
-
|
|
617
|
+
* 识别结果。
|
|
618
|
+
*/
|
|
619
619
|
Results: Array<Result>;
|
|
620
620
|
/**
|
|
621
|
-
|
|
622
|
-
|
|
621
|
+
* 搜索的人员库中包含的人脸数。
|
|
622
|
+
*/
|
|
623
623
|
FaceNum: number;
|
|
624
624
|
/**
|
|
625
|
-
|
|
626
|
-
|
|
625
|
+
* 人脸识别所用的算法模型版本。
|
|
626
|
+
*/
|
|
627
627
|
FaceModelVersion: string;
|
|
628
628
|
/**
|
|
629
|
-
|
|
630
|
-
|
|
629
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
630
|
+
*/
|
|
631
631
|
RequestId?: string;
|
|
632
632
|
}
|
|
633
633
|
/**
|
|
@@ -635,16 +635,16 @@ export interface SearchFacesResponse {
|
|
|
635
635
|
*/
|
|
636
636
|
export interface CopyPersonResponse {
|
|
637
637
|
/**
|
|
638
|
-
|
|
639
|
-
|
|
638
|
+
* 成功加入的人员库数量
|
|
639
|
+
*/
|
|
640
640
|
SucGroupNum?: number;
|
|
641
641
|
/**
|
|
642
|
-
|
|
643
|
-
|
|
642
|
+
* 成功加入的人员库列表
|
|
643
|
+
*/
|
|
644
644
|
SucGroupIds?: Array<string>;
|
|
645
645
|
/**
|
|
646
|
-
|
|
647
|
-
|
|
646
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
647
|
+
*/
|
|
648
648
|
RequestId?: string;
|
|
649
649
|
}
|
|
650
650
|
/**
|
|
@@ -652,12 +652,12 @@ export interface CopyPersonResponse {
|
|
|
652
652
|
*/
|
|
653
653
|
export interface GroupCandidate {
|
|
654
654
|
/**
|
|
655
|
-
|
|
656
|
-
|
|
655
|
+
* 人员库ID 。
|
|
656
|
+
*/
|
|
657
657
|
GroupId: string;
|
|
658
658
|
/**
|
|
659
|
-
|
|
660
|
-
|
|
659
|
+
* 识别出的最相似候选人。
|
|
660
|
+
*/
|
|
661
661
|
Candidates: Array<Candidate>;
|
|
662
662
|
}
|
|
663
663
|
/**
|
|
@@ -665,16 +665,16 @@ export interface GroupCandidate {
|
|
|
665
665
|
*/
|
|
666
666
|
export interface DeleteFaceResponse {
|
|
667
667
|
/**
|
|
668
|
-
|
|
669
|
-
|
|
668
|
+
* 删除成功的人脸数量
|
|
669
|
+
*/
|
|
670
670
|
SucDeletedNum?: number;
|
|
671
671
|
/**
|
|
672
|
-
|
|
673
|
-
|
|
672
|
+
* 删除成功的人脸ID列表
|
|
673
|
+
*/
|
|
674
674
|
SucFaceIds?: Array<string>;
|
|
675
675
|
/**
|
|
676
|
-
|
|
677
|
-
|
|
676
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
677
|
+
*/
|
|
678
678
|
RequestId?: string;
|
|
679
679
|
}
|
|
680
680
|
/**
|
|
@@ -682,8 +682,8 @@ export interface DeleteFaceResponse {
|
|
|
682
682
|
*/
|
|
683
683
|
export interface DeletePersonRequest {
|
|
684
684
|
/**
|
|
685
|
-
|
|
686
|
-
|
|
685
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
686
|
+
*/
|
|
687
687
|
PersonId: string;
|
|
688
688
|
}
|
|
689
689
|
/**
|
|
@@ -691,22 +691,22 @@ export interface DeletePersonRequest {
|
|
|
691
691
|
*/
|
|
692
692
|
export interface DetectLiveFaceResponse {
|
|
693
693
|
/**
|
|
694
|
-
|
|
695
|
-
本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
|
|
696
|
-
|
|
694
|
+
* 活体打分,取值范围 [0,100],分数一般落于[80, 100]区间内,0分也为常见值。推荐相大于 87 时可判断为活体。可根据具体场景自行调整阈值。
|
|
695
|
+
本字段当且仅当FaceModelVersion为2.0时才具备参考意义。
|
|
696
|
+
*/
|
|
697
697
|
Score: number;
|
|
698
698
|
/**
|
|
699
|
-
|
|
700
|
-
|
|
699
|
+
* 人脸识别所用的算法模型版本。
|
|
700
|
+
*/
|
|
701
701
|
FaceModelVersion: string;
|
|
702
702
|
/**
|
|
703
|
-
|
|
704
|
-
本字段只有FaceModelVersion为3.0时才具备参考意义。
|
|
705
|
-
|
|
703
|
+
* 活体检测是否通过。
|
|
704
|
+
本字段只有FaceModelVersion为3.0时才具备参考意义。
|
|
705
|
+
*/
|
|
706
706
|
IsLiveness: boolean;
|
|
707
707
|
/**
|
|
708
|
-
|
|
709
|
-
|
|
708
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
709
|
+
*/
|
|
710
710
|
RequestId?: string;
|
|
711
711
|
}
|
|
712
712
|
/**
|
|
@@ -714,12 +714,12 @@ export interface DetectLiveFaceResponse {
|
|
|
714
714
|
*/
|
|
715
715
|
export interface DeleteFaceRequest {
|
|
716
716
|
/**
|
|
717
|
-
|
|
718
|
-
|
|
717
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
718
|
+
*/
|
|
719
719
|
PersonId: string;
|
|
720
720
|
/**
|
|
721
|
-
|
|
722
|
-
|
|
721
|
+
* 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId
|
|
722
|
+
*/
|
|
723
723
|
FaceIds: Array<string>;
|
|
724
724
|
}
|
|
725
725
|
/**
|
|
@@ -727,20 +727,20 @@ export interface DeleteFaceRequest {
|
|
|
727
727
|
*/
|
|
728
728
|
export interface ModifyGroupRequest {
|
|
729
729
|
/**
|
|
730
|
-
|
|
731
|
-
|
|
730
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
731
|
+
*/
|
|
732
732
|
GroupId: string;
|
|
733
733
|
/**
|
|
734
|
-
|
|
735
|
-
|
|
734
|
+
* 人员库名称
|
|
735
|
+
*/
|
|
736
736
|
GroupName?: string;
|
|
737
737
|
/**
|
|
738
|
-
|
|
739
|
-
|
|
738
|
+
* 需要修改的人员库自定义描述字段,key-value
|
|
739
|
+
*/
|
|
740
740
|
GroupExDescriptionInfos?: Array<GroupExDescriptionInfo>;
|
|
741
741
|
/**
|
|
742
|
-
|
|
743
|
-
|
|
742
|
+
* 人员库信息备注
|
|
743
|
+
*/
|
|
744
744
|
Tag?: string;
|
|
745
745
|
}
|
|
746
746
|
/**
|
|
@@ -748,8 +748,8 @@ export interface ModifyGroupRequest {
|
|
|
748
748
|
*/
|
|
749
749
|
export interface DeleteGroupRequest {
|
|
750
750
|
/**
|
|
751
|
-
|
|
752
|
-
|
|
751
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
752
|
+
*/
|
|
753
753
|
GroupId: string;
|
|
754
754
|
}
|
|
755
755
|
/**
|
|
@@ -757,12 +757,12 @@ export interface DeleteGroupRequest {
|
|
|
757
757
|
*/
|
|
758
758
|
export interface UpgradeGroupFaceModelVersionRequest {
|
|
759
759
|
/**
|
|
760
|
-
|
|
761
|
-
|
|
760
|
+
* 需要升级的人员库ID。
|
|
761
|
+
*/
|
|
762
762
|
GroupId: string;
|
|
763
763
|
/**
|
|
764
|
-
|
|
765
|
-
|
|
764
|
+
* 需要升级至的算法模型版本。默认为最新版本。不可逆向升级
|
|
765
|
+
*/
|
|
766
766
|
FaceModelVersion: string;
|
|
767
767
|
}
|
|
768
768
|
/**
|
|
@@ -770,32 +770,32 @@ export interface UpgradeGroupFaceModelVersionRequest {
|
|
|
770
770
|
*/
|
|
771
771
|
export interface DetectLiveFaceRequest {
|
|
772
772
|
/**
|
|
773
|
-
|
|
774
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
|
|
775
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
776
|
-
|
|
773
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
774
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。(图片的宽高比请接近3:4,不符合宽高比的图片返回的分值不具备参考意义)。
|
|
775
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
776
|
+
*/
|
|
777
777
|
Image?: string;
|
|
778
778
|
/**
|
|
779
|
-
|
|
780
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
781
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
782
|
-
(图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
|
|
783
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
784
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
785
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
786
|
-
|
|
779
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
780
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
781
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
782
|
+
(图片的宽高比请接近 3:4,不符合宽高比的图片返回的分值不具备参考意义)
|
|
783
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
784
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
785
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
786
|
+
*/
|
|
787
787
|
Url?: string;
|
|
788
788
|
/**
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
792
|
-
|
|
793
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
794
|
-
|
|
795
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
796
|
-
|
|
797
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
798
|
-
|
|
789
|
+
* 人脸识别服务所用的算法模型版本。
|
|
790
|
+
|
|
791
|
+
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
792
|
+
|
|
793
|
+
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
794
|
+
|
|
795
|
+
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
796
|
+
|
|
797
|
+
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
798
|
+
*/
|
|
799
799
|
FaceModelVersion?: string;
|
|
800
800
|
}
|
|
801
801
|
/**
|
|
@@ -803,20 +803,20 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
803
803
|
*/
|
|
804
804
|
export interface GetPersonBaseInfoResponse {
|
|
805
805
|
/**
|
|
806
|
-
|
|
807
|
-
|
|
806
|
+
* 人员名称
|
|
807
|
+
*/
|
|
808
808
|
PersonName?: string;
|
|
809
809
|
/**
|
|
810
|
-
|
|
811
|
-
|
|
810
|
+
* 人员性别,0代表未填写,1代表男性,2代表女性
|
|
811
|
+
*/
|
|
812
812
|
Gender?: number;
|
|
813
813
|
/**
|
|
814
|
-
|
|
815
|
-
|
|
814
|
+
* 包含的人脸 ID 列表
|
|
815
|
+
*/
|
|
816
816
|
FaceIds?: Array<string>;
|
|
817
817
|
/**
|
|
818
|
-
|
|
819
|
-
|
|
818
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
819
|
+
*/
|
|
820
820
|
RequestId?: string;
|
|
821
821
|
}
|
|
822
822
|
/**
|
|
@@ -824,21 +824,21 @@ export interface GetPersonBaseInfoResponse {
|
|
|
824
824
|
*/
|
|
825
825
|
export interface SearchPersonsResponse {
|
|
826
826
|
/**
|
|
827
|
-
|
|
828
|
-
|
|
827
|
+
* 识别结果。
|
|
828
|
+
*/
|
|
829
829
|
Results: Array<Result>;
|
|
830
830
|
/**
|
|
831
|
-
|
|
832
|
-
|
|
831
|
+
* 搜索的人员库中包含的人员数。若输入图片中所有人脸均不符合质量要求,则返回0。
|
|
832
|
+
*/
|
|
833
833
|
PersonNum: number;
|
|
834
834
|
/**
|
|
835
|
-
|
|
836
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
837
|
-
|
|
835
|
+
* 人脸识别所用的算法模型版本。
|
|
836
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
837
|
+
*/
|
|
838
838
|
FaceModelVersion: string;
|
|
839
839
|
/**
|
|
840
|
-
|
|
841
|
-
|
|
840
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
841
|
+
*/
|
|
842
842
|
RequestId?: string;
|
|
843
843
|
}
|
|
844
844
|
/**
|
|
@@ -846,8 +846,8 @@ export interface SearchPersonsResponse {
|
|
|
846
846
|
*/
|
|
847
847
|
export interface GetUpgradeGroupFaceModelVersionResultRequest {
|
|
848
848
|
/**
|
|
849
|
-
|
|
850
|
-
|
|
849
|
+
* 升级任务ID,用于查询、获取人员库升级的进度和结果。
|
|
850
|
+
*/
|
|
851
851
|
JobId: string;
|
|
852
852
|
}
|
|
853
853
|
/**
|
|
@@ -855,33 +855,33 @@ export interface GetUpgradeGroupFaceModelVersionResultRequest {
|
|
|
855
855
|
*/
|
|
856
856
|
export interface GroupInfo {
|
|
857
857
|
/**
|
|
858
|
-
|
|
859
|
-
|
|
858
|
+
* 人员库名称
|
|
859
|
+
*/
|
|
860
860
|
GroupName: string;
|
|
861
861
|
/**
|
|
862
|
-
|
|
863
|
-
|
|
862
|
+
* 人员库ID
|
|
863
|
+
*/
|
|
864
864
|
GroupId: string;
|
|
865
865
|
/**
|
|
866
|
-
|
|
867
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
868
|
-
|
|
866
|
+
* 人员库自定义描述字段
|
|
867
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
868
|
+
*/
|
|
869
869
|
GroupExDescriptions: Array<string>;
|
|
870
870
|
/**
|
|
871
|
-
|
|
872
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
873
|
-
|
|
871
|
+
* 人员库信息备注
|
|
872
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
873
|
+
*/
|
|
874
874
|
Tag: string;
|
|
875
875
|
/**
|
|
876
|
-
|
|
877
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
878
|
-
|
|
876
|
+
* 人脸识别所用的算法模型版本。
|
|
877
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
878
|
+
*/
|
|
879
879
|
FaceModelVersion: string;
|
|
880
880
|
/**
|
|
881
|
-
|
|
882
|
-
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
883
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
884
|
-
|
|
881
|
+
* Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
882
|
+
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
883
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
884
|
+
*/
|
|
885
885
|
CreationTimestamp: number;
|
|
886
886
|
}
|
|
887
887
|
/**
|
|
@@ -889,31 +889,31 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
|
889
889
|
*/
|
|
890
890
|
export interface FaceQualityInfo {
|
|
891
891
|
/**
|
|
892
|
-
|
|
893
|
-
正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
|
894
|
-
参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
|
895
|
-
建议:人脸入库选取70以上的图片。
|
|
896
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
897
|
-
|
|
892
|
+
* 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
|
893
|
+
正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
|
894
|
+
参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
|
895
|
+
建议:人脸入库选取70以上的图片。
|
|
896
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
897
|
+
*/
|
|
898
898
|
Score: number;
|
|
899
899
|
/**
|
|
900
|
-
|
|
901
|
-
参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
|
902
|
-
建议:人脸入库选取80以上的图片。
|
|
903
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
904
|
-
|
|
900
|
+
* 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
|
|
901
|
+
参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
|
902
|
+
建议:人脸入库选取80以上的图片。
|
|
903
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
904
|
+
*/
|
|
905
905
|
Sharpness: number;
|
|
906
906
|
/**
|
|
907
|
-
|
|
908
|
-
参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
|
909
|
-
建议:人脸入库选取[30,70]的图片。
|
|
910
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
911
|
-
|
|
907
|
+
* 光照分:[0,100],评价图片光照程度,分数越高越亮。
|
|
908
|
+
参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
|
909
|
+
建议:人脸入库选取[30,70]的图片。
|
|
910
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
911
|
+
*/
|
|
912
912
|
Brightness: number;
|
|
913
913
|
/**
|
|
914
|
-
|
|
915
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
916
|
-
|
|
914
|
+
* 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
|
915
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
916
|
+
*/
|
|
917
917
|
Completeness: FaceQualityCompleteness;
|
|
918
918
|
}
|
|
919
919
|
/**
|
|
@@ -921,20 +921,20 @@ export interface FaceQualityInfo {
|
|
|
921
921
|
*/
|
|
922
922
|
export interface SearchFacesReturnsByGroupResponse {
|
|
923
923
|
/**
|
|
924
|
-
|
|
925
|
-
|
|
924
|
+
* 搜索的人员库中包含的人脸数。
|
|
925
|
+
*/
|
|
926
926
|
FaceNum: number;
|
|
927
927
|
/**
|
|
928
|
-
|
|
929
|
-
|
|
928
|
+
* 识别结果。
|
|
929
|
+
*/
|
|
930
930
|
ResultsReturnsByGroup: Array<ResultsReturnsByGroup>;
|
|
931
931
|
/**
|
|
932
|
-
|
|
933
|
-
|
|
932
|
+
* 人脸识别所用的算法模型版本。
|
|
933
|
+
*/
|
|
934
934
|
FaceModelVersion: string;
|
|
935
935
|
/**
|
|
936
|
-
|
|
937
|
-
|
|
936
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
937
|
+
*/
|
|
938
938
|
RequestId?: string;
|
|
939
939
|
}
|
|
940
940
|
/**
|
|
@@ -942,12 +942,12 @@ export interface SearchFacesReturnsByGroupResponse {
|
|
|
942
942
|
*/
|
|
943
943
|
export interface CopyPersonRequest {
|
|
944
944
|
/**
|
|
945
|
-
|
|
946
|
-
|
|
945
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
946
|
+
*/
|
|
947
947
|
PersonId: string;
|
|
948
948
|
/**
|
|
949
|
-
|
|
950
|
-
|
|
949
|
+
* 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId
|
|
950
|
+
*/
|
|
951
951
|
GroupIds: Array<string>;
|
|
952
952
|
}
|
|
953
953
|
/**
|
|
@@ -955,61 +955,61 @@ export interface CopyPersonRequest {
|
|
|
955
955
|
*/
|
|
956
956
|
export interface SearchPersonsReturnsByGroupRequest {
|
|
957
957
|
/**
|
|
958
|
-
|
|
959
|
-
|
|
958
|
+
* 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId
|
|
959
|
+
*/
|
|
960
960
|
GroupIds: Array<string>;
|
|
961
961
|
/**
|
|
962
|
-
|
|
963
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
964
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
965
|
-
|
|
962
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
963
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
964
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
965
|
+
*/
|
|
966
966
|
Image?: string;
|
|
967
967
|
/**
|
|
968
|
-
|
|
969
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
970
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
971
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
972
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
973
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
974
|
-
|
|
968
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
969
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
970
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
971
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
972
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
973
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
974
|
+
*/
|
|
975
975
|
Url?: string;
|
|
976
976
|
/**
|
|
977
|
-
|
|
978
|
-
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
979
|
-
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
980
|
-
|
|
977
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
978
|
+
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
979
|
+
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
980
|
+
*/
|
|
981
981
|
MaxFaceNum?: number;
|
|
982
982
|
/**
|
|
983
|
-
|
|
984
|
-
|
|
983
|
+
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
984
|
+
*/
|
|
985
985
|
MinFaceSize?: number;
|
|
986
986
|
/**
|
|
987
|
-
|
|
988
|
-
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
989
|
-
|
|
987
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
988
|
+
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
989
|
+
*/
|
|
990
990
|
MaxPersonNumPerGroup?: number;
|
|
991
991
|
/**
|
|
992
|
-
|
|
993
|
-
0: 不进行控制;
|
|
994
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
995
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
996
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
997
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
998
|
-
默认 0。
|
|
999
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1000
|
-
|
|
992
|
+
* 图片质量控制。
|
|
993
|
+
0: 不进行控制;
|
|
994
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
995
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
996
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
997
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
998
|
+
默认 0。
|
|
999
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1000
|
+
*/
|
|
1001
1001
|
QualityControl?: number;
|
|
1002
1002
|
/**
|
|
1003
|
-
|
|
1004
|
-
|
|
1003
|
+
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
1004
|
+
*/
|
|
1005
1005
|
FaceMatchThreshold?: number;
|
|
1006
1006
|
/**
|
|
1007
|
-
|
|
1008
|
-
|
|
1007
|
+
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1008
|
+
*/
|
|
1009
1009
|
NeedPersonInfo?: number;
|
|
1010
1010
|
/**
|
|
1011
|
-
|
|
1012
|
-
|
|
1011
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1012
|
+
*/
|
|
1013
1013
|
NeedRotateDetection?: number;
|
|
1014
1014
|
}
|
|
1015
1015
|
/**
|
|
@@ -1017,8 +1017,8 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
|
1017
1017
|
*/
|
|
1018
1018
|
export interface DeletePersonFromGroupResponse {
|
|
1019
1019
|
/**
|
|
1020
|
-
|
|
1021
|
-
|
|
1020
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1021
|
+
*/
|
|
1022
1022
|
RequestId?: string;
|
|
1023
1023
|
}
|
|
1024
1024
|
/**
|
|
@@ -1026,76 +1026,76 @@ export interface DeletePersonFromGroupResponse {
|
|
|
1026
1026
|
*/
|
|
1027
1027
|
export interface DenseFaceShape {
|
|
1028
1028
|
/**
|
|
1029
|
-
|
|
1030
|
-
|
|
1029
|
+
* 人脸框左上角横坐标。
|
|
1030
|
+
*/
|
|
1031
1031
|
X: number;
|
|
1032
1032
|
/**
|
|
1033
|
-
|
|
1034
|
-
|
|
1033
|
+
* 人脸框左上角纵坐标。
|
|
1034
|
+
*/
|
|
1035
1035
|
Y: number;
|
|
1036
1036
|
/**
|
|
1037
|
-
|
|
1038
|
-
|
|
1037
|
+
* 人脸框宽度。
|
|
1038
|
+
*/
|
|
1039
1039
|
Width: number;
|
|
1040
1040
|
/**
|
|
1041
|
-
|
|
1042
|
-
|
|
1041
|
+
* 人脸框高度。
|
|
1042
|
+
*/
|
|
1043
1043
|
Height: number;
|
|
1044
1044
|
/**
|
|
1045
|
-
|
|
1046
|
-
|
|
1045
|
+
* 描述左侧眼睛轮廓的 XX 点。
|
|
1046
|
+
*/
|
|
1047
1047
|
LeftEye: Array<Point>;
|
|
1048
1048
|
/**
|
|
1049
|
-
|
|
1050
|
-
|
|
1049
|
+
* 描述右侧眼睛轮廓的 XX 点。
|
|
1050
|
+
*/
|
|
1051
1051
|
RightEye: Array<Point>;
|
|
1052
1052
|
/**
|
|
1053
|
-
|
|
1054
|
-
|
|
1053
|
+
* 描述左侧眉毛轮廓的 XX 点。
|
|
1054
|
+
*/
|
|
1055
1055
|
LeftEyeBrow: Array<Point>;
|
|
1056
1056
|
/**
|
|
1057
|
-
|
|
1058
|
-
|
|
1057
|
+
* 描述右侧眉毛轮廓的 XX 点。
|
|
1058
|
+
*/
|
|
1059
1059
|
RightEyeBrow: Array<Point>;
|
|
1060
1060
|
/**
|
|
1061
|
-
|
|
1062
|
-
|
|
1061
|
+
* 描述外嘴巴轮廓的 XX 点, 从左侧开始逆时针返回。
|
|
1062
|
+
*/
|
|
1063
1063
|
MouthOutside: Array<Point>;
|
|
1064
1064
|
/**
|
|
1065
|
-
|
|
1066
|
-
|
|
1065
|
+
* 描述内嘴巴轮廓的 XX 点,从左侧开始逆时针返回。
|
|
1066
|
+
*/
|
|
1067
1067
|
MouthInside: Array<Point>;
|
|
1068
1068
|
/**
|
|
1069
|
-
|
|
1070
|
-
|
|
1069
|
+
* 描述鼻子轮廓的 XX 点。
|
|
1070
|
+
*/
|
|
1071
1071
|
Nose: Array<Point>;
|
|
1072
1072
|
/**
|
|
1073
|
-
|
|
1074
|
-
|
|
1073
|
+
* 左瞳孔轮廓的 XX 个点。
|
|
1074
|
+
*/
|
|
1075
1075
|
LeftPupil: Array<Point>;
|
|
1076
1076
|
/**
|
|
1077
|
-
|
|
1078
|
-
|
|
1077
|
+
* 右瞳孔轮廓的 XX 个点。
|
|
1078
|
+
*/
|
|
1079
1079
|
RightPupil: Array<Point>;
|
|
1080
1080
|
/**
|
|
1081
|
-
|
|
1082
|
-
|
|
1081
|
+
* 中轴线轮廓的 XX 个点。
|
|
1082
|
+
*/
|
|
1083
1083
|
CentralAxis: Array<Point>;
|
|
1084
1084
|
/**
|
|
1085
|
-
|
|
1086
|
-
|
|
1085
|
+
* 下巴轮廓的 XX 个点。
|
|
1086
|
+
*/
|
|
1087
1087
|
Chin: Array<Point>;
|
|
1088
1088
|
/**
|
|
1089
|
-
|
|
1090
|
-
|
|
1089
|
+
* 左眼袋的 XX 个点。
|
|
1090
|
+
*/
|
|
1091
1091
|
LeftEyeBags: Array<Point>;
|
|
1092
1092
|
/**
|
|
1093
|
-
|
|
1094
|
-
|
|
1093
|
+
* 右眼袋的 XX 个点。
|
|
1094
|
+
*/
|
|
1095
1095
|
RightEyeBags: Array<Point>;
|
|
1096
1096
|
/**
|
|
1097
|
-
|
|
1098
|
-
|
|
1097
|
+
* 额头的 XX 个点。
|
|
1098
|
+
*/
|
|
1099
1099
|
Forehead: Array<Point>;
|
|
1100
1100
|
}
|
|
1101
1101
|
/**
|
|
@@ -1104,17 +1104,17 @@ export interface DenseFaceShape {
|
|
|
1104
1104
|
*/
|
|
1105
1105
|
export interface ResultsReturnsByGroup {
|
|
1106
1106
|
/**
|
|
1107
|
-
|
|
1108
|
-
|
|
1107
|
+
* 检测出的人脸框位置。
|
|
1108
|
+
*/
|
|
1109
1109
|
FaceRect: FaceRect;
|
|
1110
1110
|
/**
|
|
1111
|
-
|
|
1112
|
-
|
|
1111
|
+
* 识别结果。
|
|
1112
|
+
*/
|
|
1113
1113
|
GroupCandidates: Array<GroupCandidate>;
|
|
1114
1114
|
/**
|
|
1115
|
-
|
|
1116
|
-
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1117
|
-
|
|
1115
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1116
|
+
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1117
|
+
*/
|
|
1118
1118
|
RetCode: number;
|
|
1119
1119
|
}
|
|
1120
1120
|
/**
|
|
@@ -1122,12 +1122,12 @@ export interface ResultsReturnsByGroup {
|
|
|
1122
1122
|
*/
|
|
1123
1123
|
export interface Point {
|
|
1124
1124
|
/**
|
|
1125
|
-
|
|
1126
|
-
|
|
1125
|
+
* x坐标
|
|
1126
|
+
*/
|
|
1127
1127
|
X: number;
|
|
1128
1128
|
/**
|
|
1129
|
-
|
|
1130
|
-
|
|
1129
|
+
* Y坐标
|
|
1130
|
+
*/
|
|
1131
1131
|
Y: number;
|
|
1132
1132
|
}
|
|
1133
1133
|
/**
|
|
@@ -1135,16 +1135,16 @@ export interface Point {
|
|
|
1135
1135
|
*/
|
|
1136
1136
|
export interface GetPersonListNumResponse {
|
|
1137
1137
|
/**
|
|
1138
|
-
|
|
1139
|
-
|
|
1138
|
+
* 人员数量
|
|
1139
|
+
*/
|
|
1140
1140
|
PersonNum?: number;
|
|
1141
1141
|
/**
|
|
1142
|
-
|
|
1143
|
-
|
|
1142
|
+
* 人脸数量
|
|
1143
|
+
*/
|
|
1144
1144
|
FaceNum?: number;
|
|
1145
1145
|
/**
|
|
1146
|
-
|
|
1147
|
-
|
|
1146
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1147
|
+
*/
|
|
1148
1148
|
RequestId?: string;
|
|
1149
1149
|
}
|
|
1150
1150
|
/**
|
|
@@ -1152,12 +1152,12 @@ export interface GetPersonListNumResponse {
|
|
|
1152
1152
|
*/
|
|
1153
1153
|
export interface DeletePersonFromGroupRequest {
|
|
1154
1154
|
/**
|
|
1155
|
-
|
|
1156
|
-
|
|
1155
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
1156
|
+
*/
|
|
1157
1157
|
PersonId: string;
|
|
1158
1158
|
/**
|
|
1159
|
-
|
|
1160
|
-
|
|
1159
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
1160
|
+
*/
|
|
1161
1161
|
GroupId: string;
|
|
1162
1162
|
}
|
|
1163
1163
|
/**
|
|
@@ -1165,40 +1165,40 @@ export interface DeletePersonFromGroupRequest {
|
|
|
1165
1165
|
*/
|
|
1166
1166
|
export interface VerifyFaceRequest {
|
|
1167
1167
|
/**
|
|
1168
|
-
|
|
1169
|
-
|
|
1168
|
+
* 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
|
1169
|
+
*/
|
|
1170
1170
|
PersonId: string;
|
|
1171
1171
|
/**
|
|
1172
|
-
|
|
1173
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1174
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1175
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1176
|
-
|
|
1172
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1173
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1174
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1175
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1176
|
+
*/
|
|
1177
1177
|
Image?: string;
|
|
1178
1178
|
/**
|
|
1179
|
-
|
|
1180
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1181
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1182
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1183
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1184
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1185
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1186
|
-
|
|
1179
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1180
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1181
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1182
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1183
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1184
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1185
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1186
|
+
*/
|
|
1187
1187
|
Url?: string;
|
|
1188
1188
|
/**
|
|
1189
|
-
|
|
1190
|
-
0: 不进行控制;
|
|
1191
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1192
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1193
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1194
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1195
|
-
默认 0。
|
|
1196
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1197
|
-
|
|
1189
|
+
* 图片质量控制。
|
|
1190
|
+
0: 不进行控制;
|
|
1191
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1192
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1193
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1194
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1195
|
+
默认 0。
|
|
1196
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1197
|
+
*/
|
|
1198
1198
|
QualityControl?: number;
|
|
1199
1199
|
/**
|
|
1200
|
-
|
|
1201
|
-
|
|
1200
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1201
|
+
*/
|
|
1202
1202
|
NeedRotateDetection?: number;
|
|
1203
1203
|
}
|
|
1204
1204
|
/**
|
|
@@ -1206,27 +1206,27 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
1206
1206
|
*/
|
|
1207
1207
|
export interface GetPersonListResponse {
|
|
1208
1208
|
/**
|
|
1209
|
-
|
|
1210
|
-
|
|
1209
|
+
* 返回的人员信息
|
|
1210
|
+
*/
|
|
1211
1211
|
PersonInfos?: Array<PersonInfo>;
|
|
1212
1212
|
/**
|
|
1213
|
-
|
|
1214
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1215
|
-
|
|
1213
|
+
* 该人员库的人员数量
|
|
1214
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1215
|
+
*/
|
|
1216
1216
|
PersonNum?: number;
|
|
1217
1217
|
/**
|
|
1218
|
-
|
|
1219
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1220
|
-
|
|
1218
|
+
* 该人员库的人脸数量
|
|
1219
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1220
|
+
*/
|
|
1221
1221
|
FaceNum?: number;
|
|
1222
1222
|
/**
|
|
1223
|
-
|
|
1224
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1225
|
-
|
|
1223
|
+
* 人脸识别所用的算法模型版本。
|
|
1224
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1225
|
+
*/
|
|
1226
1226
|
FaceModelVersion?: string;
|
|
1227
1227
|
/**
|
|
1228
|
-
|
|
1229
|
-
|
|
1228
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1229
|
+
*/
|
|
1230
1230
|
RequestId?: string;
|
|
1231
1231
|
}
|
|
1232
1232
|
/**
|
|
@@ -1234,19 +1234,19 @@ export interface GetPersonListResponse {
|
|
|
1234
1234
|
*/
|
|
1235
1235
|
export interface Hair {
|
|
1236
1236
|
/**
|
|
1237
|
-
|
|
1238
|
-
AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
|
|
1239
|
-
|
|
1237
|
+
* 头发长度信息。
|
|
1238
|
+
AttributeItem对应的Type为 —— 0:光头,1:短发,2:中发,3:长发,4:绑发。
|
|
1239
|
+
*/
|
|
1240
1240
|
Length: AttributeItem;
|
|
1241
1241
|
/**
|
|
1242
|
-
|
|
1243
|
-
AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
|
|
1244
|
-
|
|
1242
|
+
* 刘海信息。
|
|
1243
|
+
AttributeItem对应的Type为 —— 0:无刘海,1:有刘海。
|
|
1244
|
+
*/
|
|
1245
1245
|
Bang: AttributeItem;
|
|
1246
1246
|
/**
|
|
1247
|
-
|
|
1248
|
-
AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
|
|
1249
|
-
|
|
1247
|
+
* 头发颜色信息。
|
|
1248
|
+
AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:灰白色。
|
|
1249
|
+
*/
|
|
1250
1250
|
Color: AttributeItem;
|
|
1251
1251
|
}
|
|
1252
1252
|
/**
|
|
@@ -1254,17 +1254,17 @@ AttributeItem对应的Type为 —— 0:黑色,1:金色,2:棕色,3:
|
|
|
1254
1254
|
*/
|
|
1255
1255
|
export interface Result {
|
|
1256
1256
|
/**
|
|
1257
|
-
|
|
1258
|
-
|
|
1257
|
+
* 识别出的最相似候选人
|
|
1258
|
+
*/
|
|
1259
1259
|
Candidates: Array<Candidate>;
|
|
1260
1260
|
/**
|
|
1261
|
-
|
|
1262
|
-
|
|
1261
|
+
* 检测出的人脸框位置
|
|
1262
|
+
*/
|
|
1263
1263
|
FaceRect: FaceRect;
|
|
1264
1264
|
/**
|
|
1265
|
-
|
|
1266
|
-
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1267
|
-
|
|
1265
|
+
* 检测出的人脸图片状态返回码。0 表示正常。
|
|
1266
|
+
-1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
|
1267
|
+
*/
|
|
1268
1268
|
RetCode: number;
|
|
1269
1269
|
}
|
|
1270
1270
|
/**
|
|
@@ -1272,22 +1272,22 @@ export interface Result {
|
|
|
1272
1272
|
*/
|
|
1273
1273
|
export interface GetPersonGroupInfoResponse {
|
|
1274
1274
|
/**
|
|
1275
|
-
|
|
1276
|
-
|
|
1275
|
+
* 包含此人员的人员库及描述字段内容列表
|
|
1276
|
+
*/
|
|
1277
1277
|
PersonGroupInfos?: Array<PersonGroupInfo>;
|
|
1278
1278
|
/**
|
|
1279
|
-
|
|
1280
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1281
|
-
|
|
1279
|
+
* 人员库总数量
|
|
1280
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1281
|
+
*/
|
|
1282
1282
|
GroupNum?: number;
|
|
1283
1283
|
/**
|
|
1284
|
-
|
|
1285
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1286
|
-
|
|
1284
|
+
* 人脸识别服务所用的算法模型版本。
|
|
1285
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1286
|
+
*/
|
|
1287
1287
|
FaceModelVersion?: string;
|
|
1288
1288
|
/**
|
|
1289
|
-
|
|
1290
|
-
|
|
1289
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1290
|
+
*/
|
|
1291
1291
|
RequestId?: string;
|
|
1292
1292
|
}
|
|
1293
1293
|
/**
|
|
@@ -1295,12 +1295,12 @@ export interface GetPersonGroupInfoResponse {
|
|
|
1295
1295
|
*/
|
|
1296
1296
|
export interface UpgradeGroupFaceModelVersionResponse {
|
|
1297
1297
|
/**
|
|
1298
|
-
|
|
1299
|
-
|
|
1298
|
+
* 升级任务ID,用于查询、获取升级的进度和结果。
|
|
1299
|
+
*/
|
|
1300
1300
|
JobId: string;
|
|
1301
1301
|
/**
|
|
1302
|
-
|
|
1303
|
-
|
|
1302
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1303
|
+
*/
|
|
1304
1304
|
RequestId?: string;
|
|
1305
1305
|
}
|
|
1306
1306
|
/**
|
|
@@ -1308,64 +1308,64 @@ export interface UpgradeGroupFaceModelVersionResponse {
|
|
|
1308
1308
|
*/
|
|
1309
1309
|
export interface SearchFacesReturnsByGroupRequest {
|
|
1310
1310
|
/**
|
|
1311
|
-
|
|
1312
|
-
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1313
|
-
|
|
1311
|
+
* 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
|
|
1312
|
+
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1313
|
+
*/
|
|
1314
1314
|
GroupIds: Array<string>;
|
|
1315
1315
|
/**
|
|
1316
|
-
|
|
1317
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1318
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1319
|
-
|
|
1316
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1317
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1318
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1319
|
+
*/
|
|
1320
1320
|
Image?: string;
|
|
1321
1321
|
/**
|
|
1322
|
-
|
|
1323
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1324
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1325
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1326
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1327
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1328
|
-
|
|
1322
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1323
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1324
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1325
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1326
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1327
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1328
|
+
*/
|
|
1329
1329
|
Url?: string;
|
|
1330
1330
|
/**
|
|
1331
|
-
|
|
1332
|
-
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1333
|
-
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1334
|
-
|
|
1331
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1332
|
+
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1333
|
+
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1334
|
+
*/
|
|
1335
1335
|
MaxFaceNum?: number;
|
|
1336
1336
|
/**
|
|
1337
|
-
|
|
1338
|
-
|
|
1337
|
+
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1338
|
+
*/
|
|
1339
1339
|
MinFaceSize?: number;
|
|
1340
1340
|
/**
|
|
1341
|
-
|
|
1342
|
-
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
1343
|
-
|
|
1341
|
+
* 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
|
|
1342
|
+
例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
1343
|
+
*/
|
|
1344
1344
|
MaxPersonNumPerGroup?: number;
|
|
1345
1345
|
/**
|
|
1346
|
-
|
|
1347
|
-
|
|
1346
|
+
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1347
|
+
*/
|
|
1348
1348
|
NeedPersonInfo?: number;
|
|
1349
1349
|
/**
|
|
1350
|
-
|
|
1351
|
-
0: 不进行控制;
|
|
1352
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1353
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1354
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1355
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1356
|
-
默认 0。
|
|
1357
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1358
|
-
|
|
1350
|
+
* 图片质量控制。
|
|
1351
|
+
0: 不进行控制;
|
|
1352
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1353
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1354
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1355
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1356
|
+
默认 0。
|
|
1357
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1358
|
+
*/
|
|
1359
1359
|
QualityControl?: number;
|
|
1360
1360
|
/**
|
|
1361
|
-
|
|
1362
|
-
默认为0。
|
|
1363
|
-
取值范围[0.0,100.0) 。
|
|
1364
|
-
|
|
1361
|
+
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
|
1362
|
+
默认为0。
|
|
1363
|
+
取值范围[0.0,100.0) 。
|
|
1364
|
+
*/
|
|
1365
1365
|
FaceMatchThreshold?: number;
|
|
1366
1366
|
/**
|
|
1367
|
-
|
|
1368
|
-
|
|
1367
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1368
|
+
*/
|
|
1369
1369
|
NeedRotateDetection?: number;
|
|
1370
1370
|
}
|
|
1371
1371
|
/**
|
|
@@ -1373,24 +1373,24 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
|
1373
1373
|
*/
|
|
1374
1374
|
export interface AnalyzeDenseLandmarksResponse {
|
|
1375
1375
|
/**
|
|
1376
|
-
|
|
1377
|
-
|
|
1376
|
+
* 请求的图片宽度。
|
|
1377
|
+
*/
|
|
1378
1378
|
ImageWidth?: number;
|
|
1379
1379
|
/**
|
|
1380
|
-
|
|
1381
|
-
|
|
1380
|
+
* 请求的图片高度。
|
|
1381
|
+
*/
|
|
1382
1382
|
ImageHeight?: number;
|
|
1383
1383
|
/**
|
|
1384
|
-
|
|
1385
|
-
|
|
1384
|
+
* 稠密人脸关键点具体信息。
|
|
1385
|
+
*/
|
|
1386
1386
|
DenseFaceShapeSet?: Array<DenseFaceShape>;
|
|
1387
1387
|
/**
|
|
1388
|
-
|
|
1389
|
-
|
|
1388
|
+
* 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
|
1389
|
+
*/
|
|
1390
1390
|
FaceModelVersion?: string;
|
|
1391
1391
|
/**
|
|
1392
|
-
|
|
1393
|
-
|
|
1392
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1393
|
+
*/
|
|
1394
1394
|
RequestId?: string;
|
|
1395
1395
|
}
|
|
1396
1396
|
/**
|
|
@@ -1398,8 +1398,8 @@ export interface AnalyzeDenseLandmarksResponse {
|
|
|
1398
1398
|
*/
|
|
1399
1399
|
export interface ModifyPersonBaseInfoResponse {
|
|
1400
1400
|
/**
|
|
1401
|
-
|
|
1402
|
-
|
|
1401
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1402
|
+
*/
|
|
1403
1403
|
RequestId?: string;
|
|
1404
1404
|
}
|
|
1405
1405
|
/**
|
|
@@ -1407,16 +1407,16 @@ export interface ModifyPersonBaseInfoResponse {
|
|
|
1407
1407
|
*/
|
|
1408
1408
|
export interface ModifyPersonGroupInfoRequest {
|
|
1409
1409
|
/**
|
|
1410
|
-
|
|
1411
|
-
|
|
1410
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
1411
|
+
*/
|
|
1412
1412
|
GroupId: string;
|
|
1413
1413
|
/**
|
|
1414
|
-
|
|
1415
|
-
|
|
1414
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
1415
|
+
*/
|
|
1416
1416
|
PersonId: string;
|
|
1417
1417
|
/**
|
|
1418
|
-
|
|
1419
|
-
|
|
1418
|
+
* 需要修改的人员描述字段内容,key-value
|
|
1419
|
+
*/
|
|
1420
1420
|
PersonExDescriptionInfos: Array<PersonExDescriptionInfo>;
|
|
1421
1421
|
}
|
|
1422
1422
|
/**
|
|
@@ -1424,8 +1424,8 @@ export interface ModifyPersonGroupInfoRequest {
|
|
|
1424
1424
|
*/
|
|
1425
1425
|
export interface RevertGroupFaceModelVersionRequest {
|
|
1426
1426
|
/**
|
|
1427
|
-
|
|
1428
|
-
|
|
1427
|
+
* 需要回滚的升级任务ID。
|
|
1428
|
+
*/
|
|
1429
1429
|
JobId: string;
|
|
1430
1430
|
}
|
|
1431
1431
|
/**
|
|
@@ -1433,40 +1433,40 @@ export interface RevertGroupFaceModelVersionRequest {
|
|
|
1433
1433
|
*/
|
|
1434
1434
|
export interface FaceQualityCompleteness {
|
|
1435
1435
|
/**
|
|
1436
|
-
|
|
1437
|
-
参考范围:[0,80]表示发生遮挡。
|
|
1438
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1439
|
-
|
|
1436
|
+
* 眉毛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1437
|
+
参考范围:[0,80]表示发生遮挡。
|
|
1438
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1439
|
+
*/
|
|
1440
1440
|
Eyebrow: number;
|
|
1441
1441
|
/**
|
|
1442
|
-
|
|
1443
|
-
参考范围:[0,80]表示发生遮挡。
|
|
1444
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1445
|
-
|
|
1442
|
+
* 眼睛的遮挡分数[0,100],分数越高遮挡越少。
|
|
1443
|
+
参考范围:[0,80]表示发生遮挡。
|
|
1444
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1445
|
+
*/
|
|
1446
1446
|
Eye: number;
|
|
1447
1447
|
/**
|
|
1448
|
-
|
|
1449
|
-
参考范围:[0,60]表示发生遮挡。
|
|
1450
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1451
|
-
|
|
1448
|
+
* 鼻子的遮挡分数[0,100],分数越高遮挡越少。
|
|
1449
|
+
参考范围:[0,60]表示发生遮挡。
|
|
1450
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1451
|
+
*/
|
|
1452
1452
|
Nose: number;
|
|
1453
1453
|
/**
|
|
1454
|
-
|
|
1455
|
-
参考范围:[0,70]表示发生遮挡。
|
|
1456
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1457
|
-
|
|
1454
|
+
* 脸颊的遮挡分数[0,100],分数越高遮挡越少。
|
|
1455
|
+
参考范围:[0,70]表示发生遮挡。
|
|
1456
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1457
|
+
*/
|
|
1458
1458
|
Cheek: number;
|
|
1459
1459
|
/**
|
|
1460
|
-
|
|
1461
|
-
参考范围:[0,50]表示发生遮挡。
|
|
1462
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1463
|
-
|
|
1460
|
+
* 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1461
|
+
参考范围:[0,50]表示发生遮挡。
|
|
1462
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1463
|
+
*/
|
|
1464
1464
|
Mouth: number;
|
|
1465
1465
|
/**
|
|
1466
|
-
|
|
1467
|
-
参考范围:[0,70]表示发生遮挡。
|
|
1468
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1469
|
-
|
|
1466
|
+
* 下巴的遮挡分数[0,100],分数越高遮挡越少。
|
|
1467
|
+
参考范围:[0,70]表示发生遮挡。
|
|
1468
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1469
|
+
*/
|
|
1470
1470
|
Chin: number;
|
|
1471
1471
|
}
|
|
1472
1472
|
/**
|
|
@@ -1475,59 +1475,59 @@ export interface FaceQualityCompleteness {
|
|
|
1475
1475
|
*/
|
|
1476
1476
|
export interface FaceAttributesInfo {
|
|
1477
1477
|
/**
|
|
1478
|
-
|
|
1479
|
-
|
|
1478
|
+
* 性别[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1479
|
+
*/
|
|
1480
1480
|
Gender: number;
|
|
1481
1481
|
/**
|
|
1482
|
-
|
|
1483
|
-
|
|
1482
|
+
* 年龄 [0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1483
|
+
*/
|
|
1484
1484
|
Age: number;
|
|
1485
1485
|
/**
|
|
1486
|
-
|
|
1487
|
-
|
|
1486
|
+
* 微笑[0(normal,正常)~50(smile,微笑)~100(laugh,大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1487
|
+
*/
|
|
1488
1488
|
Expression: number;
|
|
1489
1489
|
/**
|
|
1490
|
-
|
|
1491
|
-
|
|
1490
|
+
* 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1491
|
+
*/
|
|
1492
1492
|
Glass: boolean;
|
|
1493
1493
|
/**
|
|
1494
|
-
|
|
1495
|
-
建议:人脸入库选择[-10,10]的图片。
|
|
1496
|
-
|
|
1494
|
+
* 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1495
|
+
建议:人脸入库选择[-10,10]的图片。
|
|
1496
|
+
*/
|
|
1497
1497
|
Pitch: number;
|
|
1498
1498
|
/**
|
|
1499
|
-
|
|
1500
|
-
建议:人脸入库选择[-10,10]的图片。
|
|
1501
|
-
|
|
1499
|
+
* 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1500
|
+
建议:人脸入库选择[-10,10]的图片。
|
|
1501
|
+
*/
|
|
1502
1502
|
Yaw: number;
|
|
1503
1503
|
/**
|
|
1504
|
-
|
|
1505
|
-
建议:人脸入库选择[-20,20]的图片。
|
|
1506
|
-
|
|
1504
|
+
* 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1505
|
+
建议:人脸入库选择[-20,20]的图片。
|
|
1506
|
+
*/
|
|
1507
1507
|
Roll: number;
|
|
1508
1508
|
/**
|
|
1509
|
-
|
|
1510
|
-
|
|
1509
|
+
* 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1510
|
+
*/
|
|
1511
1511
|
Beauty: number;
|
|
1512
1512
|
/**
|
|
1513
|
-
|
|
1514
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1515
|
-
|
|
1513
|
+
* 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1514
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1515
|
+
*/
|
|
1516
1516
|
Hat: boolean;
|
|
1517
1517
|
/**
|
|
1518
|
-
|
|
1519
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1520
|
-
|
|
1518
|
+
* 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1519
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1520
|
+
*/
|
|
1521
1521
|
Mask: boolean;
|
|
1522
1522
|
/**
|
|
1523
|
-
|
|
1524
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1525
|
-
|
|
1523
|
+
* 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1524
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1525
|
+
*/
|
|
1526
1526
|
Hair: FaceHairAttributesInfo;
|
|
1527
1527
|
/**
|
|
1528
|
-
|
|
1529
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1530
|
-
|
|
1528
|
+
* 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
1529
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1530
|
+
*/
|
|
1531
1531
|
EyeOpen: boolean;
|
|
1532
1532
|
}
|
|
1533
1533
|
/**
|
|
@@ -1535,40 +1535,40 @@ export interface FaceAttributesInfo {
|
|
|
1535
1535
|
*/
|
|
1536
1536
|
export interface VerifyPersonRequest {
|
|
1537
1537
|
/**
|
|
1538
|
-
|
|
1539
|
-
|
|
1538
|
+
* 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
|
1539
|
+
*/
|
|
1540
1540
|
PersonId: string;
|
|
1541
1541
|
/**
|
|
1542
|
-
|
|
1543
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1544
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1545
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1546
|
-
|
|
1542
|
+
* 图片 base64 数据。
|
|
1543
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1544
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1545
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1546
|
+
*/
|
|
1547
1547
|
Image?: string;
|
|
1548
1548
|
/**
|
|
1549
|
-
|
|
1550
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
|
|
1551
|
-
|
|
1552
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1553
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1554
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1555
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1556
|
-
|
|
1549
|
+
* 图片的 Url
|
|
1550
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
|
|
1551
|
+
图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1552
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1553
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1554
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1555
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1556
|
+
*/
|
|
1557
1557
|
Url?: string;
|
|
1558
1558
|
/**
|
|
1559
|
-
|
|
1560
|
-
0: 不进行控制;
|
|
1561
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1562
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1563
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1564
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1565
|
-
默认 0。
|
|
1566
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1567
|
-
|
|
1559
|
+
* 图片质量控制。
|
|
1560
|
+
0: 不进行控制;
|
|
1561
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1562
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1563
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1564
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1565
|
+
默认 0。
|
|
1566
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1567
|
+
*/
|
|
1568
1568
|
QualityControl?: number;
|
|
1569
1569
|
/**
|
|
1570
|
-
|
|
1571
|
-
|
|
1570
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1571
|
+
*/
|
|
1572
1572
|
NeedRotateDetection?: number;
|
|
1573
1573
|
}
|
|
1574
1574
|
/**
|
|
@@ -1576,20 +1576,20 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
|
1576
1576
|
*/
|
|
1577
1577
|
export interface CompareMaskFaceResponse {
|
|
1578
1578
|
/**
|
|
1579
|
-
|
|
1580
|
-
不同算法版本返回的相似度分数不同。
|
|
1581
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1582
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1583
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
1584
|
-
|
|
1579
|
+
* 两张图片中人脸的相似度分数。
|
|
1580
|
+
不同算法版本返回的相似度分数不同。
|
|
1581
|
+
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1582
|
+
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1583
|
+
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
1584
|
+
*/
|
|
1585
1585
|
Score: number;
|
|
1586
1586
|
/**
|
|
1587
|
-
|
|
1588
|
-
|
|
1587
|
+
* 人脸识别所用的算法模型版本。
|
|
1588
|
+
*/
|
|
1589
1589
|
FaceModelVersion: string;
|
|
1590
1590
|
/**
|
|
1591
|
-
|
|
1592
|
-
|
|
1591
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1592
|
+
*/
|
|
1593
1593
|
RequestId?: string;
|
|
1594
1594
|
}
|
|
1595
1595
|
/**
|
|
@@ -1597,16 +1597,16 @@ export interface CompareMaskFaceResponse {
|
|
|
1597
1597
|
*/
|
|
1598
1598
|
export interface ModifyPersonBaseInfoRequest {
|
|
1599
1599
|
/**
|
|
1600
|
-
|
|
1601
|
-
|
|
1600
|
+
* 人员ID,取值为创建人员接口中的PersonId
|
|
1601
|
+
*/
|
|
1602
1602
|
PersonId: string;
|
|
1603
1603
|
/**
|
|
1604
|
-
|
|
1605
|
-
|
|
1604
|
+
* 需要修改的人员名称
|
|
1605
|
+
*/
|
|
1606
1606
|
PersonName?: string;
|
|
1607
1607
|
/**
|
|
1608
|
-
|
|
1609
|
-
|
|
1608
|
+
* 需要修改的人员性别,1代表男性,2代表女性
|
|
1609
|
+
*/
|
|
1610
1610
|
Gender?: number;
|
|
1611
1611
|
}
|
|
1612
1612
|
/**
|
|
@@ -1614,26 +1614,26 @@ export interface ModifyPersonBaseInfoRequest {
|
|
|
1614
1614
|
*/
|
|
1615
1615
|
export interface DetectLiveFaceAccurateRequest {
|
|
1616
1616
|
/**
|
|
1617
|
-
|
|
1618
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1619
|
-
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1620
|
-
人脸尺寸大于100X100像素。
|
|
1621
|
-
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1622
|
-
|
|
1617
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1618
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1619
|
+
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1620
|
+
人脸尺寸大于100X100像素。
|
|
1621
|
+
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1622
|
+
*/
|
|
1623
1623
|
Image?: string;
|
|
1624
1624
|
/**
|
|
1625
|
-
|
|
1626
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1627
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1628
|
-
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1629
|
-
人脸尺寸大于100X100像素。
|
|
1630
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1631
|
-
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1632
|
-
|
|
1625
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1626
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1627
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1628
|
+
图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
|
1629
|
+
人脸尺寸大于100X100像素。
|
|
1630
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1631
|
+
图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1632
|
+
*/
|
|
1633
1633
|
Url?: string;
|
|
1634
1634
|
/**
|
|
1635
|
-
|
|
1636
|
-
|
|
1635
|
+
* 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
|
|
1636
|
+
*/
|
|
1637
1637
|
FaceModelVersion?: string;
|
|
1638
1638
|
}
|
|
1639
1639
|
/**
|
|
@@ -1641,24 +1641,24 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
1641
1641
|
*/
|
|
1642
1642
|
export interface VerifyFaceResponse {
|
|
1643
1643
|
/**
|
|
1644
|
-
|
|
1645
|
-
|
|
1646
|
-
不同算法版本返回的相似度分数不同。
|
|
1647
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1648
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1649
|
-
|
|
1644
|
+
* 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
|
1645
|
+
|
|
1646
|
+
不同算法版本返回的相似度分数不同。
|
|
1647
|
+
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
1648
|
+
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
1649
|
+
*/
|
|
1650
1650
|
Score: number;
|
|
1651
1651
|
/**
|
|
1652
|
-
|
|
1653
|
-
|
|
1652
|
+
* 是否为同一人的判断。
|
|
1653
|
+
*/
|
|
1654
1654
|
IsMatch: boolean;
|
|
1655
1655
|
/**
|
|
1656
|
-
|
|
1657
|
-
|
|
1656
|
+
* 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
|
1657
|
+
*/
|
|
1658
1658
|
FaceModelVersion: string;
|
|
1659
1659
|
/**
|
|
1660
|
-
|
|
1661
|
-
|
|
1660
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1661
|
+
*/
|
|
1662
1662
|
RequestId?: string;
|
|
1663
1663
|
}
|
|
1664
1664
|
/**
|
|
@@ -1666,16 +1666,16 @@ export interface VerifyFaceResponse {
|
|
|
1666
1666
|
*/
|
|
1667
1667
|
export interface FaceDetailInfo {
|
|
1668
1668
|
/**
|
|
1669
|
-
|
|
1670
|
-
|
|
1669
|
+
* 检测出的人脸框位置。
|
|
1670
|
+
*/
|
|
1671
1671
|
FaceRect: FaceRect;
|
|
1672
1672
|
/**
|
|
1673
|
-
|
|
1674
|
-
情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
|
|
1675
|
-
头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
|
|
1676
|
-
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1677
|
-
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1678
|
-
|
|
1673
|
+
* 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
|
|
1674
|
+
情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
|
|
1675
|
+
头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouse)、胡子(Moustache)
|
|
1676
|
+
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
|
1677
|
+
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
|
1678
|
+
*/
|
|
1679
1679
|
FaceDetailAttributesInfo: FaceDetailAttributesInfo;
|
|
1680
1680
|
}
|
|
1681
1681
|
/**
|
|
@@ -1683,63 +1683,63 @@ export interface FaceDetailInfo {
|
|
|
1683
1683
|
*/
|
|
1684
1684
|
export interface SearchFacesRequest {
|
|
1685
1685
|
/**
|
|
1686
|
-
|
|
1687
|
-
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1688
|
-
|
|
1686
|
+
* 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
|
|
1687
|
+
不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
1688
|
+
*/
|
|
1689
1689
|
GroupIds: Array<string>;
|
|
1690
1690
|
/**
|
|
1691
|
-
|
|
1692
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1693
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1694
|
-
|
|
1691
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1692
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1693
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1694
|
+
*/
|
|
1695
1695
|
Image?: string;
|
|
1696
1696
|
/**
|
|
1697
|
-
|
|
1698
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1699
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1700
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1701
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1702
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1703
|
-
|
|
1697
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1698
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1699
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1700
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1701
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1702
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1703
|
+
*/
|
|
1704
1704
|
Url?: string;
|
|
1705
1705
|
/**
|
|
1706
|
-
|
|
1707
|
-
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1708
|
-
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1709
|
-
|
|
1706
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1707
|
+
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1708
|
+
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1709
|
+
*/
|
|
1710
1710
|
MaxFaceNum?: number;
|
|
1711
1711
|
/**
|
|
1712
|
-
|
|
1713
|
-
|
|
1712
|
+
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
|
|
1713
|
+
*/
|
|
1714
1714
|
MinFaceSize?: number;
|
|
1715
1715
|
/**
|
|
1716
|
-
|
|
1717
|
-
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1718
|
-
值越大,需要处理的时间越长。建议不要超过10。
|
|
1719
|
-
|
|
1716
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1717
|
+
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1718
|
+
值越大,需要处理的时间越长。建议不要超过10。
|
|
1719
|
+
*/
|
|
1720
1720
|
MaxPersonNum?: number;
|
|
1721
1721
|
/**
|
|
1722
|
-
|
|
1723
|
-
|
|
1722
|
+
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1723
|
+
*/
|
|
1724
1724
|
NeedPersonInfo?: number;
|
|
1725
1725
|
/**
|
|
1726
|
-
|
|
1727
|
-
0: 不进行控制;
|
|
1728
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1729
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1730
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1731
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1732
|
-
默认 0。
|
|
1733
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1734
|
-
|
|
1726
|
+
* 图片质量控制。
|
|
1727
|
+
0: 不进行控制;
|
|
1728
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1729
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1730
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1731
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1732
|
+
默认 0。
|
|
1733
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1734
|
+
*/
|
|
1735
1735
|
QualityControl?: number;
|
|
1736
1736
|
/**
|
|
1737
|
-
|
|
1738
|
-
|
|
1737
|
+
* 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
1738
|
+
*/
|
|
1739
1739
|
FaceMatchThreshold?: number;
|
|
1740
1740
|
/**
|
|
1741
|
-
|
|
1742
|
-
|
|
1741
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1742
|
+
*/
|
|
1743
1743
|
NeedRotateDetection?: number;
|
|
1744
1744
|
}
|
|
1745
1745
|
/**
|
|
@@ -1747,63 +1747,63 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
|
1747
1747
|
*/
|
|
1748
1748
|
export interface SearchPersonsRequest {
|
|
1749
1749
|
/**
|
|
1750
|
-
|
|
1751
|
-
|
|
1750
|
+
* 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId
|
|
1751
|
+
*/
|
|
1752
1752
|
GroupIds: Array<string>;
|
|
1753
1753
|
/**
|
|
1754
|
-
|
|
1755
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1756
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1757
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1758
|
-
|
|
1754
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1755
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1756
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1757
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1758
|
+
*/
|
|
1759
1759
|
Image?: string;
|
|
1760
1760
|
/**
|
|
1761
|
-
|
|
1762
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1763
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1764
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1765
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1766
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1767
|
-
|
|
1761
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1762
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1763
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1764
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1765
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1766
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1767
|
+
*/
|
|
1768
1768
|
Url?: string;
|
|
1769
1769
|
/**
|
|
1770
|
-
|
|
1771
|
-
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1772
|
-
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1773
|
-
|
|
1770
|
+
* 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
1771
|
+
MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
1772
|
+
例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
1773
|
+
*/
|
|
1774
1774
|
MaxFaceNum?: number;
|
|
1775
1775
|
/**
|
|
1776
|
-
|
|
1777
|
-
|
|
1776
|
+
* 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
|
|
1777
|
+
*/
|
|
1778
1778
|
MinFaceSize?: number;
|
|
1779
1779
|
/**
|
|
1780
|
-
|
|
1781
|
-
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1782
|
-
值越大,需要处理的时间越长。建议不要超过10。
|
|
1783
|
-
|
|
1780
|
+
* 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
|
|
1781
|
+
例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
1782
|
+
值越大,需要处理的时间越长。建议不要超过10。
|
|
1783
|
+
*/
|
|
1784
1784
|
MaxPersonNum?: number;
|
|
1785
1785
|
/**
|
|
1786
|
-
|
|
1787
|
-
0: 不进行控制;
|
|
1788
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1789
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1790
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1791
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1792
|
-
默认 0。
|
|
1793
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1794
|
-
|
|
1786
|
+
* 图片质量控制。
|
|
1787
|
+
0: 不进行控制;
|
|
1788
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1789
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1790
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1791
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1792
|
+
默认 0。
|
|
1793
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1794
|
+
*/
|
|
1795
1795
|
QualityControl?: number;
|
|
1796
1796
|
/**
|
|
1797
|
-
|
|
1798
|
-
|
|
1797
|
+
* 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
|
|
1798
|
+
*/
|
|
1799
1799
|
FaceMatchThreshold?: number;
|
|
1800
1800
|
/**
|
|
1801
|
-
|
|
1802
|
-
|
|
1801
|
+
* 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
|
|
1802
|
+
*/
|
|
1803
1803
|
NeedPersonInfo?: number;
|
|
1804
1804
|
/**
|
|
1805
|
-
|
|
1806
|
-
|
|
1805
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1806
|
+
*/
|
|
1807
1807
|
NeedRotateDetection?: number;
|
|
1808
1808
|
}
|
|
1809
1809
|
/**
|
|
@@ -1811,29 +1811,29 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
|
1811
1811
|
*/
|
|
1812
1812
|
export interface PersonInfo {
|
|
1813
1813
|
/**
|
|
1814
|
-
|
|
1815
|
-
|
|
1814
|
+
* 人员名称
|
|
1815
|
+
*/
|
|
1816
1816
|
PersonName: string;
|
|
1817
1817
|
/**
|
|
1818
|
-
|
|
1819
|
-
|
|
1818
|
+
* 人员Id
|
|
1819
|
+
*/
|
|
1820
1820
|
PersonId: string;
|
|
1821
1821
|
/**
|
|
1822
|
-
|
|
1823
|
-
|
|
1822
|
+
* 人员性别
|
|
1823
|
+
*/
|
|
1824
1824
|
Gender: number;
|
|
1825
1825
|
/**
|
|
1826
|
-
|
|
1827
|
-
|
|
1826
|
+
* 人员描述字段内容
|
|
1827
|
+
*/
|
|
1828
1828
|
PersonExDescriptions: Array<string>;
|
|
1829
1829
|
/**
|
|
1830
|
-
|
|
1831
|
-
|
|
1830
|
+
* 包含的人脸照片列表
|
|
1831
|
+
*/
|
|
1832
1832
|
FaceIds: Array<string>;
|
|
1833
1833
|
/**
|
|
1834
|
-
|
|
1835
|
-
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
1836
|
-
|
|
1834
|
+
* 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
|
1835
|
+
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
|
|
1836
|
+
*/
|
|
1837
1837
|
CreationTimestamp: number;
|
|
1838
1838
|
}
|
|
1839
1839
|
/**
|
|
@@ -1841,13 +1841,13 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
|
1841
1841
|
*/
|
|
1842
1842
|
export interface GroupExDescriptionInfo {
|
|
1843
1843
|
/**
|
|
1844
|
-
|
|
1845
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
1846
|
-
|
|
1844
|
+
* 人员库自定义描述字段Index,从0开始
|
|
1845
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
1846
|
+
*/
|
|
1847
1847
|
GroupExDescriptionIndex: number;
|
|
1848
1848
|
/**
|
|
1849
|
-
|
|
1850
|
-
|
|
1849
|
+
* 需要更新的人员库自定义描述字段内容
|
|
1850
|
+
*/
|
|
1851
1851
|
GroupExDescription: string;
|
|
1852
1852
|
}
|
|
1853
1853
|
/**
|
|
@@ -1855,53 +1855,53 @@ export interface GroupExDescriptionInfo {
|
|
|
1855
1855
|
*/
|
|
1856
1856
|
export interface CompareMaskFaceRequest {
|
|
1857
1857
|
/**
|
|
1858
|
-
|
|
1859
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1860
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1861
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1862
|
-
|
|
1858
|
+
* A 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1859
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1860
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1861
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1862
|
+
*/
|
|
1863
1863
|
ImageA?: string;
|
|
1864
1864
|
/**
|
|
1865
|
-
|
|
1866
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1867
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1868
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1869
|
-
|
|
1865
|
+
* B 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1866
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1867
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1868
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1869
|
+
*/
|
|
1870
1870
|
ImageB?: string;
|
|
1871
1871
|
/**
|
|
1872
|
-
|
|
1873
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1874
|
-
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1875
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1876
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1877
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1878
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1879
|
-
|
|
1872
|
+
* A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
1873
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1874
|
+
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1875
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1876
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1877
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1878
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1879
|
+
*/
|
|
1880
1880
|
UrlA?: string;
|
|
1881
1881
|
/**
|
|
1882
|
-
|
|
1883
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1884
|
-
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1885
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1886
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1887
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1888
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1889
|
-
|
|
1882
|
+
* B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
1883
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1884
|
+
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1885
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1886
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1887
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
1888
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1889
|
+
*/
|
|
1890
1890
|
UrlB?: string;
|
|
1891
1891
|
/**
|
|
1892
|
-
|
|
1893
|
-
|
|
1892
|
+
* 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
|
|
1893
|
+
*/
|
|
1894
1894
|
FaceModelVersion?: string;
|
|
1895
1895
|
/**
|
|
1896
|
-
|
|
1897
|
-
0: 不进行控制;
|
|
1898
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1899
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1900
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1901
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1902
|
-
默认 0。
|
|
1903
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1904
|
-
|
|
1896
|
+
* 图片质量控制。
|
|
1897
|
+
0: 不进行控制;
|
|
1898
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
1899
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
1900
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
1901
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
1902
|
+
默认 0。
|
|
1903
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
1904
|
+
*/
|
|
1905
1905
|
QualityControl?: number;
|
|
1906
1906
|
}
|
|
1907
1907
|
/**
|
|
@@ -1909,24 +1909,24 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
1909
1909
|
*/
|
|
1910
1910
|
export interface AnalyzeFaceResponse {
|
|
1911
1911
|
/**
|
|
1912
|
-
|
|
1913
|
-
|
|
1912
|
+
* 请求的图片宽度。
|
|
1913
|
+
*/
|
|
1914
1914
|
ImageWidth: number;
|
|
1915
1915
|
/**
|
|
1916
|
-
|
|
1917
|
-
|
|
1916
|
+
* 请求的图片高度。
|
|
1917
|
+
*/
|
|
1918
1918
|
ImageHeight: number;
|
|
1919
1919
|
/**
|
|
1920
|
-
|
|
1921
|
-
|
|
1920
|
+
* 五官定位(人脸关键点)具体信息。
|
|
1921
|
+
*/
|
|
1922
1922
|
FaceShapeSet: Array<FaceShape>;
|
|
1923
1923
|
/**
|
|
1924
|
-
|
|
1925
|
-
|
|
1924
|
+
* 人脸识别所用的算法模型版本。
|
|
1925
|
+
*/
|
|
1926
1926
|
FaceModelVersion: string;
|
|
1927
1927
|
/**
|
|
1928
|
-
|
|
1929
|
-
|
|
1928
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
1929
|
+
*/
|
|
1930
1930
|
RequestId?: string;
|
|
1931
1931
|
}
|
|
1932
1932
|
/**
|
|
@@ -1934,60 +1934,60 @@ export interface AnalyzeFaceResponse {
|
|
|
1934
1934
|
*/
|
|
1935
1935
|
export interface DetectFaceRequest {
|
|
1936
1936
|
/**
|
|
1937
|
-
|
|
1938
|
-
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1939
|
-
|
|
1937
|
+
* 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
1938
|
+
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
1939
|
+
*/
|
|
1940
1940
|
MaxFaceNum?: number;
|
|
1941
1941
|
/**
|
|
1942
|
-
|
|
1943
|
-
默认为34。建议不低于34。
|
|
1944
|
-
低于MinFaceSize值的人脸不会被检测。
|
|
1945
|
-
|
|
1942
|
+
* 人脸长和宽的最小尺寸,单位为像素。
|
|
1943
|
+
默认为34。建议不低于34。
|
|
1944
|
+
低于MinFaceSize值的人脸不会被检测。
|
|
1945
|
+
*/
|
|
1946
1946
|
MinFaceSize?: number;
|
|
1947
1947
|
/**
|
|
1948
|
-
|
|
1949
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1950
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1951
|
-
|
|
1948
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
1949
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1950
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1951
|
+
*/
|
|
1952
1952
|
Image?: string;
|
|
1953
1953
|
/**
|
|
1954
|
-
|
|
1955
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1956
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1957
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1958
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1959
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1960
|
-
|
|
1954
|
+
* 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
|
|
1955
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
1956
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1957
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
1958
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
1959
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
1960
|
+
*/
|
|
1961
1961
|
Url?: string;
|
|
1962
1962
|
/**
|
|
1963
|
-
|
|
1964
|
-
非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
|
1965
|
-
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
|
1966
|
-
提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
|
1967
|
-
|
|
1963
|
+
* 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
|
|
1964
|
+
非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
|
1965
|
+
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
|
1966
|
+
提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
|
1967
|
+
*/
|
|
1968
1968
|
NeedFaceAttributes?: number;
|
|
1969
1969
|
/**
|
|
1970
|
-
|
|
1971
|
-
非 1 值均视为不进行质量检测。
|
|
1972
|
-
最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
|
1973
|
-
建议:人脸入库操作建议开启此功能。
|
|
1974
|
-
|
|
1970
|
+
* 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
|
|
1971
|
+
非 1 值均视为不进行质量检测。
|
|
1972
|
+
最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
|
1973
|
+
建议:人脸入库操作建议开启此功能。
|
|
1974
|
+
*/
|
|
1975
1975
|
NeedQualityDetection?: number;
|
|
1976
1976
|
/**
|
|
1977
|
-
|
|
1978
|
-
|
|
1979
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
1980
|
-
|
|
1981
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
1982
|
-
|
|
1983
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
1984
|
-
|
|
1985
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
1986
|
-
|
|
1977
|
+
* 人脸识别服务所用的算法模型版本。
|
|
1978
|
+
|
|
1979
|
+
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
1980
|
+
|
|
1981
|
+
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
1982
|
+
|
|
1983
|
+
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
1984
|
+
|
|
1985
|
+
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
1986
|
+
*/
|
|
1987
1987
|
FaceModelVersion?: string;
|
|
1988
1988
|
/**
|
|
1989
|
-
|
|
1990
|
-
|
|
1989
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
1990
|
+
*/
|
|
1991
1991
|
NeedRotateDetection?: number;
|
|
1992
1992
|
}
|
|
1993
1993
|
/**
|
|
@@ -1995,8 +1995,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
1995
1995
|
*/
|
|
1996
1996
|
export interface GetPersonBaseInfoRequest {
|
|
1997
1997
|
/**
|
|
1998
|
-
|
|
1999
|
-
|
|
1998
|
+
* 人员ID,创建人员接口中的PersonId
|
|
1999
|
+
*/
|
|
2000
2000
|
PersonId: string;
|
|
2001
2001
|
}
|
|
2002
2002
|
/**
|
|
@@ -2004,8 +2004,8 @@ export interface GetPersonBaseInfoRequest {
|
|
|
2004
2004
|
*/
|
|
2005
2005
|
export interface DeletePersonResponse {
|
|
2006
2006
|
/**
|
|
2007
|
-
|
|
2008
|
-
|
|
2007
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2008
|
+
*/
|
|
2009
2009
|
RequestId?: string;
|
|
2010
2010
|
}
|
|
2011
2011
|
/**
|
|
@@ -2013,13 +2013,13 @@ export interface DeletePersonResponse {
|
|
|
2013
2013
|
*/
|
|
2014
2014
|
export interface PersonExDescriptionInfo {
|
|
2015
2015
|
/**
|
|
2016
|
-
|
|
2017
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
2018
|
-
|
|
2016
|
+
* 人员描述字段Index,从0开始
|
|
2017
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
2018
|
+
*/
|
|
2019
2019
|
PersonExDescriptionIndex: number;
|
|
2020
2020
|
/**
|
|
2021
|
-
|
|
2022
|
-
|
|
2021
|
+
* 需要更新的人员描述字段内容
|
|
2022
|
+
*/
|
|
2023
2023
|
PersonExDescription: string;
|
|
2024
2024
|
}
|
|
2025
2025
|
/**
|
|
@@ -2027,16 +2027,16 @@ export interface PersonExDescriptionInfo {
|
|
|
2027
2027
|
*/
|
|
2028
2028
|
export interface GetUpgradeGroupFaceModelVersionJobListResponse {
|
|
2029
2029
|
/**
|
|
2030
|
-
|
|
2031
|
-
|
|
2030
|
+
* 人员库升级任务信息列表。
|
|
2031
|
+
*/
|
|
2032
2032
|
JobInfos?: Array<UpgradeJobInfo>;
|
|
2033
2033
|
/**
|
|
2034
|
-
|
|
2035
|
-
|
|
2034
|
+
* 升级任务总数量。
|
|
2035
|
+
*/
|
|
2036
2036
|
JobNum?: number;
|
|
2037
2037
|
/**
|
|
2038
|
-
|
|
2039
|
-
|
|
2038
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2039
|
+
*/
|
|
2040
2040
|
RequestId?: string;
|
|
2041
2041
|
}
|
|
2042
2042
|
/**
|
|
@@ -2044,16 +2044,16 @@ export interface GetUpgradeGroupFaceModelVersionJobListResponse {
|
|
|
2044
2044
|
*/
|
|
2045
2045
|
export interface HeadPose {
|
|
2046
2046
|
/**
|
|
2047
|
-
|
|
2048
|
-
|
|
2047
|
+
* 上下偏移[-30,30]。
|
|
2048
|
+
*/
|
|
2049
2049
|
Pitch: number;
|
|
2050
2050
|
/**
|
|
2051
|
-
|
|
2052
|
-
|
|
2051
|
+
* 左右偏移[-30,30]。
|
|
2052
|
+
*/
|
|
2053
2053
|
Yaw: number;
|
|
2054
2054
|
/**
|
|
2055
|
-
|
|
2056
|
-
|
|
2055
|
+
* 平面旋转[-180,180]。
|
|
2056
|
+
*/
|
|
2057
2057
|
Roll: number;
|
|
2058
2058
|
}
|
|
2059
2059
|
/**
|
|
@@ -2061,17 +2061,17 @@ export interface HeadPose {
|
|
|
2061
2061
|
*/
|
|
2062
2062
|
export interface GetGroupListResponse {
|
|
2063
2063
|
/**
|
|
2064
|
-
|
|
2065
|
-
|
|
2064
|
+
* 返回的人员库信息
|
|
2065
|
+
*/
|
|
2066
2066
|
GroupInfos: Array<GroupInfo>;
|
|
2067
2067
|
/**
|
|
2068
|
-
|
|
2069
|
-
注意:此字段可能返回 null,表示取不到有效值。
|
|
2070
|
-
|
|
2068
|
+
* 人员库总数量
|
|
2069
|
+
注意:此字段可能返回 null,表示取不到有效值。
|
|
2070
|
+
*/
|
|
2071
2071
|
GroupNum: number;
|
|
2072
2072
|
/**
|
|
2073
|
-
|
|
2074
|
-
|
|
2073
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2074
|
+
*/
|
|
2075
2075
|
RequestId?: string;
|
|
2076
2076
|
}
|
|
2077
2077
|
/**
|
|
@@ -2079,44 +2079,44 @@ export interface GetGroupListResponse {
|
|
|
2079
2079
|
*/
|
|
2080
2080
|
export interface DetectFaceAttributesRequest {
|
|
2081
2081
|
/**
|
|
2082
|
-
|
|
2083
|
-
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2084
|
-
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
2085
|
-
|
|
2082
|
+
* 最多处理的人脸数目。
|
|
2083
|
+
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
|
2084
|
+
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
|
2085
|
+
*/
|
|
2086
2086
|
MaxFaceNum?: number;
|
|
2087
2087
|
/**
|
|
2088
|
-
|
|
2089
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2090
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2091
|
-
|
|
2088
|
+
* 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2089
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2090
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2091
|
+
*/
|
|
2092
2092
|
Image?: string;
|
|
2093
2093
|
/**
|
|
2094
|
-
|
|
2095
|
-
对应图片 base64 编码后大小不可超过5M。
|
|
2096
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2097
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2098
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2099
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2100
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2101
|
-
|
|
2094
|
+
* 图片的 Url 。
|
|
2095
|
+
对应图片 base64 编码后大小不可超过5M。
|
|
2096
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2097
|
+
Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2098
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2099
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2100
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2101
|
+
*/
|
|
2102
2102
|
Url?: string;
|
|
2103
2103
|
/**
|
|
2104
|
-
|
|
2105
|
-
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
|
2106
|
-
Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
|
2107
|
-
None为不需要返回。默认为 None。
|
|
2108
|
-
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
2109
|
-
关于各属性的详细描述,参见下文出参。
|
|
2110
|
-
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
2111
|
-
|
|
2104
|
+
* 是否返回年龄、性别、情绪等属性。
|
|
2105
|
+
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
|
2106
|
+
Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
|
2107
|
+
None为不需要返回。默认为 None。
|
|
2108
|
+
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
|
2109
|
+
关于各属性的详细描述,参见下文出参。
|
|
2110
|
+
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
|
2111
|
+
*/
|
|
2112
2112
|
FaceAttributesType?: string;
|
|
2113
2113
|
/**
|
|
2114
|
-
|
|
2115
|
-
|
|
2114
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
2115
|
+
*/
|
|
2116
2116
|
NeedRotateDetection?: number;
|
|
2117
2117
|
/**
|
|
2118
|
-
|
|
2119
|
-
|
|
2118
|
+
* 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
|
|
2119
|
+
*/
|
|
2120
2120
|
FaceModelVersion?: string;
|
|
2121
2121
|
}
|
|
2122
2122
|
/**
|
|
@@ -2124,32 +2124,32 @@ None为不需要返回。默认为 None。
|
|
|
2124
2124
|
*/
|
|
2125
2125
|
export interface GetGroupInfoResponse {
|
|
2126
2126
|
/**
|
|
2127
|
-
|
|
2128
|
-
|
|
2127
|
+
* 人员库名称
|
|
2128
|
+
*/
|
|
2129
2129
|
GroupName?: string;
|
|
2130
2130
|
/**
|
|
2131
|
-
|
|
2132
|
-
|
|
2131
|
+
* 人员库ID
|
|
2132
|
+
*/
|
|
2133
2133
|
GroupId?: string;
|
|
2134
2134
|
/**
|
|
2135
|
-
|
|
2136
|
-
|
|
2135
|
+
* 人员库自定义描述字段
|
|
2136
|
+
*/
|
|
2137
2137
|
GroupExDescriptions?: Array<string>;
|
|
2138
2138
|
/**
|
|
2139
|
-
|
|
2140
|
-
|
|
2139
|
+
* 人员库信息备注
|
|
2140
|
+
*/
|
|
2141
2141
|
Tag?: string;
|
|
2142
2142
|
/**
|
|
2143
|
-
|
|
2144
|
-
|
|
2143
|
+
* 人脸识别所用的算法模型版本。
|
|
2144
|
+
*/
|
|
2145
2145
|
FaceModelVersion?: string;
|
|
2146
2146
|
/**
|
|
2147
|
-
|
|
2148
|
-
|
|
2147
|
+
* Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
2148
|
+
*/
|
|
2149
2149
|
CreationTimestamp?: number;
|
|
2150
2150
|
/**
|
|
2151
|
-
|
|
2152
|
-
|
|
2151
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2152
|
+
*/
|
|
2153
2153
|
RequestId?: string;
|
|
2154
2154
|
}
|
|
2155
2155
|
/**
|
|
@@ -2157,20 +2157,20 @@ export interface GetGroupInfoResponse {
|
|
|
2157
2157
|
*/
|
|
2158
2158
|
export interface CompareFaceResponse {
|
|
2159
2159
|
/**
|
|
2160
|
-
|
|
2161
|
-
不同算法版本返回的相似度分数不同。
|
|
2162
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
2163
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
2164
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
2165
|
-
|
|
2160
|
+
* 两张图片中人脸的相似度分数。
|
|
2161
|
+
不同算法版本返回的相似度分数不同。
|
|
2162
|
+
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
2163
|
+
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
2164
|
+
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
2165
|
+
*/
|
|
2166
2166
|
Score: number;
|
|
2167
2167
|
/**
|
|
2168
|
-
|
|
2169
|
-
|
|
2168
|
+
* 人脸识别所用的算法模型版本。
|
|
2169
|
+
*/
|
|
2170
2170
|
FaceModelVersion: string;
|
|
2171
2171
|
/**
|
|
2172
|
-
|
|
2173
|
-
|
|
2172
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2173
|
+
*/
|
|
2174
2174
|
RequestId?: string;
|
|
2175
2175
|
}
|
|
2176
2176
|
/**
|
|
@@ -2178,9 +2178,9 @@ export interface CompareFaceResponse {
|
|
|
2178
2178
|
*/
|
|
2179
2179
|
export interface Mouth {
|
|
2180
2180
|
/**
|
|
2181
|
-
|
|
2182
|
-
AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
|
|
2183
|
-
|
|
2181
|
+
* 是否张嘴信息。
|
|
2182
|
+
AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
|
|
2183
|
+
*/
|
|
2184
2184
|
MouthOpen: AttributeItem;
|
|
2185
2185
|
}
|
|
2186
2186
|
/**
|
|
@@ -2188,8 +2188,8 @@ AttributeItem对应的Type为 —— 0:不张嘴,1:张嘴。
|
|
|
2188
2188
|
*/
|
|
2189
2189
|
export interface RevertGroupFaceModelVersionResponse {
|
|
2190
2190
|
/**
|
|
2191
|
-
|
|
2192
|
-
|
|
2191
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2192
|
+
*/
|
|
2193
2193
|
RequestId?: string;
|
|
2194
2194
|
}
|
|
2195
2195
|
/**
|
|
@@ -2197,8 +2197,8 @@ export interface RevertGroupFaceModelVersionResponse {
|
|
|
2197
2197
|
*/
|
|
2198
2198
|
export interface DeleteGroupResponse {
|
|
2199
2199
|
/**
|
|
2200
|
-
|
|
2201
|
-
|
|
2200
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2201
|
+
*/
|
|
2202
2202
|
RequestId?: string;
|
|
2203
2203
|
}
|
|
2204
2204
|
/**
|
|
@@ -2206,40 +2206,40 @@ export interface DeleteGroupResponse {
|
|
|
2206
2206
|
*/
|
|
2207
2207
|
export interface FaceShape {
|
|
2208
2208
|
/**
|
|
2209
|
-
|
|
2210
|
-
|
|
2209
|
+
* 描述脸型轮廓的 21 点。
|
|
2210
|
+
*/
|
|
2211
2211
|
FaceProfile: Array<Point>;
|
|
2212
2212
|
/**
|
|
2213
|
-
|
|
2214
|
-
|
|
2213
|
+
* 描述左侧眼睛轮廓的 8 点。
|
|
2214
|
+
*/
|
|
2215
2215
|
LeftEye: Array<Point>;
|
|
2216
2216
|
/**
|
|
2217
|
-
|
|
2218
|
-
|
|
2217
|
+
* 描述右侧眼睛轮廓的 8 点。
|
|
2218
|
+
*/
|
|
2219
2219
|
RightEye: Array<Point>;
|
|
2220
2220
|
/**
|
|
2221
|
-
|
|
2222
|
-
|
|
2221
|
+
* 描述左侧眉毛轮廓的 8 点。
|
|
2222
|
+
*/
|
|
2223
2223
|
LeftEyeBrow: Array<Point>;
|
|
2224
2224
|
/**
|
|
2225
|
-
|
|
2226
|
-
|
|
2225
|
+
* 描述右侧眉毛轮廓的 8 点。
|
|
2226
|
+
*/
|
|
2227
2227
|
RightEyeBrow: Array<Point>;
|
|
2228
2228
|
/**
|
|
2229
|
-
|
|
2230
|
-
|
|
2229
|
+
* 描述嘴巴轮廓的 22 点。
|
|
2230
|
+
*/
|
|
2231
2231
|
Mouth: Array<Point>;
|
|
2232
2232
|
/**
|
|
2233
|
-
|
|
2234
|
-
|
|
2233
|
+
* 描述鼻子轮廓的 13 点。
|
|
2234
|
+
*/
|
|
2235
2235
|
Nose: Array<Point>;
|
|
2236
2236
|
/**
|
|
2237
|
-
|
|
2238
|
-
|
|
2237
|
+
* 左瞳孔轮廓的 1 个点。
|
|
2238
|
+
*/
|
|
2239
2239
|
LeftPupil: Array<Point>;
|
|
2240
2240
|
/**
|
|
2241
|
-
|
|
2242
|
-
|
|
2241
|
+
* 右瞳孔轮廓的 1 个点。
|
|
2242
|
+
*/
|
|
2243
2243
|
RightPupil: Array<Point>;
|
|
2244
2244
|
}
|
|
2245
2245
|
/**
|
|
@@ -2247,65 +2247,65 @@ export interface FaceShape {
|
|
|
2247
2247
|
*/
|
|
2248
2248
|
export interface CompareFaceRequest {
|
|
2249
2249
|
/**
|
|
2250
|
-
|
|
2251
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2252
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2253
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2254
|
-
|
|
2250
|
+
* A 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2251
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2252
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2253
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2254
|
+
*/
|
|
2255
2255
|
ImageA?: string;
|
|
2256
2256
|
/**
|
|
2257
|
-
|
|
2258
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2259
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2260
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2261
|
-
|
|
2257
|
+
* B 图片 base64 数据,base64 编码后大小不可超过5M。
|
|
2258
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2259
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2260
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2261
|
+
*/
|
|
2262
2262
|
ImageB?: string;
|
|
2263
2263
|
/**
|
|
2264
|
-
|
|
2265
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2266
|
-
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2267
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2268
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2269
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2270
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2271
|
-
|
|
2264
|
+
* A 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2265
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2266
|
+
A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2267
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2268
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2269
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2270
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2271
|
+
*/
|
|
2272
2272
|
UrlA?: string;
|
|
2273
2273
|
/**
|
|
2274
|
-
|
|
2275
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2276
|
-
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2277
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2278
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2279
|
-
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2280
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2281
|
-
|
|
2274
|
+
* B 图片的 Url ,对应图片 base64 编码后大小不可超过5M。
|
|
2275
|
+
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
2276
|
+
B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2277
|
+
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
2278
|
+
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
2279
|
+
若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
2280
|
+
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
2281
|
+
*/
|
|
2282
2282
|
UrlB?: string;
|
|
2283
2283
|
/**
|
|
2284
|
-
|
|
2285
|
-
|
|
2286
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2287
|
-
|
|
2288
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
2289
|
-
|
|
2290
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2291
|
-
|
|
2292
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2293
|
-
|
|
2284
|
+
* 人脸识别服务所用的算法模型版本。
|
|
2285
|
+
|
|
2286
|
+
目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
2287
|
+
|
|
2288
|
+
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
2289
|
+
|
|
2290
|
+
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
2291
|
+
|
|
2292
|
+
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
2293
|
+
*/
|
|
2294
2294
|
FaceModelVersion?: string;
|
|
2295
2295
|
/**
|
|
2296
|
-
|
|
2297
|
-
0: 不进行控制;
|
|
2298
|
-
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
2299
|
-
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
2300
|
-
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
2301
|
-
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
2302
|
-
默认 0。
|
|
2303
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
2304
|
-
|
|
2296
|
+
* 图片质量控制。
|
|
2297
|
+
0: 不进行控制;
|
|
2298
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
2299
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
2300
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
2301
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
2302
|
+
默认 0。
|
|
2303
|
+
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
2304
|
+
*/
|
|
2305
2305
|
QualityControl?: number;
|
|
2306
2306
|
/**
|
|
2307
|
-
|
|
2308
|
-
|
|
2307
|
+
* 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
2308
|
+
*/
|
|
2309
2309
|
NeedRotateDetection?: number;
|
|
2310
2310
|
}
|
|
2311
2311
|
/**
|
|
@@ -2313,20 +2313,20 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
|
2313
2313
|
*/
|
|
2314
2314
|
export interface VerifyPersonResponse {
|
|
2315
2315
|
/**
|
|
2316
|
-
|
|
2317
|
-
|
|
2316
|
+
* 给定的人脸照片与 PersonId 对应的相似度。若 PersonId 下有多张人脸(Face),会融合多张人脸信息进行验证。
|
|
2317
|
+
*/
|
|
2318
2318
|
Score?: number;
|
|
2319
2319
|
/**
|
|
2320
|
-
|
|
2321
|
-
|
|
2320
|
+
* 是否为同一人的判断。
|
|
2321
|
+
*/
|
|
2322
2322
|
IsMatch?: boolean;
|
|
2323
2323
|
/**
|
|
2324
|
-
|
|
2325
|
-
|
|
2324
|
+
* 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
|
2325
|
+
*/
|
|
2326
2326
|
FaceModelVersion?: string;
|
|
2327
2327
|
/**
|
|
2328
|
-
|
|
2329
|
-
|
|
2328
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2329
|
+
*/
|
|
2330
2330
|
RequestId?: string;
|
|
2331
2331
|
}
|
|
2332
2332
|
/**
|
|
@@ -2334,24 +2334,24 @@ export interface VerifyPersonResponse {
|
|
|
2334
2334
|
*/
|
|
2335
2335
|
export interface DetectFaceResponse {
|
|
2336
2336
|
/**
|
|
2337
|
-
|
|
2338
|
-
|
|
2337
|
+
* 请求的图片宽度。
|
|
2338
|
+
*/
|
|
2339
2339
|
ImageWidth: number;
|
|
2340
2340
|
/**
|
|
2341
|
-
|
|
2342
|
-
|
|
2341
|
+
* 请求的图片高度。
|
|
2342
|
+
*/
|
|
2343
2343
|
ImageHeight: number;
|
|
2344
2344
|
/**
|
|
2345
|
-
|
|
2346
|
-
|
|
2345
|
+
* 人脸信息列表。包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
|
|
2346
|
+
*/
|
|
2347
2347
|
FaceInfos: Array<FaceInfo>;
|
|
2348
2348
|
/**
|
|
2349
|
-
|
|
2350
|
-
|
|
2349
|
+
* 人脸识别所用的算法模型版本。
|
|
2350
|
+
*/
|
|
2351
2351
|
FaceModelVersion: string;
|
|
2352
2352
|
/**
|
|
2353
|
-
|
|
2354
|
-
|
|
2353
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2354
|
+
*/
|
|
2355
2355
|
RequestId?: string;
|
|
2356
2356
|
}
|
|
2357
2357
|
/**
|
|
@@ -2359,8 +2359,8 @@ export interface DetectFaceResponse {
|
|
|
2359
2359
|
*/
|
|
2360
2360
|
export interface GetPersonListNumRequest {
|
|
2361
2361
|
/**
|
|
2362
|
-
|
|
2363
|
-
|
|
2362
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
2363
|
+
*/
|
|
2364
2364
|
GroupId: string;
|
|
2365
2365
|
}
|
|
2366
2366
|
/**
|
|
@@ -2368,8 +2368,8 @@ export interface GetPersonListNumRequest {
|
|
|
2368
2368
|
*/
|
|
2369
2369
|
export interface GetGroupInfoRequest {
|
|
2370
2370
|
/**
|
|
2371
|
-
|
|
2372
|
-
|
|
2371
|
+
* 人员库 ID,取值为创建人员库接口中的GroupId
|
|
2372
|
+
*/
|
|
2373
2373
|
GroupId: string;
|
|
2374
2374
|
}
|
|
2375
2375
|
/**
|
|
@@ -2377,31 +2377,31 @@ export interface GetGroupInfoRequest {
|
|
|
2377
2377
|
*/
|
|
2378
2378
|
export interface UpgradeJobInfo {
|
|
2379
2379
|
/**
|
|
2380
|
-
|
|
2381
|
-
|
|
2380
|
+
* 人员库升级任务ID,用于查询、获取升级的进度和结果。
|
|
2381
|
+
*/
|
|
2382
2382
|
JobId: string;
|
|
2383
2383
|
/**
|
|
2384
|
-
|
|
2385
|
-
|
|
2384
|
+
* 人员库ID。
|
|
2385
|
+
*/
|
|
2386
2386
|
GroupId: string;
|
|
2387
2387
|
/**
|
|
2388
|
-
|
|
2389
|
-
|
|
2388
|
+
* 当前算法模型版本。
|
|
2389
|
+
*/
|
|
2390
2390
|
FromFaceModelVersion: string;
|
|
2391
2391
|
/**
|
|
2392
|
-
|
|
2393
|
-
|
|
2392
|
+
* 目标算法模型版本。
|
|
2393
|
+
*/
|
|
2394
2394
|
ToFaceModelVersion: string;
|
|
2395
2395
|
/**
|
|
2396
|
-
|
|
2397
|
-
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
2398
|
-
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
2399
|
-
有关更多信息,请参阅 Unix 时间。
|
|
2400
|
-
|
|
2396
|
+
* 升级起始时间。
|
|
2397
|
+
StartTime的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
|
2398
|
+
Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
|
2399
|
+
有关更多信息,请参阅 Unix 时间。
|
|
2400
|
+
*/
|
|
2401
2401
|
StartTime: number;
|
|
2402
2402
|
/**
|
|
2403
|
-
|
|
2404
|
-
|
|
2403
|
+
* 0表示升级中,1表示升级完毕,2表示回滚完毕,3表示升级失败。
|
|
2404
|
+
*/
|
|
2405
2405
|
Status: number;
|
|
2406
2406
|
}
|
|
2407
2407
|
/**
|
|
@@ -2409,8 +2409,8 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
|
2409
2409
|
*/
|
|
2410
2410
|
export interface ModifyGroupResponse {
|
|
2411
2411
|
/**
|
|
2412
|
-
|
|
2413
|
-
|
|
2412
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2413
|
+
*/
|
|
2414
2414
|
RequestId?: string;
|
|
2415
2415
|
}
|
|
2416
2416
|
/**
|
|
@@ -2418,16 +2418,16 @@ export interface ModifyGroupResponse {
|
|
|
2418
2418
|
*/
|
|
2419
2419
|
export interface GetPersonListRequest {
|
|
2420
2420
|
/**
|
|
2421
|
-
|
|
2422
|
-
|
|
2421
|
+
* 人员库ID,取值为创建人员库接口中的GroupId
|
|
2422
|
+
*/
|
|
2423
2423
|
GroupId: string;
|
|
2424
2424
|
/**
|
|
2425
|
-
|
|
2426
|
-
|
|
2425
|
+
* 起始序号,默认值为0
|
|
2426
|
+
*/
|
|
2427
2427
|
Offset?: number;
|
|
2428
2428
|
/**
|
|
2429
|
-
|
|
2430
|
-
|
|
2429
|
+
* 返回数量,默认值为10,最大值为1000
|
|
2430
|
+
*/
|
|
2431
2431
|
Limit?: number;
|
|
2432
2432
|
}
|
|
2433
2433
|
/**
|
|
@@ -2439,91 +2439,91 @@ export interface GetPersonListRequest {
|
|
|
2439
2439
|
*/
|
|
2440
2440
|
export interface FaceDetailAttributesInfo {
|
|
2441
2441
|
/**
|
|
2442
|
-
|
|
2443
|
-
FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2444
|
-
|
|
2442
|
+
* 年龄 [0,65],其中65代表“65岁及以上”。
|
|
2443
|
+
FaceAttributesType 不为含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2444
|
+
*/
|
|
2445
2445
|
Age: number;
|
|
2446
2446
|
/**
|
|
2447
|
-
|
|
2448
|
-
FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2449
|
-
|
|
2447
|
+
* 美丑打分[0,100]。
|
|
2448
|
+
FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2449
|
+
*/
|
|
2450
2450
|
Beauty: number;
|
|
2451
2451
|
/**
|
|
2452
|
-
|
|
2453
|
-
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
|
|
2454
|
-
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2455
|
-
|
|
2452
|
+
* 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
|
2453
|
+
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
|
|
2454
|
+
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2455
|
+
*/
|
|
2456
2456
|
Emotion: AttributeItem;
|
|
2457
2457
|
/**
|
|
2458
|
-
|
|
2459
|
-
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2460
|
-
|
|
2458
|
+
* 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
|
2459
|
+
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2460
|
+
*/
|
|
2461
2461
|
Eye: Eye;
|
|
2462
2462
|
/**
|
|
2463
|
-
|
|
2464
|
-
FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2465
|
-
|
|
2463
|
+
* 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
|
|
2464
|
+
FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2465
|
+
*/
|
|
2466
2466
|
Eyebrow: Eyebrow;
|
|
2467
2467
|
/**
|
|
2468
|
-
|
|
2469
|
-
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2470
|
-
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2471
|
-
|
|
2468
|
+
* 性别信息。
|
|
2469
|
+
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
|
2470
|
+
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2471
|
+
*/
|
|
2472
2472
|
Gender: AttributeItem;
|
|
2473
2473
|
/**
|
|
2474
|
-
|
|
2475
|
-
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2476
|
-
|
|
2474
|
+
* 头发信息,包含头发长度、有无刘海、头发颜色。
|
|
2475
|
+
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2476
|
+
*/
|
|
2477
2477
|
Hair: Hair;
|
|
2478
2478
|
/**
|
|
2479
|
-
|
|
2480
|
-
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2481
|
-
|
|
2479
|
+
* 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
|
2480
|
+
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2481
|
+
*/
|
|
2482
2482
|
Hat: Hat;
|
|
2483
2483
|
/**
|
|
2484
|
-
|
|
2485
|
-
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2486
|
-
|
|
2484
|
+
* 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
|
2485
|
+
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2486
|
+
*/
|
|
2487
2487
|
HeadPose: HeadPose;
|
|
2488
2488
|
/**
|
|
2489
|
-
|
|
2490
|
-
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2491
|
-
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2492
|
-
|
|
2489
|
+
* 口罩佩戴信息。
|
|
2490
|
+
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
|
2491
|
+
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2492
|
+
*/
|
|
2493
2493
|
Mask: AttributeItem;
|
|
2494
2494
|
/**
|
|
2495
|
-
|
|
2496
|
-
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2497
|
-
|
|
2495
|
+
* 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
|
2496
|
+
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2497
|
+
*/
|
|
2498
2498
|
Mouth: Mouth;
|
|
2499
2499
|
/**
|
|
2500
|
-
|
|
2501
|
-
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2502
|
-
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2503
|
-
|
|
2500
|
+
* 胡子信息。
|
|
2501
|
+
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
|
2502
|
+
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2503
|
+
*/
|
|
2504
2504
|
Moustache: AttributeItem;
|
|
2505
2505
|
/**
|
|
2506
|
-
|
|
2507
|
-
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2508
|
-
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2509
|
-
|
|
2506
|
+
* 鼻子信息。
|
|
2507
|
+
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
|
2508
|
+
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2509
|
+
*/
|
|
2510
2510
|
Nose: AttributeItem;
|
|
2511
2511
|
/**
|
|
2512
|
-
|
|
2513
|
-
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2514
|
-
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2515
|
-
|
|
2512
|
+
* 脸型信息。
|
|
2513
|
+
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
|
2514
|
+
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2515
|
+
*/
|
|
2516
2516
|
Shape: AttributeItem;
|
|
2517
2517
|
/**
|
|
2518
|
-
|
|
2519
|
-
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2520
|
-
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2521
|
-
|
|
2518
|
+
* 肤色信息。
|
|
2519
|
+
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
|
2520
|
+
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2521
|
+
*/
|
|
2522
2522
|
Skin: AttributeItem;
|
|
2523
2523
|
/**
|
|
2524
|
-
|
|
2525
|
-
FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2526
|
-
|
|
2524
|
+
* 微笑程度,[0,100]。
|
|
2525
|
+
FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
|
2526
|
+
*/
|
|
2527
2527
|
Smile: number;
|
|
2528
2528
|
}
|
|
2529
2529
|
/**
|
|
@@ -2531,12 +2531,12 @@ FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返
|
|
|
2531
2531
|
*/
|
|
2532
2532
|
export interface AttributeItem {
|
|
2533
2533
|
/**
|
|
2534
|
-
|
|
2535
|
-
|
|
2534
|
+
* 属性值
|
|
2535
|
+
*/
|
|
2536
2536
|
Type: number;
|
|
2537
2537
|
/**
|
|
2538
|
-
|
|
2539
|
-
|
|
2538
|
+
* Type识别概率值,【0,1】,代表判断正确的概率。
|
|
2539
|
+
*/
|
|
2540
2540
|
Probability: number;
|
|
2541
2541
|
}
|
|
2542
2542
|
/**
|
|
@@ -2544,24 +2544,24 @@ export interface AttributeItem {
|
|
|
2544
2544
|
*/
|
|
2545
2545
|
export interface FaceRect {
|
|
2546
2546
|
/**
|
|
2547
|
-
|
|
2548
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2549
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2550
|
-
|
|
2547
|
+
* 人脸框左上角横坐标。
|
|
2548
|
+
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2549
|
+
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2550
|
+
*/
|
|
2551
2551
|
X: number;
|
|
2552
2552
|
/**
|
|
2553
|
-
|
|
2554
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2555
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2556
|
-
|
|
2553
|
+
* 人脸框左上角纵坐标。
|
|
2554
|
+
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
|
2555
|
+
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
|
2556
|
+
*/
|
|
2557
2557
|
Y: number;
|
|
2558
2558
|
/**
|
|
2559
|
-
|
|
2560
|
-
|
|
2559
|
+
* 人脸宽度
|
|
2560
|
+
*/
|
|
2561
2561
|
Width: number;
|
|
2562
2562
|
/**
|
|
2563
|
-
|
|
2564
|
-
|
|
2563
|
+
* 人脸高度
|
|
2564
|
+
*/
|
|
2565
2565
|
Height: number;
|
|
2566
2566
|
}
|
|
2567
2567
|
/**
|
|
@@ -2569,8 +2569,8 @@ export interface FaceRect {
|
|
|
2569
2569
|
*/
|
|
2570
2570
|
export interface ModifyPersonGroupInfoResponse {
|
|
2571
2571
|
/**
|
|
2572
|
-
|
|
2573
|
-
|
|
2572
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2573
|
+
*/
|
|
2574
2574
|
RequestId?: string;
|
|
2575
2575
|
}
|
|
2576
2576
|
/**
|
|
@@ -2578,11 +2578,11 @@ export interface ModifyPersonGroupInfoResponse {
|
|
|
2578
2578
|
*/
|
|
2579
2579
|
export interface CreateGroupResponse {
|
|
2580
2580
|
/**
|
|
2581
|
-
|
|
2582
|
-
|
|
2581
|
+
* 人脸识别所用的算法模型版本。
|
|
2582
|
+
*/
|
|
2583
2583
|
FaceModelVersion: string;
|
|
2584
2584
|
/**
|
|
2585
|
-
|
|
2586
|
-
|
|
2585
|
+
* 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
|
|
2586
|
+
*/
|
|
2587
2587
|
RequestId?: string;
|
|
2588
2588
|
}
|