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