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