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