tencentcloud-sdk-nodejs-iai 4.0.397 → 4.0.431
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +5389 -0
- package/README.md +3 -3
- package/SERVICE_CHANGELOG.md +3620 -52
- package/package.json +1 -1
- package/products.md +92 -92
- package/src/services/iai/index.ts +9 -6
- package/src/services/iai/v20180301/iai_client.ts +278 -373
- package/src/services/iai/v20180301/iai_models.ts +1628 -1533
- package/src/services/iai/v20180301/index.ts +3 -3
- package/src/services/iai/v20200303/iai_client.ts +293 -394
- package/src/services/iai/v20200303/iai_models.ts +1685 -1586
- package/src/services/iai/v20200303/index.ts +3 -3
- package/tencentcloud/services/iai/index.d.ts +4 -4
- package/tencentcloud/services/iai/index.js +2 -2
- package/tencentcloud/services/iai/v20180301/iai_client.d.ts +186 -186
- package/tencentcloud/services/iai/v20180301/iai_client.js +186 -186
- package/tencentcloud/services/iai/v20180301/iai_models.d.ts +1174 -1174
- package/tencentcloud/services/iai/v20180301/index.js +1 -1
- package/tencentcloud/services/iai/v20200303/iai_client.d.ts +189 -189
- package/tencentcloud/services/iai/v20200303/iai_client.js +189 -189
- package/tencentcloud/services/iai/v20200303/iai_models.d.ts +1270 -1270
- package/tencentcloud/services/iai/v20200303/index.js +1 -1
|
@@ -34,32 +34,32 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
34
34
|
return this.request("DeletePersonFromGroup", req, cb);
|
|
35
35
|
}
|
|
36
36
|
/**
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
37
|
+
* 用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照**人员库的维度**以人员相似度从大到小顺序排列。
|
|
38
|
+
|
|
39
|
+
支持一次性识别图片中的最多 10 张人脸，支持跨人员库（Group）搜索。
|
|
40
|
+
|
|
41
|
+
单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的人员库，单次搜索人员库人脸总数量不得超过 300 万张。
|
|
42
|
+
|
|
43
|
+
与[人员搜索](https://cloud.tencent.com/document/product/867/38881)及[人员搜索按库返回](https://cloud.tencent.com/document/product/867/38880)接口不同的是，本接口将该人员（Person）下的每个人脸（Face）都作为单独个体进行验证，而[人员搜索](https://cloud.tencent.com/document/product/867/38881)及[人员搜索按库返回](https://cloud.tencent.com/document/product/867/38880)接口 会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个Person下有4张 Face，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使搜索更加准确。
|
|
44
|
+
|
|
45
|
+
本接口需与[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)结合使用。
|
|
46
|
+
|
|
47
|
+
>
|
|
48
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
*/
|
|
52
52
|
async SearchFacesReturnsByGroup(req, cb) {
|
|
53
53
|
return this.request("SearchFacesReturnsByGroup", req, cb);
|
|
54
54
|
}
|
|
55
55
|
/**
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
56
|
+
* 用于创建一个空的人员库，如果人员库已存在返回错误。
|
|
57
|
+
可根据需要创建自定义描述字段，用于辅助描述该人员库下的人员信息。
|
|
58
|
+
|
|
59
|
+
1个APPID下最多创建10万个人员库（Group）、最多包含5000万张人脸（Face）。
|
|
60
|
+
|
|
61
|
+
不同算法模型版本（FaceModelVersion）的人员库（Group）最多可包含人脸（Face）数不同。算法模型版本为2.0的人员库最多包含100万张人脸，算法模型版本为3.0的人员库最多可包含300万张人脸。
|
|
62
|
+
*/
|
|
63
63
|
async CreateGroup(req, cb) {
|
|
64
64
|
return this.request("CreateGroup", req, cb);
|
|
65
65
|
}
|
|
@@ -70,45 +70,45 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
70
70
|
return this.request("GetPersonBaseInfo", req, cb);
|
|
71
71
|
}
|
|
72
72
|
/**
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
73
|
+
* 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是：静态活体检测中，用户不需要通过唇语或摇头眨眼等动作来识别。
|
|
74
|
+
|
|
75
|
+
静态活体检测适用于手机自拍的场景，或对防攻击要求不高的场景。如果对活体检测有更高安全性要求，请使用[人脸核身·云智慧眼](https://cloud.tencent.com/product/faceid)产品。
|
|
76
|
+
|
|
77
|
+
>
|
|
78
|
+
- 图片的宽高比请接近3：4，不符合宽高比的图片返回的分值不具备参考意义。本接口适用于类手机自拍场景，非类手机自拍照返回的分值不具备参考意义。
|
|
79
|
+
|
|
80
|
+
>
|
|
81
|
+
- 使用过程中建议正对摄像头，不要距离太远，使面部可以完整地显示在识别的框内，识别过程中不要移动设备或遮挡面部。不要选择光线过强或过弱的环境进行面部识别，识别时不要添加任何滤镜。
|
|
82
|
+
|
|
83
|
+
>
|
|
84
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
85
|
+
|
|
86
|
+
## 调用次数计费（资源包）
|
|
87
|
+
|资源包规格|100万次|1000万次|5000万次|1亿次|
|
|
88
|
+
|-|-|-|-|-|
|
|
89
|
+
|人脸静态活体检测|1800元|17400元|75000元|110000元|
|
|
90
|
+
|
|
91
|
+
## 调用次数计费（后付费）
|
|
92
|
+
|月接口调用总量|0<调用量≤300万|300万<调用量≤1500万|调用量>1500万|
|
|
93
|
+
|-|-|-|-|
|
|
94
|
+
|人脸静态活体检测|0.0019元/次|0.0017元/次|0.0013元/次|
|
|
95
|
+
*/
|
|
96
96
|
async DetectLiveFace(req, cb) {
|
|
97
97
|
return this.request("DetectLiveFace", req, cb);
|
|
98
98
|
}
|
|
99
99
|
/**
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
100
|
+
* 将一组人脸图片添加到一个人员中。一个人员最多允许包含 5 张图片。若该人员存在多个人员库中，所有人员库中该人员图片均会增加。
|
|
101
|
+
|
|
102
|
+
>
|
|
103
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
104
|
+
*/
|
|
105
105
|
async CreateFace(req, cb) {
|
|
106
106
|
return this.request("CreateFace", req, cb);
|
|
107
107
|
}
|
|
108
108
|
/**
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
109
|
+
* 删除该人员库及包含的所有的人员。同时，人员对应的所有人脸信息将被删除。若某人员同时存在多个人员库中，该人员不会被删除，但属于该人员库中的自定义描述字段信息会被删除，属于其他人员库的自定义描述字段信息不受影响。
|
|
110
|
+
|
|
111
|
+
*/
|
|
112
112
|
async DeleteGroup(req, cb) {
|
|
113
113
|
return this.request("DeleteGroup", req, cb);
|
|
114
114
|
}
|
|
@@ -125,11 +125,11 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
125
125
|
return this.request("GetPersonGroupInfo", req, cb);
|
|
126
126
|
}
|
|
127
127
|
/**
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
128
|
+
* 对请求图片进行五官定位（也称人脸关键点定位），计算构成人脸轮廓的 90 个点，包括眉毛（左右各 8 点）、眼睛（左右各 8 点）、鼻子（13 点）、嘴巴（22 点）、脸型轮廓（21 点）、眼珠[或瞳孔]（2点）。
|
|
129
|
+
|
|
130
|
+
>
|
|
131
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
132
|
+
*/
|
|
133
133
|
async AnalyzeFace(req, cb) {
|
|
134
134
|
return this.request("AnalyzeFace", req, cb);
|
|
135
135
|
}
|
|
@@ -140,41 +140,41 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
140
140
|
return this.request("ModifyPersonBaseInfo", req, cb);
|
|
141
141
|
}
|
|
142
142
|
/**
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
143
|
+
* 用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，识别结果按照相似度从大到小排序。
|
|
144
|
+
|
|
145
|
+
支持一次性识别图片中的最多 10 张人脸，支持一次性跨 100 个人员库（Group）搜索。
|
|
146
|
+
|
|
147
|
+
单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的人员库，单次搜索人员库人脸总数量不得超过 300 万张。
|
|
148
|
+
|
|
149
|
+
与[人员搜索](https://cloud.tencent.com/document/product/867/38881)及[人员搜索按库返回](https://cloud.tencent.com/document/product/867/38880)接口不同的是，本接口将该人员（Person）下的每个人脸（Face）都作为单独个体进行验证，而人员搜索及人员搜索按库返回接口 会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个Person下有4张 Face，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使搜索更加准确。
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
本接口需与[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)结合使用。
|
|
153
|
+
|
|
154
|
+
>
|
|
155
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
156
|
+
*/
|
|
157
157
|
async SearchFaces(req, cb) {
|
|
158
158
|
return this.request("SearchFaces", req, cb);
|
|
159
159
|
}
|
|
160
160
|
/**
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
161
|
+
* 将已存在于某人员库的人员复制到其他人员库，该人员的描述信息不会被复制。单个人员最多只能同时存在100个人员库中。
|
|
162
|
+
>
|
|
163
|
+
- 注：若该人员创建时算法模型版本为2.0，复制到非2.0算法模型版本的Group中时，复制操作将会失败。
|
|
164
|
+
*/
|
|
165
165
|
async CopyPerson(req, cb) {
|
|
166
166
|
return this.request("CopyPerson", req, cb);
|
|
167
167
|
}
|
|
168
168
|
/**
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
169
|
+
* 给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)。
|
|
170
|
+
|
|
171
|
+
与[人脸比对](https://cloud.tencent.com/document/product/867/32802)接口不同的是，人脸验证用于判断 “此人是否是此人”，“此人”的信息已存于人员库中，“此人”可能存在多张人脸图片；而[人脸比对](https://cloud.tencent.com/document/product/867/32802)用于判断两张人脸的相似度。
|
|
172
|
+
|
|
173
|
+
与[人员验证](https://cloud.tencent.com/document/product/867/38879)接口不同的是，人脸验证将该人员（Person）下的每个人脸（Face）都作为单独个体进行验证，而[人员验证](https://cloud.tencent.com/document/product/867/38879)会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个 Person下有4张 Face，人员验证接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员验证（确定待识别的人脸图片是某人员）更加准确。
|
|
174
|
+
|
|
175
|
+
>
|
|
176
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
177
|
+
*/
|
|
178
178
|
async VerifyFace(req, cb) {
|
|
179
179
|
return this.request("VerifyFace", req, cb);
|
|
180
180
|
}
|
|
@@ -197,34 +197,34 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
197
197
|
return this.request("ModifyGroup", req, cb);
|
|
198
198
|
}
|
|
199
199
|
/**
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
200
|
+
* 升级人员库。升级过程中，人员库仍然为原算法版本，人员库相关操作仍然支持。升级完成后，人员库为新算法版本。
|
|
201
|
+
单个人员库有且仅支持一次回滚操作。
|
|
202
|
+
注：此处QPS限制为10。
|
|
203
|
+
*/
|
|
204
204
|
async UpgradeGroupFaceModelVersion(req, cb) {
|
|
205
205
|
return this.request("UpgradeGroupFaceModelVersion", req, cb);
|
|
206
206
|
}
|
|
207
207
|
/**
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
208
|
+
* 本接口用于回滚人员库的人脸识别算法模型版本。单个人员库有且仅有一次回滚机会。
|
|
209
|
+
|
|
210
|
+
回滚操作会在10s内生效，回滚操作中，您对人员库的操作可能会失效。
|
|
211
|
+
*/
|
|
212
212
|
async RevertGroupFaceModelVersion(req, cb) {
|
|
213
213
|
return this.request("RevertGroupFaceModelVersion", req, cb);
|
|
214
214
|
}
|
|
215
215
|
/**
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
216
|
+
* 创建人员，添加人脸、姓名、性别及其他相关信息。
|
|
217
|
+
|
|
218
|
+
>
|
|
219
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
220
|
+
*/
|
|
221
221
|
async CreatePerson(req, cb) {
|
|
222
222
|
return this.request("CreatePerson", req, cb);
|
|
223
223
|
}
|
|
224
224
|
/**
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
225
|
+
* 获取人员库升级任务列表
|
|
226
|
+
|
|
227
|
+
*/
|
|
228
228
|
async GetUpgradeGroupFaceModelVersionJobList(req, cb) {
|
|
229
229
|
return this.request("GetUpgradeGroupFaceModelVersionJobList", req, cb);
|
|
230
230
|
}
|
|
@@ -235,24 +235,24 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
235
235
|
return this.request("GetGroupInfo", req, cb);
|
|
236
236
|
}
|
|
237
237
|
/**
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
238
|
+
* 检测给定图片中的人脸（Face）的位置、相应的面部属性和人脸质量信息，位置包括 (x，y，w，h)，面部属性包括性别（gender）、年龄（age）、表情（expression）、魅力（beauty）、眼镜（glass）、发型（hair）、口罩（mask）和姿态 (pitch，roll，yaw)，人脸质量信息包括整体质量分（score）、模糊分（sharpness）、光照分（brightness）和五官遮挡分（completeness）。
|
|
239
|
+
|
|
240
|
+
|
|
241
|
+
其中，人脸质量信息主要用于评价输入的人脸图片的质量。在使用人脸识别服务时，建议您对输入的人脸图片进行质量检测，提升后续业务处理的效果。该功能的应用场景包括：
|
|
242
|
+
|
|
243
|
+
1） 人员库[创建人员](https://cloud.tencent.com/document/product/867/32793)/[增加人脸](https://cloud.tencent.com/document/product/867/32795)：保证人员人脸信息的质量，便于后续的业务处理。
|
|
244
|
+
|
|
245
|
+
2） [人脸搜索](https://cloud.tencent.com/document/product/867/32798)：保证输入的图片质量，快速准确匹配到对应的人员。
|
|
246
|
+
|
|
247
|
+
3） [人脸验证](https://cloud.tencent.com/document/product/867/32806)：保证人脸信息的质量，避免明明是本人却认证不通过的情况。
|
|
248
|
+
|
|
249
|
+
4） [人脸融合](https://cloud.tencent.com/product/facefusion)：保证上传的人脸质量，人脸融合的效果更好。
|
|
250
|
+
|
|
251
|
+
>
|
|
252
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
*/
|
|
256
256
|
async DetectFace(req, cb) {
|
|
257
257
|
return this.request("DetectFace", req, cb);
|
|
258
258
|
}
|
|
@@ -263,51 +263,51 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
263
263
|
return this.request("GetPersonList", req, cb);
|
|
264
264
|
}
|
|
265
265
|
/**
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
266
|
+
* 给定一张人脸图片和一个 PersonId，判断图片中的人和 PersonId 对应的人是否为同一人。PersonId 请参考[人员库管理相关接口](https://cloud.tencent.com/document/product/867/32794)。
|
|
267
|
+
本接口会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个Person下有4张 Face，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员验证（确定待识别的人脸图片是某人员）更加准确。
|
|
268
|
+
|
|
269
|
+
和人脸比对相关接口不同的是，人脸验证相关接口用于判断 “此人是否是此人”，“此人”的信息已存于人员库中，“此人”可能存在多张人脸图片；而人脸比对相关接口用于判断两张人脸的相似度。
|
|
270
|
+
|
|
271
|
+
|
|
272
|
+
>
|
|
273
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
274
|
+
- 仅支持算法模型版本（FaceModelVersion）为3.0的人员库。
|
|
275
|
+
*/
|
|
276
276
|
async VerifyPerson(req, cb) {
|
|
277
277
|
return this.request("VerifyPerson", req, cb);
|
|
278
278
|
}
|
|
279
279
|
/**
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
280
|
+
* 检测给定图片中的人脸（Face）的位置、相应的面部属性和人脸质量信息，位置包括 (x，y，w，h)，面部属性包括性别（gender）、年龄（age）、表情（expression）、魅力（beauty）、眼镜（glass）、发型（hair）、口罩（mask）和姿态 (pitch，roll，yaw)，人脸质量信息包括整体质量分（score）、模糊分（sharpness）、光照分（brightness）和五官遮挡分（completeness）。
|
|
281
|
+
|
|
282
|
+
|
|
283
|
+
其中，人脸质量信息主要用于评价输入的人脸图片的质量。在使用人脸识别服务时，建议您对输入的人脸图片进行质量检测，提升后续业务处理的效果。该功能的应用场景包括：
|
|
284
|
+
|
|
285
|
+
1） 人员库[创建人员](https://cloud.tencent.com/document/product/867/32793)/[增加人脸](https://cloud.tencent.com/document/product/867/32795)：保证人员人脸信息的质量，便于后续的业务处理。
|
|
286
|
+
|
|
287
|
+
2） [人脸搜索](https://cloud.tencent.com/document/product/867/32798)：保证输入的图片质量，快速准确匹配到对应的人员。
|
|
288
|
+
|
|
289
|
+
3） [人脸验证](https://cloud.tencent.com/document/product/867/32806)：保证人脸信息的质量，避免明明是本人却认证不通过的情况。
|
|
290
|
+
|
|
291
|
+
4） [人脸融合](https://cloud.tencent.com/product/facefusion)：保证上传的人脸质量，人脸融合的效果更好。
|
|
292
|
+
|
|
293
|
+
>
|
|
294
|
+
- 本接口是[人脸检测与分析](https://cloud.tencent.com/document/product/867/32800)的升级，具体在于：
|
|
295
|
+
|
|
296
|
+
1.本接口可以指定需要计算返回的人脸属性，避免无效计算，降低耗时；
|
|
297
|
+
|
|
298
|
+
2.本接口支持更多属性细项数，也会持续增加更多功能。
|
|
299
|
+
|
|
300
|
+
请您使用本接口完成相应的人脸检测与属性分析需求。
|
|
301
|
+
|
|
302
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
303
|
+
*/
|
|
304
304
|
async DetectFaceAttributes(req, cb) {
|
|
305
305
|
return this.request("DetectFaceAttributes", req, cb);
|
|
306
306
|
}
|
|
307
307
|
/**
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
308
|
+
* 人员库升级结果查询
|
|
309
|
+
|
|
310
|
+
*/
|
|
311
311
|
async GetUpgradeGroupFaceModelVersionResult(req, cb) {
|
|
312
312
|
return this.request("GetUpgradeGroupFaceModelVersionResult", req, cb);
|
|
313
313
|
}
|
|
@@ -318,44 +318,44 @@ class Client extends TencentCloudCommon.AbstractClient {
|
|
|
318
318
|
return this.request("ModifyPersonGroupInfo", req, cb);
|
|
319
319
|
}
|
|
320
320
|
/**
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
321
|
+
* 用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照相似度从大到小排列。
|
|
322
|
+
|
|
323
|
+
支持一次性识别图片中的最多 10 张人脸，支持一次性跨 100 个人员库（Group）搜索。
|
|
324
|
+
|
|
325
|
+
单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的人员库，单次搜索人员库人脸总数量不得超过 300 万张。
|
|
326
|
+
|
|
327
|
+
本接口会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个 Person 下有4张 Face ，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员搜索（确定待识别的人脸图片是某人）更加准确。而[人脸搜索](https://cloud.tencent.com/document/product/867/32798)及[人脸搜索按库返回接口](https://cloud.tencent.com/document/product/867/38882)将该人员（Person）下的每个人脸（Face）都作为单独个体进行搜索。
|
|
328
|
+
|
|
329
|
+
>
|
|
330
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
331
|
+
- 仅支持算法模型版本（FaceModelVersion）为3.0的人员库。
|
|
332
|
+
*/
|
|
333
333
|
async SearchPersons(req, cb) {
|
|
334
334
|
return this.request("SearchPersons", req, cb);
|
|
335
335
|
}
|
|
336
336
|
/**
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
337
|
+
* 对两张图片中的人脸进行相似度比对，返回人脸相似度分数。
|
|
338
|
+
|
|
339
|
+
若您需要判断 “此人是否是某人”，即验证某张图片中的人是否是已知身份的某人，如常见的人脸登录场景，建议使用[人脸验证](https://cloud.tencent.com/document/product/867/32806)或[人员验证](https://cloud.tencent.com/document/product/867/38879)接口。
|
|
340
|
+
|
|
341
|
+
>
|
|
342
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
343
|
+
*/
|
|
344
344
|
async CompareFace(req, cb) {
|
|
345
345
|
return this.request("CompareFace", req, cb);
|
|
346
346
|
}
|
|
347
347
|
/**
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
348
|
+
* 用于对一张待识别的人脸图片，在一个或多个人员库中识别出最相似的 TopK 人员，按照**人员库的维度**以人员相似度从大到小顺序排列。
|
|
349
|
+
|
|
350
|
+
支持一次性识别图片中的最多 10 张人脸，支持跨人员库（Group）搜索。
|
|
351
|
+
|
|
352
|
+
单次搜索的人员库人脸总数量和人员库的算法模型版本（FaceModelVersion）相关。算法模型版本为2.0的人员库，单次搜索人员库人脸总数量不得超过 100 万张；算法模型版本为3.0的人员库，单次搜索人员库人脸总数量不得超过 300 万张。
|
|
353
|
+
|
|
354
|
+
本接口会将该人员（Person）下的所有人脸（Face）进行融合特征处理，即若某个 Person 下有4张 Face ，本接口会将4张 Face 的特征进行融合处理，生成对应这个 Person 的特征，使人员搜索（确定待识别的人脸图片是某人）更加准确。而[人脸搜索](https://cloud.tencent.com/document/product/867/32798)及[人脸搜索按库返回接口](https://cloud.tencent.com/document/product/867/38882)将该人员（Person）下的每个人脸（Face）都作为单独个体进行搜索。
|
|
355
|
+
>
|
|
356
|
+
- 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
|
|
357
|
+
- 仅支持算法模型版本（FaceModelVersion）为3.0的人员库。
|
|
358
|
+
*/
|
|
359
359
|
async SearchPersonsReturnsByGroup(req, cb) {
|
|
360
360
|
return this.request("SearchPersonsReturnsByGroup", req, cb);
|
|
361
361
|
}
|