tencentcloud-sdk-iai 3.0.941 → 3.0.942
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.
- checksums.yaml +4 -4
- data/lib/VERSION +1 -1
- data/lib/v20180301/models.rb +20 -13
- data/lib/v20200303/models.rb +380 -273
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ad1b8098cafdce4d459e00df251d20e6c94d1aed
|
|
4
|
+
data.tar.gz: e3f201050144cbf6927691b7d0262bf1104065c2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4b7b37cc5399594b0bfc9748a5d117bed7026e304886333104e15c12dd772753c0a89b5c460bcbad8a919cffcd86b28a6388152e492600c53a8feb2e4265e502
|
|
7
|
+
data.tar.gz: ee8b03b1633a758a004fc9f0e9538a57b7fb555058891d393991e909a46b0ed0747c8fb7b18fc82fbd98d1a93276d81c480dbeb581294e6f0641b4e7d85b194b
|
data/lib/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
3.0.
|
|
1
|
+
3.0.942
|
data/lib/v20180301/models.rb
CHANGED
|
@@ -19,24 +19,31 @@ module TencentCloud
|
|
|
19
19
|
module V20180301
|
|
20
20
|
# AnalyzeDenseLandmarks请求参数结构体
|
|
21
21
|
class AnalyzeDenseLandmarksRequest < TencentCloud::Common::AbstractModel
|
|
22
|
-
# @param Mode: 检测模式。
|
|
23
|
-
#
|
|
24
|
-
#
|
|
22
|
+
# @param Mode: 检测模式。
|
|
23
|
+
# - 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
|
24
|
+
# - 默认为 0。
|
|
25
|
+
# - 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
|
25
26
|
# @type Mode: Integer
|
|
26
|
-
# @param Image: 图片 base64
|
|
27
|
-
#
|
|
28
|
-
#
|
|
27
|
+
# @param Image: 图片 base64 数据。
|
|
28
|
+
# - base64 编码后大小不可超过5M。
|
|
29
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
30
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
29
31
|
# @type Image: String
|
|
30
|
-
# @param Url: 图片的 Url
|
|
31
|
-
#
|
|
32
|
-
#
|
|
33
|
-
#
|
|
34
|
-
#
|
|
35
|
-
#
|
|
32
|
+
# @param Url: 图片的 Url 。
|
|
33
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
34
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
35
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
36
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
37
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
38
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
36
39
|
# @type Url: String
|
|
37
40
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
|
38
41
|
# @type FaceModelVersion: String
|
|
39
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
42
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
43
|
+
# - 取值范围:0为不开启,1为开启。
|
|
44
|
+
# - 默认为0。
|
|
45
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
46
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
40
47
|
# @type NeedRotateDetection: Integer
|
|
41
48
|
|
|
42
49
|
attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
|
data/lib/v20200303/models.rb
CHANGED
|
@@ -272,52 +272,58 @@ module TencentCloud
|
|
|
272
272
|
|
|
273
273
|
# CompareFace请求参数结构体
|
|
274
274
|
class CompareFaceRequest < TencentCloud::Common::AbstractModel
|
|
275
|
-
# @param ImageA: A 图片 base64
|
|
276
|
-
#
|
|
277
|
-
#
|
|
278
|
-
#
|
|
275
|
+
# @param ImageA: A 图片 base64 数据。
|
|
276
|
+
# - base64 编码后大小不可超过5M。
|
|
277
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
278
|
+
# - 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
|
279
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
279
280
|
# @type ImageA: String
|
|
280
|
-
# @param ImageB: B 图片 base64
|
|
281
|
-
#
|
|
282
|
-
#
|
|
283
|
-
#
|
|
281
|
+
# @param ImageB: B 图片 base64 数据。
|
|
282
|
+
# - base64 编码后大小不可超过5M。
|
|
283
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
284
|
+
# - 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
|
285
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
284
286
|
# @type ImageB: String
|
|
285
|
-
# @param UrlA: A 图片的 Url
|
|
286
|
-
#
|
|
287
|
-
#
|
|
288
|
-
#
|
|
289
|
-
#
|
|
290
|
-
#
|
|
291
|
-
#
|
|
287
|
+
# @param UrlA: A 图片的 Url。
|
|
288
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
289
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
290
|
+
# - A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
291
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
292
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
293
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
294
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
292
295
|
# @type UrlA: String
|
|
293
|
-
# @param UrlB: B 图片的 Url
|
|
294
|
-
#
|
|
295
|
-
#
|
|
296
|
-
#
|
|
297
|
-
#
|
|
298
|
-
#
|
|
299
|
-
#
|
|
296
|
+
# @param UrlB: B 图片的 Url 。
|
|
297
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
298
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
299
|
+
# - B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
300
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
301
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
302
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
303
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
300
304
|
# @type UrlB: String
|
|
301
305
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
|
302
|
-
|
|
303
|
-
#
|
|
304
|
-
|
|
305
|
-
#
|
|
306
|
-
|
|
307
|
-
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
308
|
-
|
|
309
|
-
# 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
306
|
+
# - 目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
307
|
+
# - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
308
|
+
# - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
309
|
+
# - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
310
310
|
# @type FaceModelVersion: String
|
|
311
311
|
# @param QualityControl: 图片质量控制。
|
|
312
|
+
# - 取值范围:
|
|
312
313
|
# 0: 不进行控制;
|
|
313
314
|
# 1: 较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
314
315
|
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
315
316
|
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
316
317
|
# 4: 很高的质量要求,各个维度均为最好或最多,在某一维度上存在轻微问题;
|
|
317
318
|
# 默认 0。
|
|
318
|
-
|
|
319
|
+
|
|
320
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
319
321
|
# @type QualityControl: Integer
|
|
320
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
322
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
323
|
+
# - 取值范围:0为不开启,1为开启。
|
|
324
|
+
# - 默认为0。
|
|
325
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
326
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
321
327
|
# @type NeedRotateDetection: Integer
|
|
322
328
|
|
|
323
329
|
attr_accessor :ImageA, :ImageB, :UrlA, :UrlB, :FaceModelVersion, :QualityControl, :NeedRotateDetection
|
|
@@ -346,10 +352,10 @@ module TencentCloud
|
|
|
346
352
|
# CompareFace返回参数结构体
|
|
347
353
|
class CompareFaceResponse < TencentCloud::Common::AbstractModel
|
|
348
354
|
# @param Score: 两张图片中人脸的相似度分数。
|
|
349
|
-
# 不同算法版本返回的相似度分数不同。
|
|
350
|
-
# 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
351
|
-
# 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
352
|
-
# 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
355
|
+
# - 不同算法版本返回的相似度分数不同。
|
|
356
|
+
# - 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
357
|
+
# - 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
358
|
+
# - 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
353
359
|
# @type Score: Float
|
|
354
360
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
|
355
361
|
# @type FaceModelVersion: String
|
|
@@ -373,42 +379,47 @@ module TencentCloud
|
|
|
373
379
|
|
|
374
380
|
# CompareMaskFace请求参数结构体
|
|
375
381
|
class CompareMaskFaceRequest < TencentCloud::Common::AbstractModel
|
|
376
|
-
# @param ImageA: A 图片 base64
|
|
377
|
-
#
|
|
378
|
-
#
|
|
379
|
-
#
|
|
382
|
+
# @param ImageA: A 图片 base64 数据。
|
|
383
|
+
# - base64 编码后大小不可超过5M。
|
|
384
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
385
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
386
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
380
387
|
# @type ImageA: String
|
|
381
|
-
# @param ImageB: B 图片 base64
|
|
382
|
-
#
|
|
383
|
-
#
|
|
384
|
-
#
|
|
388
|
+
# @param ImageB: B 图片 base64 数据。
|
|
389
|
+
# - base64 编码后大小不可超过5M。
|
|
390
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
391
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
392
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
385
393
|
# @type ImageB: String
|
|
386
|
-
# @param UrlA: A 图片的 Url
|
|
387
|
-
#
|
|
388
|
-
#
|
|
389
|
-
#
|
|
390
|
-
#
|
|
391
|
-
#
|
|
392
|
-
#
|
|
394
|
+
# @param UrlA: A 图片的 Url 。
|
|
395
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
396
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
397
|
+
# - A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
398
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
399
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
400
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
401
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
393
402
|
# @type UrlA: String
|
|
394
|
-
# @param UrlB: B 图片的 Url
|
|
395
|
-
#
|
|
396
|
-
#
|
|
397
|
-
#
|
|
398
|
-
#
|
|
399
|
-
#
|
|
400
|
-
#
|
|
403
|
+
# @param UrlB: B 图片的 Url 。
|
|
404
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
405
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
406
|
+
# - B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
407
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
408
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
409
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
410
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
401
411
|
# @type UrlB: String
|
|
402
412
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
|
|
403
413
|
# @type FaceModelVersion: String
|
|
404
414
|
# @param QualityControl: 图片质量控制。
|
|
415
|
+
# - 取值范围:
|
|
405
416
|
# 0: 不进行控制;
|
|
406
417
|
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
407
418
|
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
408
419
|
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
409
420
|
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
410
|
-
# 默认 0。
|
|
411
|
-
# 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
421
|
+
# - 默认 0。
|
|
422
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
412
423
|
# @type QualityControl: Integer
|
|
413
424
|
|
|
414
425
|
attr_accessor :ImageA, :ImageB, :UrlA, :UrlB, :FaceModelVersion, :QualityControl
|
|
@@ -435,10 +446,10 @@ module TencentCloud
|
|
|
435
446
|
# CompareMaskFace返回参数结构体
|
|
436
447
|
class CompareMaskFaceResponse < TencentCloud::Common::AbstractModel
|
|
437
448
|
# @param Score: 两张图片中人脸的相似度分数。
|
|
438
|
-
# 不同算法版本返回的相似度分数不同。
|
|
439
|
-
# 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
440
|
-
# 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
441
|
-
# 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
449
|
+
# - 不同算法版本返回的相似度分数不同。
|
|
450
|
+
# - 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
|
451
|
+
# - 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
|
452
|
+
# - 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
|
442
453
|
# @type Score: Float
|
|
443
454
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
|
444
455
|
# @type FaceModelVersion: String
|
|
@@ -462,9 +473,9 @@ module TencentCloud
|
|
|
462
473
|
|
|
463
474
|
# CopyPerson请求参数结构体
|
|
464
475
|
class CopyPersonRequest < TencentCloud::Common::AbstractModel
|
|
465
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
476
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
466
477
|
# @type PersonId: String
|
|
467
|
-
# @param GroupIds: 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId
|
|
478
|
+
# @param GroupIds: 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId。
|
|
468
479
|
# @type GroupIds: Array
|
|
469
480
|
|
|
470
481
|
attr_accessor :PersonId, :GroupIds
|
|
@@ -482,9 +493,9 @@ module TencentCloud
|
|
|
482
493
|
|
|
483
494
|
# CopyPerson返回参数结构体
|
|
484
495
|
class CopyPersonResponse < TencentCloud::Common::AbstractModel
|
|
485
|
-
# @param SucGroupNum:
|
|
496
|
+
# @param SucGroupNum: 成功加入的人员库数量。
|
|
486
497
|
# @type SucGroupNum: Integer
|
|
487
|
-
# @param SucGroupIds:
|
|
498
|
+
# @param SucGroupIds: 成功加入的人员库列表。
|
|
488
499
|
# @type SucGroupIds: Array
|
|
489
500
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
490
501
|
# @type RequestId: String
|
|
@@ -506,36 +517,44 @@ module TencentCloud
|
|
|
506
517
|
|
|
507
518
|
# CreateFace请求参数结构体
|
|
508
519
|
class CreateFaceRequest < TencentCloud::Common::AbstractModel
|
|
509
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
520
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
510
521
|
# @type PersonId: String
|
|
511
|
-
# @param Images: 图片 base64
|
|
512
|
-
#
|
|
513
|
-
#
|
|
514
|
-
#
|
|
515
|
-
#
|
|
522
|
+
# @param Images: 图片 base64 数据。
|
|
523
|
+
# - base64 编码后大小不可超过5M。
|
|
524
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
525
|
+
# - 人员人脸总数量不可超过5张。
|
|
526
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
527
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
516
528
|
# @type Images: Array
|
|
517
|
-
# @param Urls: 图片的 Url
|
|
518
|
-
#
|
|
519
|
-
#
|
|
520
|
-
#
|
|
521
|
-
#
|
|
522
|
-
#
|
|
523
|
-
#
|
|
524
|
-
#
|
|
529
|
+
# @param Urls: 图片的 Url 。
|
|
530
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
531
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
532
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
533
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
534
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
535
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
536
|
+
# - 人员人脸总数量不可超过5张。
|
|
537
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
525
538
|
# @type Urls: Array
|
|
526
539
|
# @param FaceMatchThreshold: 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
|
527
|
-
# 默认值60
|
|
540
|
+
# - 默认值60分。
|
|
541
|
+
# - 取值范围:[0,100] 。
|
|
528
542
|
# @type FaceMatchThreshold: Float
|
|
529
543
|
# @param QualityControl: 图片质量控制。
|
|
544
|
+
# - 取值范围:
|
|
530
545
|
# 0: 不进行控制;
|
|
531
546
|
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
532
547
|
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
533
548
|
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
534
549
|
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
535
|
-
# 默认 0。
|
|
536
|
-
# 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
550
|
+
# - 默认 0。
|
|
551
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
537
552
|
# @type QualityControl: Integer
|
|
538
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
553
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
554
|
+
# - 取值范围:0为不开启,1为开启。
|
|
555
|
+
# - 默认为0。
|
|
556
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
557
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
539
558
|
# @type NeedRotateDetection: Integer
|
|
540
559
|
|
|
541
560
|
attr_accessor :PersonId, :Images, :Urls, :FaceMatchThreshold, :QualityControl, :NeedRotateDetection
|
|
@@ -561,17 +580,22 @@ module TencentCloud
|
|
|
561
580
|
|
|
562
581
|
# CreateFace返回参数结构体
|
|
563
582
|
class CreateFaceResponse < TencentCloud::Common::AbstractModel
|
|
564
|
-
# @param SucFaceNum:
|
|
583
|
+
# @param SucFaceNum: 加入成功的人脸数量。
|
|
565
584
|
# @type SucFaceNum: Integer
|
|
566
|
-
# @param SucFaceIds: 加入成功的人脸ID
|
|
585
|
+
# @param SucFaceIds: 加入成功的人脸ID列表。
|
|
567
586
|
# @type SucFaceIds: Array
|
|
568
|
-
# @param RetCode:
|
|
569
|
-
# -
|
|
570
|
-
#
|
|
571
|
-
#
|
|
587
|
+
# @param RetCode: 每张人脸图片添加结果。
|
|
588
|
+
# - 其他非 0 值代表算法服务异常,取值范围:
|
|
589
|
+
# -1101 代表未检测到人脸。
|
|
590
|
+
# -1102 代表图片解码失败。
|
|
591
|
+
# -1109 代表图片尺寸过大或者过小。
|
|
592
|
+
# -1601代表不符合图片质量控制要求。
|
|
593
|
+
# -1604 代表人脸相似度没有超过FaceMatchThreshold。
|
|
594
|
+
# - RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
572
595
|
# @type RetCode: Array
|
|
573
|
-
# @param SucIndexes:
|
|
574
|
-
#
|
|
596
|
+
# @param SucIndexes: 加入成功的人脸索引。
|
|
597
|
+
# - 索引顺序和入参中 Images 或 Urls 的顺序一致。
|
|
598
|
+
# - 例如, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
|
575
599
|
# @type SucIndexes: Array
|
|
576
600
|
# @param SucFaceRects: 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
|
|
577
601
|
# @type SucFaceRects: Array
|
|
@@ -617,20 +641,18 @@ module TencentCloud
|
|
|
617
641
|
# @param GroupId: 人员库 ID,不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
|
|
618
642
|
# @type GroupId: String
|
|
619
643
|
# @param GroupExDescriptions: 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
|
620
|
-
# 最多可以创建5个。
|
|
621
|
-
# 每个自定义描述字段支持[1,30]个字符。
|
|
622
|
-
# 在同一人员库中自定义描述字段不可重复。
|
|
623
|
-
# 例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
|
624
|
-
# 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
|
625
|
-
# 可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
644
|
+
# - 最多可以创建5个。
|
|
645
|
+
# - 每个自定义描述字段支持[1,30]个字符。
|
|
646
|
+
# - 在同一人员库中自定义描述字段不可重复。
|
|
647
|
+
# - 例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"], 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段, 可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
|
626
648
|
# @type GroupExDescriptions: Array
|
|
627
649
|
# @param Tag: 人员库信息备注,[0,40]个字符。
|
|
628
650
|
# @type Tag: String
|
|
629
651
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
|
630
|
-
# 目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
631
|
-
# 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
632
|
-
# 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
633
|
-
# 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
652
|
+
# - 目前入参支持 “2.0”和“3.0“ 两个输入。
|
|
653
|
+
# - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
|
654
|
+
# - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
|
655
|
+
# - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
|
634
656
|
# @type FaceModelVersion: String
|
|
635
657
|
|
|
636
658
|
attr_accessor :GroupName, :GroupId, :GroupExDescriptions, :Tag, :FaceModelVersion
|
|
@@ -674,48 +696,59 @@ module TencentCloud
|
|
|
674
696
|
|
|
675
697
|
# CreatePerson请求参数结构体
|
|
676
698
|
class CreatePersonRequest < TencentCloud::Common::AbstractModel
|
|
677
|
-
# @param GroupId: 待加入的人员库ID,取值为创建人员库接口中的GroupId
|
|
699
|
+
# @param GroupId: 待加入的人员库ID,取值为创建人员库接口中的GroupId。
|
|
678
700
|
# @type GroupId: String
|
|
679
701
|
# @param PersonName: 人员名称。[1,60]个字符,可修改,可重复。
|
|
680
702
|
# @type PersonName: String
|
|
681
|
-
# @param PersonId: 人员ID
|
|
703
|
+
# @param PersonId: 人员ID。
|
|
704
|
+
# - 单个腾讯云账号下不可修改,不可重复。
|
|
705
|
+
# - 支持英文、数字、-%@#&_,长度限制64B。
|
|
682
706
|
# @type PersonId: String
|
|
683
|
-
# @param Gender:
|
|
707
|
+
# @param Gender: 性别。
|
|
708
|
+
# - 取值范围:0代表未填写,1代表男性,2代表女性。
|
|
684
709
|
# @type Gender: Integer
|
|
685
710
|
# @param PersonExDescriptionInfos: 人员描述字段内容,key-value。[0,60]个字符,可修改,可重复。
|
|
686
711
|
# @type PersonExDescriptionInfos: Array
|
|
687
|
-
# @param Image: 图片 base64
|
|
688
|
-
#
|
|
689
|
-
#
|
|
712
|
+
# @param Image: 图片 base64 数据。
|
|
713
|
+
# - base64 编码后大小不可超过5M。
|
|
714
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
715
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
690
716
|
# @type Image: String
|
|
691
|
-
# @param Url: 图片的 Url
|
|
692
|
-
#
|
|
693
|
-
#
|
|
694
|
-
#
|
|
695
|
-
#
|
|
696
|
-
#
|
|
717
|
+
# @param Url: 图片的 Url 。
|
|
718
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
719
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
|
720
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
721
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
722
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
723
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
697
724
|
# @type Url: String
|
|
698
725
|
# @param UniquePersonControl: 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
|
699
|
-
# 如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
700
|
-
# 如果判断没有,则完成创建人员。
|
|
726
|
+
# - 如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
|
727
|
+
# - 如果判断没有,则完成创建人员。
|
|
728
|
+
# - 取值范围:
|
|
701
729
|
# 0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
|
702
730
|
# 1:较低的同一人判断要求(百一误识别率);
|
|
703
731
|
# 2: 一般的同一人判断要求(千一误识别率);
|
|
704
732
|
# 3: 较高的同一人判断要求(万一误识别率);
|
|
705
733
|
# 4: 很高的同一人判断要求(十万一误识别率)。
|
|
706
|
-
# 默认 0。
|
|
707
|
-
# 注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
734
|
+
# - 默认 0。
|
|
735
|
+
# - 注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
|
708
736
|
# @type UniquePersonControl: Integer
|
|
709
737
|
# @param QualityControl: 图片质量控制。
|
|
738
|
+
# - 取值范围:
|
|
710
739
|
# 0: 不进行控制;
|
|
711
740
|
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
|
712
741
|
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
|
713
742
|
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
|
714
743
|
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
|
715
|
-
# 默认 0。
|
|
716
|
-
# 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
744
|
+
# - 默认 0。
|
|
745
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
717
746
|
# @type QualityControl: Integer
|
|
718
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
747
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
748
|
+
# - 取值范围:0为不开启,1为开启。
|
|
749
|
+
# - 默认为0。
|
|
750
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
751
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
719
752
|
# @type NeedRotateDetection: Integer
|
|
720
753
|
|
|
721
754
|
attr_accessor :GroupId, :PersonName, :PersonId, :Gender, :PersonExDescriptionInfos, :Image, :Url, :UniquePersonControl, :QualityControl, :NeedRotateDetection
|
|
@@ -762,7 +795,7 @@ module TencentCloud
|
|
|
762
795
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
|
763
796
|
# @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
|
|
764
797
|
# @param SimilarPersonId: 疑似同一人的PersonId。
|
|
765
|
-
# 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
798
|
+
# - 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
|
766
799
|
# @type SimilarPersonId: String
|
|
767
800
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
|
768
801
|
# @type FaceModelVersion: String
|
|
@@ -793,9 +826,9 @@ module TencentCloud
|
|
|
793
826
|
|
|
794
827
|
# DeleteFace请求参数结构体
|
|
795
828
|
class DeleteFaceRequest < TencentCloud::Common::AbstractModel
|
|
796
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
829
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
797
830
|
# @type PersonId: String
|
|
798
|
-
# @param FaceIds: 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId
|
|
831
|
+
# @param FaceIds: 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId。
|
|
799
832
|
# @type FaceIds: Array
|
|
800
833
|
|
|
801
834
|
attr_accessor :PersonId, :FaceIds
|
|
@@ -813,9 +846,9 @@ module TencentCloud
|
|
|
813
846
|
|
|
814
847
|
# DeleteFace返回参数结构体
|
|
815
848
|
class DeleteFaceResponse < TencentCloud::Common::AbstractModel
|
|
816
|
-
# @param SucDeletedNum:
|
|
849
|
+
# @param SucDeletedNum: 删除成功的人脸数量.
|
|
817
850
|
# @type SucDeletedNum: Integer
|
|
818
|
-
# @param SucFaceIds: 删除成功的人脸ID
|
|
851
|
+
# @param SucFaceIds: 删除成功的人脸ID列表。
|
|
819
852
|
# @type SucFaceIds: Array
|
|
820
853
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
821
854
|
# @type RequestId: String
|
|
@@ -837,7 +870,7 @@ module TencentCloud
|
|
|
837
870
|
|
|
838
871
|
# DeleteGroup请求参数结构体
|
|
839
872
|
class DeleteGroupRequest < TencentCloud::Common::AbstractModel
|
|
840
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
873
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
841
874
|
# @type GroupId: String
|
|
842
875
|
|
|
843
876
|
attr_accessor :GroupId
|
|
@@ -869,9 +902,9 @@ module TencentCloud
|
|
|
869
902
|
|
|
870
903
|
# DeletePersonFromGroup请求参数结构体
|
|
871
904
|
class DeletePersonFromGroupRequest < TencentCloud::Common::AbstractModel
|
|
872
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
905
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
873
906
|
# @type PersonId: String
|
|
874
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
907
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
875
908
|
# @type GroupId: String
|
|
876
909
|
|
|
877
910
|
attr_accessor :PersonId, :GroupId
|
|
@@ -905,7 +938,7 @@ module TencentCloud
|
|
|
905
938
|
|
|
906
939
|
# DeletePerson请求参数结构体
|
|
907
940
|
class DeletePersonRequest < TencentCloud::Common::AbstractModel
|
|
908
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
941
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
909
942
|
# @type PersonId: String
|
|
910
943
|
|
|
911
944
|
attr_accessor :PersonId
|
|
@@ -2133,7 +2166,7 @@ module TencentCloud
|
|
|
2133
2166
|
|
|
2134
2167
|
# GetGroupInfo请求参数结构体
|
|
2135
2168
|
class GetGroupInfoRequest < TencentCloud::Common::AbstractModel
|
|
2136
|
-
# @param GroupId: 人员库 ID,取值为创建人员库接口中的GroupId
|
|
2169
|
+
# @param GroupId: 人员库 ID,取值为创建人员库接口中的GroupId。
|
|
2137
2170
|
# @type GroupId: String
|
|
2138
2171
|
|
|
2139
2172
|
attr_accessor :GroupId
|
|
@@ -2149,13 +2182,13 @@ module TencentCloud
|
|
|
2149
2182
|
|
|
2150
2183
|
# GetGroupInfo返回参数结构体
|
|
2151
2184
|
class GetGroupInfoResponse < TencentCloud::Common::AbstractModel
|
|
2152
|
-
# @param GroupName:
|
|
2185
|
+
# @param GroupName: 人员库名称。
|
|
2153
2186
|
# @type GroupName: String
|
|
2154
|
-
# @param GroupId: 人员库ID
|
|
2187
|
+
# @param GroupId: 人员库ID。
|
|
2155
2188
|
# @type GroupId: String
|
|
2156
|
-
# @param GroupExDescriptions:
|
|
2189
|
+
# @param GroupExDescriptions: 人员库自定义描述字段。
|
|
2157
2190
|
# @type GroupExDescriptions: Array
|
|
2158
|
-
# @param Tag:
|
|
2191
|
+
# @param Tag: 人员库信息备注。
|
|
2159
2192
|
# @type Tag: String
|
|
2160
2193
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
|
2161
2194
|
# @type FaceModelVersion: String
|
|
@@ -2241,7 +2274,7 @@ module TencentCloud
|
|
|
2241
2274
|
|
|
2242
2275
|
# GetPersonBaseInfo请求参数结构体
|
|
2243
2276
|
class GetPersonBaseInfoRequest < TencentCloud::Common::AbstractModel
|
|
2244
|
-
# @param PersonId: 人员ID,创建人员接口中的PersonId
|
|
2277
|
+
# @param PersonId: 人员ID,创建人员接口中的PersonId。
|
|
2245
2278
|
# @type PersonId: String
|
|
2246
2279
|
|
|
2247
2280
|
attr_accessor :PersonId
|
|
@@ -2257,11 +2290,12 @@ module TencentCloud
|
|
|
2257
2290
|
|
|
2258
2291
|
# GetPersonBaseInfo返回参数结构体
|
|
2259
2292
|
class GetPersonBaseInfoResponse < TencentCloud::Common::AbstractModel
|
|
2260
|
-
# @param PersonName:
|
|
2293
|
+
# @param PersonName: 人员名称。
|
|
2261
2294
|
# @type PersonName: String
|
|
2262
|
-
# @param Gender:
|
|
2295
|
+
# @param Gender: 人员性别。
|
|
2296
|
+
# - 取值范围:0代表未填写,1代表男性,2代表女性。
|
|
2263
2297
|
# @type Gender: Integer
|
|
2264
|
-
# @param FaceIds: 包含的人脸 ID
|
|
2298
|
+
# @param FaceIds: 包含的人脸 ID 列表。
|
|
2265
2299
|
# @type FaceIds: Array
|
|
2266
2300
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
2267
2301
|
# @type RequestId: String
|
|
@@ -2285,11 +2319,11 @@ module TencentCloud
|
|
|
2285
2319
|
|
|
2286
2320
|
# GetPersonGroupInfo请求参数结构体
|
|
2287
2321
|
class GetPersonGroupInfoRequest < TencentCloud::Common::AbstractModel
|
|
2288
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
2322
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
2289
2323
|
# @type PersonId: String
|
|
2290
|
-
# @param Offset: 起始序号,默认值为0
|
|
2324
|
+
# @param Offset: 起始序号,默认值为0。
|
|
2291
2325
|
# @type Offset: Integer
|
|
2292
|
-
# @param Limit: 返回数量,默认值为10,最大值为100
|
|
2326
|
+
# @param Limit: 返回数量,默认值为10,最大值为100。
|
|
2293
2327
|
# @type Limit: Integer
|
|
2294
2328
|
|
|
2295
2329
|
attr_accessor :PersonId, :Offset, :Limit
|
|
@@ -2309,9 +2343,9 @@ module TencentCloud
|
|
|
2309
2343
|
|
|
2310
2344
|
# GetPersonGroupInfo返回参数结构体
|
|
2311
2345
|
class GetPersonGroupInfoResponse < TencentCloud::Common::AbstractModel
|
|
2312
|
-
# @param PersonGroupInfos:
|
|
2346
|
+
# @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表。
|
|
2313
2347
|
# @type PersonGroupInfos: Array
|
|
2314
|
-
# @param GroupNum:
|
|
2348
|
+
# @param GroupNum: 人员库总数量。
|
|
2315
2349
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
|
2316
2350
|
# @type GroupNum: Integer
|
|
2317
2351
|
# @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
|
@@ -2346,7 +2380,7 @@ module TencentCloud
|
|
|
2346
2380
|
|
|
2347
2381
|
# GetPersonListNum请求参数结构体
|
|
2348
2382
|
class GetPersonListNumRequest < TencentCloud::Common::AbstractModel
|
|
2349
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
2383
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
2350
2384
|
# @type GroupId: String
|
|
2351
2385
|
|
|
2352
2386
|
attr_accessor :GroupId
|
|
@@ -2362,9 +2396,9 @@ module TencentCloud
|
|
|
2362
2396
|
|
|
2363
2397
|
# GetPersonListNum返回参数结构体
|
|
2364
2398
|
class GetPersonListNumResponse < TencentCloud::Common::AbstractModel
|
|
2365
|
-
# @param PersonNum:
|
|
2399
|
+
# @param PersonNum: 人员数量。
|
|
2366
2400
|
# @type PersonNum: Integer
|
|
2367
|
-
# @param FaceNum:
|
|
2401
|
+
# @param FaceNum: 人脸数量。
|
|
2368
2402
|
# @type FaceNum: Integer
|
|
2369
2403
|
# @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
|
2370
2404
|
# @type RequestId: String
|
|
@@ -2386,11 +2420,11 @@ module TencentCloud
|
|
|
2386
2420
|
|
|
2387
2421
|
# GetPersonList请求参数结构体
|
|
2388
2422
|
class GetPersonListRequest < TencentCloud::Common::AbstractModel
|
|
2389
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
2423
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
2390
2424
|
# @type GroupId: String
|
|
2391
|
-
# @param Offset: 起始序号,默认值为0
|
|
2425
|
+
# @param Offset: 起始序号,默认值为0。
|
|
2392
2426
|
# @type Offset: Integer
|
|
2393
|
-
# @param Limit: 返回数量,默认值为10,最大值为1000
|
|
2427
|
+
# @param Limit: 返回数量,默认值为10,最大值为1000。
|
|
2394
2428
|
# @type Limit: Integer
|
|
2395
2429
|
|
|
2396
2430
|
attr_accessor :GroupId, :Offset, :Limit
|
|
@@ -2410,12 +2444,12 @@ module TencentCloud
|
|
|
2410
2444
|
|
|
2411
2445
|
# GetPersonList返回参数结构体
|
|
2412
2446
|
class GetPersonListResponse < TencentCloud::Common::AbstractModel
|
|
2413
|
-
# @param PersonInfos:
|
|
2447
|
+
# @param PersonInfos: 返回的人员信息。
|
|
2414
2448
|
# @type PersonInfos: Array
|
|
2415
|
-
# @param PersonNum:
|
|
2449
|
+
# @param PersonNum: 该人员库的人员数量。
|
|
2416
2450
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
|
2417
2451
|
# @type PersonNum: Integer
|
|
2418
|
-
# @param FaceNum:
|
|
2452
|
+
# @param FaceNum: 该人员库的人脸数量。
|
|
2419
2453
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
|
2420
2454
|
# @type FaceNum: Integer
|
|
2421
2455
|
# @param FaceModelVersion: 人脸识别所用的算法模型版本。
|
|
@@ -2750,13 +2784,13 @@ module TencentCloud
|
|
|
2750
2784
|
|
|
2751
2785
|
# ModifyGroup请求参数结构体
|
|
2752
2786
|
class ModifyGroupRequest < TencentCloud::Common::AbstractModel
|
|
2753
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
2787
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
2754
2788
|
# @type GroupId: String
|
|
2755
|
-
# @param GroupName:
|
|
2789
|
+
# @param GroupName: 人员库名称。
|
|
2756
2790
|
# @type GroupName: String
|
|
2757
|
-
# @param GroupExDescriptionInfos: 需要修改的人员库自定义描述字段,key-value
|
|
2791
|
+
# @param GroupExDescriptionInfos: 需要修改的人员库自定义描述字段,key-value。
|
|
2758
2792
|
# @type GroupExDescriptionInfos: Array
|
|
2759
|
-
# @param Tag:
|
|
2793
|
+
# @param Tag: 人员库信息备注。
|
|
2760
2794
|
# @type Tag: String
|
|
2761
2795
|
|
|
2762
2796
|
attr_accessor :GroupId, :GroupName, :GroupExDescriptionInfos, :Tag
|
|
@@ -2801,11 +2835,11 @@ module TencentCloud
|
|
|
2801
2835
|
|
|
2802
2836
|
# ModifyPersonBaseInfo请求参数结构体
|
|
2803
2837
|
class ModifyPersonBaseInfoRequest < TencentCloud::Common::AbstractModel
|
|
2804
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
2838
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
2805
2839
|
# @type PersonId: String
|
|
2806
|
-
# @param PersonName:
|
|
2840
|
+
# @param PersonName: 需要修改的人员名称。
|
|
2807
2841
|
# @type PersonName: String
|
|
2808
|
-
# @param Gender: 需要修改的人员性别,1代表男性,2
|
|
2842
|
+
# @param Gender: 需要修改的人员性别,1代表男性,2代表女性。
|
|
2809
2843
|
# @type Gender: Integer
|
|
2810
2844
|
|
|
2811
2845
|
attr_accessor :PersonId, :PersonName, :Gender
|
|
@@ -2841,11 +2875,11 @@ module TencentCloud
|
|
|
2841
2875
|
|
|
2842
2876
|
# ModifyPersonGroupInfo请求参数结构体
|
|
2843
2877
|
class ModifyPersonGroupInfoRequest < TencentCloud::Common::AbstractModel
|
|
2844
|
-
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
|
2878
|
+
# @param GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
|
2845
2879
|
# @type GroupId: String
|
|
2846
|
-
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId
|
|
2880
|
+
# @param PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
|
2847
2881
|
# @type PersonId: String
|
|
2848
|
-
# @param PersonExDescriptionInfos: 需要修改的人员描述字段内容,key-value
|
|
2882
|
+
# @param PersonExDescriptionInfos: 需要修改的人员描述字段内容,key-value。
|
|
2849
2883
|
# @type PersonExDescriptionInfos: Array
|
|
2850
2884
|
|
|
2851
2885
|
attr_accessor :GroupId, :PersonId, :PersonExDescriptionInfos
|
|
@@ -3111,44 +3145,63 @@ module TencentCloud
|
|
|
3111
3145
|
|
|
3112
3146
|
# SearchFaces请求参数结构体
|
|
3113
3147
|
class SearchFacesRequest < TencentCloud::Common::AbstractModel
|
|
3114
|
-
# @param GroupIds: 希望搜索的人员库列表,上限100
|
|
3115
|
-
#
|
|
3148
|
+
# @param GroupIds: 希望搜索的人员库列表,上限100个。
|
|
3149
|
+
# - 数组元素取值为创建人员库接口中的GroupId。
|
|
3150
|
+
# - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
3116
3151
|
# @type GroupIds: Array
|
|
3117
|
-
# @param Image: 图片 base64
|
|
3118
|
-
#
|
|
3119
|
-
#
|
|
3152
|
+
# @param Image: 图片 base64 数据。
|
|
3153
|
+
# - base64 编码后大小不可超过5M。
|
|
3154
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3155
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3156
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3120
3157
|
# @type Image: String
|
|
3121
|
-
# @param Url: 图片的 Url
|
|
3122
|
-
#
|
|
3123
|
-
#
|
|
3124
|
-
#
|
|
3125
|
-
#
|
|
3126
|
-
#
|
|
3158
|
+
# @param Url: 图片的 Url 。
|
|
3159
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
3160
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3161
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3162
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3163
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
3164
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
3165
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3127
3166
|
# @type Url: String
|
|
3128
|
-
# @param MaxFaceNum:
|
|
3129
|
-
#
|
|
3130
|
-
#
|
|
3167
|
+
# @param MaxFaceNum: 最多识别的人脸数目。
|
|
3168
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
3169
|
+
# - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
3170
|
+
# - 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
3131
3171
|
# @type MaxFaceNum: Integer
|
|
3132
|
-
# @param MinFaceSize:
|
|
3172
|
+
# @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
|
3173
|
+
# - 默认为34。
|
|
3174
|
+
# - 低于34的人脸图片无法被识别。
|
|
3175
|
+
# - 建议设置为80。
|
|
3133
3176
|
# @type MinFaceSize: Integer
|
|
3134
|
-
# @param MaxPersonNum:
|
|
3135
|
-
#
|
|
3136
|
-
#
|
|
3177
|
+
# @param MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
|
|
3178
|
+
# - 默认值为5,最大值为100。
|
|
3179
|
+
# - 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
3180
|
+
# - 值越大,需要处理的时间越长。
|
|
3181
|
+
# - 建议不要超过10。
|
|
3137
3182
|
# @type MaxPersonNum: Integer
|
|
3138
|
-
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3183
|
+
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3184
|
+
# - 取值范围:0 为关闭,1 为开启。
|
|
3185
|
+
# - 默认为 0。
|
|
3186
|
+
# - 其他非0非1值默认为0。
|
|
3139
3187
|
# @type NeedPersonInfo: Integer
|
|
3140
3188
|
# @param QualityControl: 图片质量控制。
|
|
3141
|
-
#
|
|
3142
|
-
#
|
|
3143
|
-
#
|
|
3144
|
-
#
|
|
3145
|
-
#
|
|
3146
|
-
#
|
|
3147
|
-
#
|
|
3189
|
+
# - 取值范围:
|
|
3190
|
+
# 0: 不进行控制。
|
|
3191
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
3192
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
3193
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
3194
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
3195
|
+
# - 默认 0。
|
|
3196
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
3148
3197
|
# @type QualityControl: Integer
|
|
3149
3198
|
# @param FaceMatchThreshold: 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
3150
3199
|
# @type FaceMatchThreshold: Float
|
|
3151
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3200
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3201
|
+
# - 取值范围:0为不开启,1为开启。
|
|
3202
|
+
# - 默认为0。
|
|
3203
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
3204
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
3152
3205
|
# @type NeedRotateDetection: Integer
|
|
3153
3206
|
|
|
3154
3207
|
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNum, :NeedPersonInfo, :QualityControl, :FaceMatchThreshold, :NeedRotateDetection
|
|
@@ -3217,45 +3270,63 @@ module TencentCloud
|
|
|
3217
3270
|
|
|
3218
3271
|
# SearchFacesReturnsByGroup请求参数结构体
|
|
3219
3272
|
class SearchFacesReturnsByGroupRequest < TencentCloud::Common::AbstractModel
|
|
3220
|
-
# @param GroupIds: 希望搜索的人员库列表,上限60
|
|
3221
|
-
#
|
|
3273
|
+
# @param GroupIds: 希望搜索的人员库列表,上限60个。
|
|
3274
|
+
# - 数组元素取值为创建人员库接口中的GroupId。
|
|
3275
|
+
# - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
|
3222
3276
|
# @type GroupIds: Array
|
|
3223
|
-
# @param Image: 图片 base64
|
|
3224
|
-
#
|
|
3225
|
-
#
|
|
3277
|
+
# @param Image: 图片 base64 数据。
|
|
3278
|
+
# - base64 编码后大小不可超过5M。
|
|
3279
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3280
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3281
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3226
3282
|
# @type Image: String
|
|
3227
|
-
# @param Url: 图片的 Url
|
|
3228
|
-
#
|
|
3229
|
-
#
|
|
3230
|
-
#
|
|
3231
|
-
#
|
|
3232
|
-
#
|
|
3283
|
+
# @param Url: 图片的 Url 。
|
|
3284
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
3285
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3286
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3287
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3288
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
3289
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
3290
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3233
3291
|
# @type Url: String
|
|
3234
|
-
# @param MaxFaceNum:
|
|
3235
|
-
#
|
|
3236
|
-
#
|
|
3292
|
+
# @param MaxFaceNum: 最多识别的人脸数目。
|
|
3293
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
3294
|
+
# - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
3295
|
+
# - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
3237
3296
|
# @type MaxFaceNum: Integer
|
|
3238
|
-
# @param MinFaceSize:
|
|
3297
|
+
# @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
|
3298
|
+
# - 默认为34。
|
|
3299
|
+
# - 低于34将影响搜索精度。
|
|
3300
|
+
# - 建议设置为80。
|
|
3239
3301
|
# @type MinFaceSize: Integer
|
|
3240
|
-
# @param MaxPersonNumPerGroup:
|
|
3241
|
-
#
|
|
3302
|
+
# @param MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。
|
|
3303
|
+
# - 默认值为5,最大值为10。
|
|
3304
|
+
# - 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
3242
3305
|
# @type MaxPersonNumPerGroup: Integer
|
|
3243
|
-
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3306
|
+
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3307
|
+
# - 取值范围:0 为关闭,1 为开启。
|
|
3308
|
+
# - 默认为 0。
|
|
3309
|
+
# - 其他非0非1值默认为0
|
|
3244
3310
|
# @type NeedPersonInfo: Integer
|
|
3245
3311
|
# @param QualityControl: 图片质量控制。
|
|
3246
|
-
#
|
|
3247
|
-
#
|
|
3248
|
-
#
|
|
3249
|
-
#
|
|
3250
|
-
#
|
|
3251
|
-
#
|
|
3252
|
-
#
|
|
3312
|
+
# - 取值范围:
|
|
3313
|
+
# 0: 不进行控制。
|
|
3314
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
3315
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
3316
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
3317
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
3318
|
+
# - 默认 0。
|
|
3319
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
3253
3320
|
# @type QualityControl: Integer
|
|
3254
3321
|
# @param FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
|
3255
|
-
# 默认为0。
|
|
3256
|
-
#
|
|
3322
|
+
# - 默认为0。
|
|
3323
|
+
# - 取值范围:[0.0,100.0) 。
|
|
3257
3324
|
# @type FaceMatchThreshold: Float
|
|
3258
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3325
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3326
|
+
# - 取值范围:0为不开启,1为开启。
|
|
3327
|
+
# - 默认为0。
|
|
3328
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
3329
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
3259
3330
|
# @type NeedRotateDetection: Integer
|
|
3260
3331
|
|
|
3261
3332
|
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNumPerGroup, :NeedPersonInfo, :QualityControl, :FaceMatchThreshold, :NeedRotateDetection
|
|
@@ -3324,44 +3395,63 @@ module TencentCloud
|
|
|
3324
3395
|
|
|
3325
3396
|
# SearchPersons请求参数结构体
|
|
3326
3397
|
class SearchPersonsRequest < TencentCloud::Common::AbstractModel
|
|
3327
|
-
# @param GroupIds: 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId
|
|
3398
|
+
# @param GroupIds: 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
|
|
3328
3399
|
# @type GroupIds: Array
|
|
3329
|
-
# @param Image: 图片 base64
|
|
3330
|
-
#
|
|
3331
|
-
#
|
|
3332
|
-
#
|
|
3400
|
+
# @param Image: 图片 base64 数据。
|
|
3401
|
+
# - base64 编码后大小不可超过5M。
|
|
3402
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3403
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3404
|
+
# - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
|
3405
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3333
3406
|
# @type Image: String
|
|
3334
|
-
# @param Url: 图片的 Url
|
|
3335
|
-
#
|
|
3336
|
-
#
|
|
3337
|
-
#
|
|
3338
|
-
#
|
|
3339
|
-
#
|
|
3407
|
+
# @param Url: 图片的 Url 。
|
|
3408
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
3409
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3410
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3411
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3412
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
3413
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
3414
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3340
3415
|
# @type Url: String
|
|
3341
|
-
# @param MaxFaceNum:
|
|
3342
|
-
#
|
|
3343
|
-
#
|
|
3416
|
+
# @param MaxFaceNum: 最多识别的人脸数目。
|
|
3417
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
3418
|
+
# - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
3419
|
+
# - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
3344
3420
|
# @type MaxFaceNum: Integer
|
|
3345
|
-
# @param MinFaceSize:
|
|
3421
|
+
# @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
|
3422
|
+
# - 默认为34。
|
|
3423
|
+
# - 低于34将影响搜索精度。
|
|
3424
|
+
# - 建议设置为80。
|
|
3346
3425
|
# @type MinFaceSize: Integer
|
|
3347
|
-
# @param MaxPersonNum:
|
|
3348
|
-
#
|
|
3349
|
-
#
|
|
3426
|
+
# @param MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
|
|
3427
|
+
# - 默认值为5,最大值为100。
|
|
3428
|
+
# - 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
|
3429
|
+
# - 值越大,需要处理的时间越长。建议不要超过10。
|
|
3350
3430
|
# @type MaxPersonNum: Integer
|
|
3351
3431
|
# @param QualityControl: 图片质量控制。
|
|
3352
|
-
#
|
|
3353
|
-
#
|
|
3354
|
-
#
|
|
3355
|
-
#
|
|
3356
|
-
#
|
|
3357
|
-
#
|
|
3358
|
-
#
|
|
3432
|
+
# - 取值范围:
|
|
3433
|
+
# 0: 不进行控制。
|
|
3434
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
3435
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
3436
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
3437
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
3438
|
+
# - 默认 0。
|
|
3439
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
3359
3440
|
# @type QualityControl: Integer
|
|
3360
|
-
# @param FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold
|
|
3441
|
+
# @param FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
|
3442
|
+
# - 默认为0。
|
|
3443
|
+
# - 取值范围:[0.0,100.0) 。
|
|
3361
3444
|
# @type FaceMatchThreshold: Float
|
|
3362
|
-
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3445
|
+
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3446
|
+
# - 取值范围:0 为关闭,1 为开启。
|
|
3447
|
+
# - 默认为 0。
|
|
3448
|
+
# - 其他非0非1值默认为0
|
|
3363
3449
|
# @type NeedPersonInfo: Integer
|
|
3364
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3450
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3451
|
+
# - 取值范围:0为不开启,1为开启。
|
|
3452
|
+
# - 默认为0。
|
|
3453
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
3454
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
3365
3455
|
# @type NeedRotateDetection: Integer
|
|
3366
3456
|
|
|
3367
3457
|
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNum, :QualityControl, :FaceMatchThreshold, :NeedPersonInfo, :NeedRotateDetection
|
|
@@ -3431,42 +3521,59 @@ module TencentCloud
|
|
|
3431
3521
|
|
|
3432
3522
|
# SearchPersonsReturnsByGroup请求参数结构体
|
|
3433
3523
|
class SearchPersonsReturnsByGroupRequest < TencentCloud::Common::AbstractModel
|
|
3434
|
-
# @param GroupIds: 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId
|
|
3524
|
+
# @param GroupIds: 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
|
|
3435
3525
|
# @type GroupIds: Array
|
|
3436
|
-
# @param Image: 图片 base64
|
|
3437
|
-
#
|
|
3438
|
-
#
|
|
3526
|
+
# @param Image: 图片 base64 数据。
|
|
3527
|
+
# - base64 编码后大小不可超过5M。
|
|
3528
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3529
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3530
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3439
3531
|
# @type Image: String
|
|
3440
|
-
# @param Url: 图片的 Url
|
|
3441
|
-
#
|
|
3442
|
-
#
|
|
3443
|
-
#
|
|
3444
|
-
#
|
|
3445
|
-
#
|
|
3532
|
+
# @param Url: 图片的 Url 。
|
|
3533
|
+
# - 对应图片 base64 编码后大小不可超过5M。
|
|
3534
|
+
# - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
|
3535
|
+
# - 所有格式的图片短边像素不小于64。
|
|
3536
|
+
# - Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3537
|
+
# - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
|
3538
|
+
# - 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
|
3539
|
+
# - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
|
3446
3540
|
# @type Url: String
|
|
3447
|
-
# @param MaxFaceNum:
|
|
3448
|
-
#
|
|
3449
|
-
#
|
|
3541
|
+
# @param MaxFaceNum: 最多识别的人脸数目。
|
|
3542
|
+
# - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
|
3543
|
+
# - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
|
3544
|
+
# - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
|
3450
3545
|
# @type MaxFaceNum: Integer
|
|
3451
|
-
# @param MinFaceSize:
|
|
3546
|
+
# @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
|
3547
|
+
# - 默认为34。
|
|
3548
|
+
# - 低于34将影响搜索精度。
|
|
3549
|
+
# - 建议设置为80。
|
|
3452
3550
|
# @type MinFaceSize: Integer
|
|
3453
|
-
# @param MaxPersonNumPerGroup:
|
|
3454
|
-
#
|
|
3551
|
+
# @param MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。
|
|
3552
|
+
# - 默认值为5,最大值为10。
|
|
3553
|
+
# - 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
|
3455
3554
|
# @type MaxPersonNumPerGroup: Integer
|
|
3456
3555
|
# @param QualityControl: 图片质量控制。
|
|
3457
|
-
#
|
|
3458
|
-
#
|
|
3459
|
-
#
|
|
3460
|
-
#
|
|
3461
|
-
#
|
|
3462
|
-
#
|
|
3463
|
-
#
|
|
3556
|
+
# - 取值范围:
|
|
3557
|
+
# 0: 不进行控制。
|
|
3558
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
|
3559
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
|
3560
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
|
3561
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
|
3562
|
+
# - 默认 0。
|
|
3563
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
|
3464
3564
|
# @type QualityControl: Integer
|
|
3465
3565
|
# @param FaceMatchThreshold: 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
|
3466
3566
|
# @type FaceMatchThreshold: Float
|
|
3467
|
-
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3567
|
+
# @param NeedPersonInfo: 是否返回人员具体信息。
|
|
3568
|
+
# - 取值范围:0 为关闭,1 为开启。
|
|
3569
|
+
# - 默认为 0。
|
|
3570
|
+
# - 其他非0非1值默认为0。
|
|
3468
3571
|
# @type NeedPersonInfo: Integer
|
|
3469
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3572
|
+
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
|
3573
|
+
# - 取值范围:0为不开启,1为开启。
|
|
3574
|
+
# - 默认为0。
|
|
3575
|
+
# - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
|
3576
|
+
# - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
|
3470
3577
|
# @type NeedRotateDetection: Integer
|
|
3471
3578
|
|
|
3472
3579
|
attr_accessor :GroupIds, :Image, :Url, :MaxFaceNum, :MinFaceSize, :MaxPersonNumPerGroup, :QualityControl, :FaceMatchThreshold, :NeedPersonInfo, :NeedRotateDetection
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: tencentcloud-sdk-iai
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 3.0.
|
|
4
|
+
version: 3.0.942
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Tencent Cloud
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2024-11-
|
|
11
|
+
date: 2024-11-15 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: tencentcloud-sdk-common
|