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