tencentcloud-sdk-nodejs-iai 4.0.388 → 4.0.431
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6462 -0
- package/README.md +3 -3
- package/SERVICE_CHANGELOG.md +4451 -124
- package/package.json +1 -1
- package/products.md +104 -100
- package/src/services/iai/index.ts +9 -6
- package/src/services/iai/v20180301/iai_client.ts +278 -373
- package/src/services/iai/v20180301/iai_models.ts +1628 -1533
- package/src/services/iai/v20180301/index.ts +3 -3
- package/src/services/iai/v20200303/iai_client.ts +293 -394
- package/src/services/iai/v20200303/iai_models.ts +1685 -1586
- package/src/services/iai/v20200303/index.ts +3 -3
- package/tencentcloud/services/iai/index.d.ts +4 -4
- package/tencentcloud/services/iai/index.js +2 -2
- package/tencentcloud/services/iai/v20180301/iai_client.d.ts +186 -186
- package/tencentcloud/services/iai/v20180301/iai_client.js +186 -186
- package/tencentcloud/services/iai/v20180301/iai_models.d.ts +1174 -1174
- package/tencentcloud/services/iai/v20180301/index.js +1 -1
- package/tencentcloud/services/iai/v20200303/iai_client.d.ts +189 -189
- package/tencentcloud/services/iai/v20200303/iai_client.js +189 -189
- package/tencentcloud/services/iai/v20200303/iai_models.d.ts +1270 -1270
- package/tencentcloud/services/iai/v20200303/index.js +1 -1
|
@@ -17,104 +17,105 @@
|
|
|
17
17
|
*/
|
|
18
18
|
import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common"
|
|
19
19
|
import {
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
20
|
+
Eye,
|
|
21
|
+
Candidate,
|
|
22
|
+
DetectFaceAttributesResponse,
|
|
23
|
+
SearchPersonsReturnsByGroupResponse,
|
|
24
|
+
PersonGroupInfo,
|
|
25
|
+
Hat,
|
|
26
|
+
CreatePersonRequest,
|
|
27
|
+
CreateFaceResponse,
|
|
28
|
+
FaceHairAttributesInfo,
|
|
29
|
+
CreateFaceRequest,
|
|
30
|
+
CreateGroupRequest,
|
|
31
|
+
GetPersonGroupInfoRequest,
|
|
32
|
+
FaceInfo,
|
|
33
|
+
Eyebrow,
|
|
34
|
+
AnalyzeDenseLandmarksRequest,
|
|
35
|
+
GetGroupListRequest,
|
|
36
|
+
GetUpgradeGroupFaceModelVersionJobListRequest,
|
|
37
|
+
GetUpgradeGroupFaceModelVersionResultResponse,
|
|
38
|
+
DetectLiveFaceAccurateResponse,
|
|
39
|
+
AnalyzeFaceRequest,
|
|
40
|
+
CreatePersonResponse,
|
|
41
|
+
SearchFacesResponse,
|
|
42
|
+
CopyPersonResponse,
|
|
43
|
+
GroupCandidate,
|
|
44
|
+
DeleteFaceResponse,
|
|
45
|
+
DeletePersonRequest,
|
|
46
|
+
DetectLiveFaceResponse,
|
|
47
|
+
DeleteFaceRequest,
|
|
48
|
+
ModifyGroupRequest,
|
|
49
|
+
DeleteGroupRequest,
|
|
50
|
+
UpgradeGroupFaceModelVersionRequest,
|
|
51
|
+
DetectLiveFaceRequest,
|
|
52
|
+
GetPersonBaseInfoResponse,
|
|
53
|
+
SearchPersonsResponse,
|
|
54
|
+
GetUpgradeGroupFaceModelVersionResultRequest,
|
|
55
|
+
GroupInfo,
|
|
56
|
+
FaceQualityInfo,
|
|
57
|
+
SearchFacesReturnsByGroupResponse,
|
|
58
|
+
CopyPersonRequest,
|
|
59
|
+
SearchPersonsReturnsByGroupRequest,
|
|
60
|
+
DeletePersonFromGroupResponse,
|
|
61
|
+
DenseFaceShape,
|
|
62
|
+
ResultsReturnsByGroup,
|
|
63
|
+
Point,
|
|
64
|
+
GetPersonListNumResponse,
|
|
65
|
+
DeletePersonFromGroupRequest,
|
|
66
|
+
VerifyFaceRequest,
|
|
67
|
+
GetPersonListResponse,
|
|
68
|
+
Hair,
|
|
69
|
+
Result,
|
|
70
|
+
GetPersonGroupInfoResponse,
|
|
71
|
+
UpgradeGroupFaceModelVersionResponse,
|
|
72
|
+
SearchFacesReturnsByGroupRequest,
|
|
73
|
+
AnalyzeDenseLandmarksResponse,
|
|
74
|
+
ModifyPersonBaseInfoResponse,
|
|
75
|
+
ModifyPersonGroupInfoRequest,
|
|
76
|
+
RevertGroupFaceModelVersionRequest,
|
|
77
|
+
FaceQualityCompleteness,
|
|
78
|
+
FaceAttributesInfo,
|
|
79
|
+
VerifyPersonRequest,
|
|
80
|
+
CompareMaskFaceResponse,
|
|
81
|
+
ModifyPersonBaseInfoRequest,
|
|
82
|
+
DetectLiveFaceAccurateRequest,
|
|
83
|
+
VerifyFaceResponse,
|
|
84
|
+
FaceDetailInfo,
|
|
85
|
+
SearchFacesRequest,
|
|
86
|
+
SearchPersonsRequest,
|
|
87
|
+
PersonInfo,
|
|
88
|
+
GroupExDescriptionInfo,
|
|
89
|
+
CompareMaskFaceRequest,
|
|
90
|
+
AnalyzeFaceResponse,
|
|
91
|
+
DetectFaceRequest,
|
|
92
|
+
GetPersonBaseInfoRequest,
|
|
93
|
+
DeletePersonResponse,
|
|
94
|
+
PersonExDescriptionInfo,
|
|
95
|
+
GetUpgradeGroupFaceModelVersionJobListResponse,
|
|
96
|
+
HeadPose,
|
|
97
|
+
GetGroupListResponse,
|
|
98
|
+
DetectFaceAttributesRequest,
|
|
99
|
+
GetGroupInfoResponse,
|
|
100
|
+
CompareFaceResponse,
|
|
101
|
+
Mouth,
|
|
102
|
+
RevertGroupFaceModelVersionResponse,
|
|
103
|
+
DeleteGroupResponse,
|
|
104
|
+
FaceShape,
|
|
105
|
+
CompareFaceRequest,
|
|
106
|
+
VerifyPersonResponse,
|
|
107
|
+
DetectFaceResponse,
|
|
108
|
+
GetPersonListNumRequest,
|
|
109
|
+
GetGroupInfoRequest,
|
|
110
|
+
UpgradeJobInfo,
|
|
111
|
+
ModifyGroupResponse,
|
|
112
|
+
GetPersonListRequest,
|
|
113
|
+
FaceDetailAttributesInfo,
|
|
114
|
+
AttributeItem,
|
|
115
|
+
FaceRect,
|
|
116
|
+
ModifyPersonGroupInfoResponse,
|
|
117
|
+
CreateGroupResponse,
|
|
118
|
+
|
|
118
119
|
} from "./iai_models"
|
|
119
120
|
|
|
120
121
|
/**
|
|
@@ -122,21 +123,19 @@ import {
|
|
|
122
123
|
* @class
|
|
123
124
|
*/
|
|
124
125
|
export class Client extends TencentCloudCommon.AbstractClient {
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
req: DeletePersonFromGroupRequest,
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
/**
|
|
126
|
+
|
|
127
|
+
constructor(clientConfig: TencentCloudCommon.ClientConfig) {
|
|
128
|
+
super("iai.tencentcloudapi.com", "2020-03-03", clientConfig);
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* 从某人员库中删除人员,此操作仅影响该人员库。若该人员仅存在于指定的人员库中,该人员将被删除,其所有的人脸信息也将被删除。
|
|
133
|
+
*/
|
|
134
|
+
async DeletePersonFromGroup(req: DeletePersonFromGroupRequest, cb?: (error: string, rep: DeletePersonFromGroupResponse) => void): Promise<DeletePersonFromGroupResponse> {
|
|
135
|
+
return this.request("DeletePersonFromGroup", req, cb);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/**
|
|
140
139
|
* 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
|
|
141
140
|
|
|
142
141
|
支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
|
|
@@ -154,14 +153,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
154
153
|
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
155
154
|
|
|
156
155
|
*/
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
): Promise<SearchFacesReturnsByGroupResponse> {
|
|
161
|
-
return this.request("SearchFacesReturnsByGroup", req, cb)
|
|
162
|
-
}
|
|
156
|
+
async SearchFacesReturnsByGroup(req: SearchFacesReturnsByGroupRequest, cb?: (error: string, rep: SearchFacesReturnsByGroupResponse) => void): Promise<SearchFacesReturnsByGroupResponse> {
|
|
157
|
+
return this.request("SearchFacesReturnsByGroup", req, cb);
|
|
158
|
+
}
|
|
163
159
|
|
|
164
|
-
|
|
160
|
+
/**
|
|
165
161
|
* 用于创建一个空的人员库,如果人员库已存在返回错误。
|
|
166
162
|
可根据需要创建自定义描述字段,用于辅助描述该人员库下的人员信息。
|
|
167
163
|
|
|
@@ -169,24 +165,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
169
165
|
|
|
170
166
|
不同算法模型版本(FaceModelVersion)的人员库(Group)最多可包含人脸(Face)数不同。算法模型版本为2.0的人员库最多包含100万张人脸,算法模型版本为3.0的人员库最多可包含300万张人脸。
|
|
171
167
|
*/
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
cb?: (error: string, rep: GetPersonBaseInfoResponse) => void
|
|
185
|
-
): Promise<GetPersonBaseInfoResponse> {
|
|
186
|
-
return this.request("GetPersonBaseInfo", req, cb)
|
|
187
|
-
}
|
|
188
|
-
|
|
189
|
-
/**
|
|
168
|
+
async CreateGroup(req: CreateGroupRequest, cb?: (error: string, rep: CreateGroupResponse) => void): Promise<CreateGroupResponse> {
|
|
169
|
+
return this.request("CreateGroup", req, cb);
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* 获取指定人员的信息,包括姓名、性别、人脸等。
|
|
174
|
+
*/
|
|
175
|
+
async GetPersonBaseInfo(req: GetPersonBaseInfoRequest, cb?: (error: string, rep: GetPersonBaseInfoResponse) => void): Promise<GetPersonBaseInfoResponse> {
|
|
176
|
+
return this.request("GetPersonBaseInfo", req, cb);
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/**
|
|
190
180
|
* 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是:静态活体检测中,用户不需要通过唇语或摇头眨眼等动作来识别。
|
|
191
181
|
|
|
192
182
|
静态活体检测适用于手机自拍的场景,或对防攻击要求不高的场景。如果对活体检测有更高安全性要求,请使用[人脸核身·云智慧眼](https://cloud.tencent.com/product/faceid)产品。
|
|
@@ -200,81 +190,60 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
200
190
|
>
|
|
201
191
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
202
192
|
*/
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
): Promise<DetectLiveFaceResponse> {
|
|
207
|
-
return this.request("DetectLiveFace", req, cb)
|
|
208
|
-
}
|
|
193
|
+
async DetectLiveFace(req: DetectLiveFaceRequest, cb?: (error: string, rep: DetectLiveFaceResponse) => void): Promise<DetectLiveFaceResponse> {
|
|
194
|
+
return this.request("DetectLiveFace", req, cb);
|
|
195
|
+
}
|
|
209
196
|
|
|
210
|
-
|
|
197
|
+
/**
|
|
211
198
|
* 将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中,所有人员库中该人员图片均会增加。
|
|
212
199
|
|
|
213
200
|
>
|
|
214
201
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
215
202
|
*/
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
): Promise<CreateFaceResponse> {
|
|
220
|
-
return this.request("CreateFace", req, cb)
|
|
221
|
-
}
|
|
203
|
+
async CreateFace(req: CreateFaceRequest, cb?: (error: string, rep: CreateFaceResponse) => void): Promise<CreateFaceResponse> {
|
|
204
|
+
return this.request("CreateFace", req, cb);
|
|
205
|
+
}
|
|
222
206
|
|
|
223
|
-
|
|
207
|
+
/**
|
|
224
208
|
* 删除该人员库及包含的所有的人员。同时,人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中,该人员不会被删除,但属于该人员库中的自定义描述字段信息会被删除,属于其他人员库的自定义描述字段信息不受影响。
|
|
225
209
|
|
|
226
210
|
*/
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
*/
|
|
247
|
-
async GetPersonGroupInfo(
|
|
248
|
-
req: GetPersonGroupInfoRequest,
|
|
249
|
-
cb?: (error: string, rep: GetPersonGroupInfoResponse) => void
|
|
250
|
-
): Promise<GetPersonGroupInfoResponse> {
|
|
251
|
-
return this.request("GetPersonGroupInfo", req, cb)
|
|
252
|
-
}
|
|
253
|
-
|
|
254
|
-
/**
|
|
211
|
+
async DeleteGroup(req: DeleteGroupRequest, cb?: (error: string, rep: DeleteGroupResponse) => void): Promise<DeleteGroupResponse> {
|
|
212
|
+
return this.request("DeleteGroup", req, cb);
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* 获取指定人员库中人员数量。
|
|
217
|
+
*/
|
|
218
|
+
async GetPersonListNum(req: GetPersonListNumRequest, cb?: (error: string, rep: GetPersonListNumResponse) => void): Promise<GetPersonListNumResponse> {
|
|
219
|
+
return this.request("GetPersonListNum", req, cb);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* 获取指定人员的信息,包括加入的人员库、描述内容等。
|
|
224
|
+
*/
|
|
225
|
+
async GetPersonGroupInfo(req: GetPersonGroupInfoRequest, cb?: (error: string, rep: GetPersonGroupInfoResponse) => void): Promise<GetPersonGroupInfoResponse> {
|
|
226
|
+
return this.request("GetPersonGroupInfo", req, cb);
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/**
|
|
255
230
|
* 对请求图片进行五官定位(也称人脸关键点定位),计算构成人脸轮廓的 90 个点,包括眉毛(左右各 8 点)、眼睛(左右各 8 点)、鼻子(13 点)、嘴巴(22 点)、脸型轮廓(21 点)、眼珠[或瞳孔](2点)。
|
|
256
231
|
|
|
257
232
|
>
|
|
258
233
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
259
234
|
*/
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
cb?: (error: string, rep: ModifyPersonBaseInfoResponse) => void
|
|
273
|
-
): Promise<ModifyPersonBaseInfoResponse> {
|
|
274
|
-
return this.request("ModifyPersonBaseInfo", req, cb)
|
|
275
|
-
}
|
|
276
|
-
|
|
277
|
-
/**
|
|
235
|
+
async AnalyzeFace(req: AnalyzeFaceRequest, cb?: (error: string, rep: AnalyzeFaceResponse) => void): Promise<AnalyzeFaceResponse> {
|
|
236
|
+
return this.request("AnalyzeFace", req, cb);
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
* 修改人员信息,包括名称、性别等。人员名称和性别修改会同步到包含该人员的所有人员库。
|
|
241
|
+
*/
|
|
242
|
+
async ModifyPersonBaseInfo(req: ModifyPersonBaseInfoRequest, cb?: (error: string, rep: ModifyPersonBaseInfoResponse) => void): Promise<ModifyPersonBaseInfoResponse> {
|
|
243
|
+
return this.request("ModifyPersonBaseInfo", req, cb);
|
|
244
|
+
}
|
|
245
|
+
|
|
246
|
+
/**
|
|
278
247
|
* 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,识别结果按照相似度从大到小排序。
|
|
279
248
|
|
|
280
249
|
支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
|
|
@@ -292,26 +261,20 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
292
261
|
>
|
|
293
262
|
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
294
263
|
*/
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
): Promise<SearchFacesResponse> {
|
|
299
|
-
return this.request("SearchFaces", req, cb)
|
|
300
|
-
}
|
|
264
|
+
async SearchFaces(req: SearchFacesRequest, cb?: (error: string, rep: SearchFacesResponse) => void): Promise<SearchFacesResponse> {
|
|
265
|
+
return this.request("SearchFaces", req, cb);
|
|
266
|
+
}
|
|
301
267
|
|
|
302
|
-
|
|
268
|
+
/**
|
|
303
269
|
* 将已存在于某人员库的人员复制到其他人员库,该人员的描述信息不会被复制。单个人员最多只能同时存在100个人员库中。
|
|
304
270
|
>
|
|
305
271
|
- 注:若该人员创建时算法模型版本为2.0,复制到非2.0算法模型版本的Group中时,复制操作将会失败。
|
|
306
272
|
*/
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
): Promise<CopyPersonResponse> {
|
|
311
|
-
return this.request("CopyPerson", req, cb)
|
|
312
|
-
}
|
|
273
|
+
async CopyPerson(req: CopyPersonRequest, cb?: (error: string, rep: CopyPersonResponse) => void): Promise<CopyPersonResponse> {
|
|
274
|
+
return this.request("CopyPerson", req, cb);
|
|
275
|
+
}
|
|
313
276
|
|
|
314
|
-
|
|
277
|
+
/**
|
|
315
278
|
* 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
|
|
316
279
|
|
|
317
280
|
与[人脸比对](https://cloud.tencent.com/document/product/867/44987)接口不同的是,人脸验证用于判断 “此人是否是此人”,“此人”的信息已存于人员库中,“此人”可能存在多张人脸图片;而[人脸比对](https://cloud.tencent.com/document/product/867/44987)用于判断两张人脸的相似度。
|
|
@@ -321,44 +284,32 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
321
284
|
>
|
|
322
285
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
323
286
|
*/
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
req:
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
/**
|
|
352
|
-
* 修改人员库名称、备注、自定义描述字段名称。
|
|
353
|
-
*/
|
|
354
|
-
async ModifyGroup(
|
|
355
|
-
req: ModifyGroupRequest,
|
|
356
|
-
cb?: (error: string, rep: ModifyGroupResponse) => void
|
|
357
|
-
): Promise<ModifyGroupResponse> {
|
|
358
|
-
return this.request("ModifyGroup", req, cb)
|
|
359
|
-
}
|
|
360
|
-
|
|
361
|
-
/**
|
|
287
|
+
async VerifyFace(req: VerifyFaceRequest, cb?: (error: string, rep: VerifyFaceResponse) => void): Promise<VerifyFaceResponse> {
|
|
288
|
+
return this.request("VerifyFace", req, cb);
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
/**
|
|
292
|
+
* 对请求图片进行五官定位(也称人脸关键点定位),获得人脸的精准信息,返回多达888点关键信息,对五官和脸部轮廓进行精确定位。
|
|
293
|
+
*/
|
|
294
|
+
async AnalyzeDenseLandmarks(req: AnalyzeDenseLandmarksRequest, cb?: (error: string, rep: AnalyzeDenseLandmarksResponse) => void): Promise<AnalyzeDenseLandmarksResponse> {
|
|
295
|
+
return this.request("AnalyzeDenseLandmarks", req, cb);
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* 删除该人员信息,此操作会导致所有人员库均删除此人员。同时,该人员的所有人脸信息将被删除。
|
|
300
|
+
*/
|
|
301
|
+
async DeletePerson(req: DeletePersonRequest, cb?: (error: string, rep: DeletePersonResponse) => void): Promise<DeletePersonResponse> {
|
|
302
|
+
return this.request("DeletePerson", req, cb);
|
|
303
|
+
}
|
|
304
|
+
|
|
305
|
+
/**
|
|
306
|
+
* 修改人员库名称、备注、自定义描述字段名称。
|
|
307
|
+
*/
|
|
308
|
+
async ModifyGroup(req: ModifyGroupRequest, cb?: (error: string, rep: ModifyGroupResponse) => void): Promise<ModifyGroupResponse> {
|
|
309
|
+
return this.request("ModifyGroup", req, cb);
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
/**
|
|
362
313
|
* 升级人员库。升级过程中,人员库仍然为原算法版本,人员库相关操作仍然支持。升级完成后,人员库为新算法版本。
|
|
363
314
|
单个人员库有且仅支持一次回滚操作。
|
|
364
315
|
|
|
@@ -366,74 +317,56 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
366
317
|
|
|
367
318
|
注:某些接口无法进行跨人员库版本操作,例如SearchFaces,SearchPersons和CopyPerson等。当业务有多个Group操作的场景时,如同时搜索Group1和Group2,如果升级了Group1,此时Group1和Group2版本不同,造成了跨版本操作,将导致Search接口无法正常执行,返回不允许执行跨版本操作错误,升级前需考虑业务是否有多库操作的场景,否则会影响线上接口表现。
|
|
368
319
|
*/
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
): Promise<UpgradeGroupFaceModelVersionResponse> {
|
|
373
|
-
return this.request("UpgradeGroupFaceModelVersion", req, cb)
|
|
374
|
-
}
|
|
320
|
+
async UpgradeGroupFaceModelVersion(req: UpgradeGroupFaceModelVersionRequest, cb?: (error: string, rep: UpgradeGroupFaceModelVersionResponse) => void): Promise<UpgradeGroupFaceModelVersionResponse> {
|
|
321
|
+
return this.request("UpgradeGroupFaceModelVersion", req, cb);
|
|
322
|
+
}
|
|
375
323
|
|
|
376
|
-
|
|
324
|
+
/**
|
|
377
325
|
* 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
|
|
378
326
|
|
|
379
327
|
回滚操作会在10s内生效,回滚操作中,您对人员库的操作可能会失效。
|
|
380
328
|
*/
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
): Promise<RevertGroupFaceModelVersionResponse> {
|
|
385
|
-
return this.request("RevertGroupFaceModelVersion", req, cb)
|
|
386
|
-
}
|
|
329
|
+
async RevertGroupFaceModelVersion(req: RevertGroupFaceModelVersionRequest, cb?: (error: string, rep: RevertGroupFaceModelVersionResponse) => void): Promise<RevertGroupFaceModelVersionResponse> {
|
|
330
|
+
return this.request("RevertGroupFaceModelVersion", req, cb);
|
|
331
|
+
}
|
|
387
332
|
|
|
388
|
-
|
|
333
|
+
/**
|
|
389
334
|
* 创建人员,添加人脸、姓名、性别及其他相关信息。
|
|
390
335
|
|
|
391
336
|
>
|
|
392
337
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
393
338
|
*/
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
): Promise<CreatePersonResponse> {
|
|
398
|
-
return this.request("CreatePerson", req, cb)
|
|
399
|
-
}
|
|
339
|
+
async CreatePerson(req: CreatePersonRequest, cb?: (error: string, rep: CreatePersonResponse) => void): Promise<CreatePersonResponse> {
|
|
340
|
+
return this.request("CreatePerson", req, cb);
|
|
341
|
+
}
|
|
400
342
|
|
|
401
|
-
|
|
343
|
+
/**
|
|
402
344
|
* 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
|
|
403
345
|
|
|
404
346
|
防疫场景人脸比对接口可在人脸戴口罩情况下使用,口罩遮挡程度最高可以遮挡鼻尖。
|
|
405
347
|
|
|
406
348
|
如图片人脸不存在防疫场景下戴口罩的情况,建议使用人脸比对服务。
|
|
407
349
|
*/
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
): Promise<CompareMaskFaceResponse> {
|
|
412
|
-
return this.request("CompareMaskFace", req, cb)
|
|
413
|
-
}
|
|
350
|
+
async CompareMaskFace(req: CompareMaskFaceRequest, cb?: (error: string, rep: CompareMaskFaceResponse) => void): Promise<CompareMaskFaceResponse> {
|
|
351
|
+
return this.request("CompareMaskFace", req, cb);
|
|
352
|
+
}
|
|
414
353
|
|
|
415
|
-
|
|
354
|
+
/**
|
|
416
355
|
* 获取人员库升级任务列表
|
|
417
356
|
|
|
418
357
|
*/
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
cb?: (error: string, rep: GetGroupInfoResponse) => void
|
|
432
|
-
): Promise<GetGroupInfoResponse> {
|
|
433
|
-
return this.request("GetGroupInfo", req, cb)
|
|
434
|
-
}
|
|
435
|
-
|
|
436
|
-
/**
|
|
358
|
+
async GetUpgradeGroupFaceModelVersionJobList(req: GetUpgradeGroupFaceModelVersionJobListRequest, cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionJobListResponse) => void): Promise<GetUpgradeGroupFaceModelVersionJobListResponse> {
|
|
359
|
+
return this.request("GetUpgradeGroupFaceModelVersionJobList", req, cb);
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
/**
|
|
363
|
+
* 获取人员库信息。
|
|
364
|
+
*/
|
|
365
|
+
async GetGroupInfo(req: GetGroupInfoRequest, cb?: (error: string, rep: GetGroupInfoResponse) => void): Promise<GetGroupInfoResponse> {
|
|
366
|
+
return this.request("GetGroupInfo", req, cb);
|
|
367
|
+
}
|
|
368
|
+
|
|
369
|
+
/**
|
|
437
370
|
* 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
|
|
438
371
|
|
|
439
372
|
|
|
@@ -452,24 +385,18 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
452
385
|
|
|
453
386
|
|
|
454
387
|
*/
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
): Promise<DetectFaceResponse> {
|
|
459
|
-
return this.request("DetectFace", req, cb)
|
|
460
|
-
}
|
|
388
|
+
async DetectFace(req: DetectFaceRequest, cb?: (error: string, rep: DetectFaceResponse) => void): Promise<DetectFaceResponse> {
|
|
389
|
+
return this.request("DetectFace", req, cb);
|
|
390
|
+
}
|
|
461
391
|
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
): Promise<GetPersonListResponse> {
|
|
469
|
-
return this.request("GetPersonList", req, cb)
|
|
470
|
-
}
|
|
392
|
+
/**
|
|
393
|
+
* 获取指定人员库中的人员列表。
|
|
394
|
+
*/
|
|
395
|
+
async GetPersonList(req: GetPersonListRequest, cb?: (error: string, rep: GetPersonListResponse) => void): Promise<GetPersonListResponse> {
|
|
396
|
+
return this.request("GetPersonList", req, cb);
|
|
397
|
+
}
|
|
471
398
|
|
|
472
|
-
|
|
399
|
+
/**
|
|
473
400
|
* 给定一张人脸图片和一个 PersonId,判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/45015)。
|
|
474
401
|
本接口会将该人员(Person)下的所有人脸(Face)进行融合特征处理,即若某个Person下有4张 Face,本接口会将4张 Face 的特征进行融合处理,生成对应这个 Person 的特征,使人员验证(确定待识别的人脸图片是某人员)更加准确。
|
|
475
402
|
|
|
@@ -480,14 +407,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
480
407
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
481
408
|
- 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
|
|
482
409
|
*/
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
): Promise<VerifyPersonResponse> {
|
|
487
|
-
return this.request("VerifyPerson", req, cb)
|
|
488
|
-
}
|
|
410
|
+
async VerifyPerson(req: VerifyPersonRequest, cb?: (error: string, rep: VerifyPersonResponse) => void): Promise<VerifyPersonResponse> {
|
|
411
|
+
return this.request("VerifyPerson", req, cb);
|
|
412
|
+
}
|
|
489
413
|
|
|
490
|
-
|
|
414
|
+
/**
|
|
491
415
|
* 检测给定图片中的人脸(Face)的位置、相应的面部属性和人脸质量信息,位置包括 (x,y,w,h),面部属性包括性别(gender)、年龄(age)、表情(expression)、魅力(beauty)、眼镜(glass)、发型(hair)、口罩(mask)和姿态 (pitch,roll,yaw),人脸质量信息包括整体质量分(score)、模糊分(sharpness)、光照分(brightness)和五官遮挡分(completeness)。
|
|
492
416
|
|
|
493
417
|
|
|
@@ -510,46 +434,34 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
510
434
|
>
|
|
511
435
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
512
436
|
*/
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
): Promise<DetectFaceAttributesResponse> {
|
|
517
|
-
return this.request("DetectFaceAttributes", req, cb)
|
|
518
|
-
}
|
|
437
|
+
async DetectFaceAttributes(req: DetectFaceAttributesRequest, cb?: (error: string, rep: DetectFaceAttributesResponse) => void): Promise<DetectFaceAttributesResponse> {
|
|
438
|
+
return this.request("DetectFaceAttributes", req, cb);
|
|
439
|
+
}
|
|
519
440
|
|
|
520
|
-
|
|
441
|
+
/**
|
|
521
442
|
* 人脸静态活体检测(高精度版)可用于对用户上传的静态图片进行防翻拍活体检测,以判断是否是翻拍图片。
|
|
522
443
|
|
|
523
444
|
相比现有静态活体检测服务,高精度版在维持高真人通过率的前提下,增强了对高清屏幕、裁剪纸片、3D面具等攻击的防御能力,攻击拦截率约为业内同类型产品形态4-5倍。同时支持多场景人脸核验,满足移动端、PC端各类型场景的图片活体检验需求,适用于各个行业不同的活体检验应用。
|
|
524
445
|
*/
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
*/
|
|
545
|
-
async ModifyPersonGroupInfo(
|
|
546
|
-
req: ModifyPersonGroupInfoRequest,
|
|
547
|
-
cb?: (error: string, rep: ModifyPersonGroupInfoResponse) => void
|
|
548
|
-
): Promise<ModifyPersonGroupInfoResponse> {
|
|
549
|
-
return this.request("ModifyPersonGroupInfo", req, cb)
|
|
550
|
-
}
|
|
551
|
-
|
|
552
|
-
/**
|
|
446
|
+
async DetectLiveFaceAccurate(req: DetectLiveFaceAccurateRequest, cb?: (error: string, rep: DetectLiveFaceAccurateResponse) => void): Promise<DetectLiveFaceAccurateResponse> {
|
|
447
|
+
return this.request("DetectLiveFaceAccurate", req, cb);
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
/**
|
|
451
|
+
* 人员库升级结果查询
|
|
452
|
+
*/
|
|
453
|
+
async GetUpgradeGroupFaceModelVersionResult(req: GetUpgradeGroupFaceModelVersionResultRequest, cb?: (error: string, rep: GetUpgradeGroupFaceModelVersionResultResponse) => void): Promise<GetUpgradeGroupFaceModelVersionResultResponse> {
|
|
454
|
+
return this.request("GetUpgradeGroupFaceModelVersionResult", req, cb);
|
|
455
|
+
}
|
|
456
|
+
|
|
457
|
+
/**
|
|
458
|
+
* 修改指定人员库人员描述内容。
|
|
459
|
+
*/
|
|
460
|
+
async ModifyPersonGroupInfo(req: ModifyPersonGroupInfoRequest, cb?: (error: string, rep: ModifyPersonGroupInfoResponse) => void): Promise<ModifyPersonGroupInfoResponse> {
|
|
461
|
+
return this.request("ModifyPersonGroupInfo", req, cb);
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
/**
|
|
553
465
|
* 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照相似度从大到小排列。
|
|
554
466
|
|
|
555
467
|
支持一次性识别图片中的最多 10 张人脸,支持一次性跨 100 个人员库(Group)搜索。
|
|
@@ -562,14 +474,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
562
474
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
563
475
|
- 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
|
|
564
476
|
*/
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
): Promise<SearchPersonsResponse> {
|
|
569
|
-
return this.request("SearchPersons", req, cb)
|
|
570
|
-
}
|
|
477
|
+
async SearchPersons(req: SearchPersonsRequest, cb?: (error: string, rep: SearchPersonsResponse) => void): Promise<SearchPersonsResponse> {
|
|
478
|
+
return this.request("SearchPersons", req, cb);
|
|
479
|
+
}
|
|
571
480
|
|
|
572
|
-
|
|
481
|
+
/**
|
|
573
482
|
* 对两张图片中的人脸进行相似度比对,返回人脸相似度分数。
|
|
574
483
|
|
|
575
484
|
若您需要判断 “此人是否是某人”,即验证某张图片中的人是否是已知身份的某人,如常见的人脸登录场景,建议使用[人脸验证](https://cloud.tencent.com/document/product/867/44983)或[人员验证](https://cloud.tencent.com/document/product/867/44982)接口。
|
|
@@ -577,14 +486,11 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
577
486
|
>
|
|
578
487
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
579
488
|
*/
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
): Promise<CompareFaceResponse> {
|
|
584
|
-
return this.request("CompareFace", req, cb)
|
|
585
|
-
}
|
|
489
|
+
async CompareFace(req: CompareFaceRequest, cb?: (error: string, rep: CompareFaceResponse) => void): Promise<CompareFaceResponse> {
|
|
490
|
+
return this.request("CompareFace", req, cb);
|
|
491
|
+
}
|
|
586
492
|
|
|
587
|
-
|
|
493
|
+
/**
|
|
588
494
|
* 用于对一张待识别的人脸图片,在一个或多个人员库中识别出最相似的 TopK 人员,按照**人员库的维度**以人员相似度从大到小顺序排列。
|
|
589
495
|
|
|
590
496
|
支持一次性识别图片中的最多 10 张人脸,支持跨人员库(Group)搜索。
|
|
@@ -596,30 +502,23 @@ export class Client extends TencentCloudCommon.AbstractClient {
|
|
|
596
502
|
- 公共参数中的签名方式请使用V3版本,即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
597
503
|
- 仅支持算法模型版本(FaceModelVersion)为3.0的人员库。
|
|
598
504
|
*/
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
*/
|
|
619
|
-
async DeleteFace(
|
|
620
|
-
req: DeleteFaceRequest,
|
|
621
|
-
cb?: (error: string, rep: DeleteFaceResponse) => void
|
|
622
|
-
): Promise<DeleteFaceResponse> {
|
|
623
|
-
return this.request("DeleteFace", req, cb)
|
|
624
|
-
}
|
|
505
|
+
async SearchPersonsReturnsByGroup(req: SearchPersonsReturnsByGroupRequest, cb?: (error: string, rep: SearchPersonsReturnsByGroupResponse) => void): Promise<SearchPersonsReturnsByGroupResponse> {
|
|
506
|
+
return this.request("SearchPersonsReturnsByGroup", req, cb);
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
/**
|
|
510
|
+
* 获取人员库列表。
|
|
511
|
+
*/
|
|
512
|
+
async GetGroupList(req: GetGroupListRequest, cb?: (error: string, rep: GetGroupListResponse) => void): Promise<GetGroupListResponse> {
|
|
513
|
+
return this.request("GetGroupList", req, cb);
|
|
514
|
+
}
|
|
515
|
+
|
|
516
|
+
/**
|
|
517
|
+
* 删除一个人员下的人脸图片。如果该人员只有一张人脸图片,则返回错误。
|
|
518
|
+
*/
|
|
519
|
+
async DeleteFace(req: DeleteFaceRequest, cb?: (error: string, rep: DeleteFaceResponse) => void): Promise<DeleteFaceResponse> {
|
|
520
|
+
return this.request("DeleteFace", req, cb);
|
|
521
|
+
}
|
|
522
|
+
|
|
523
|
+
|
|
625
524
|
}
|