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