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