tencentcloud-sdk-python 3.0.1263__py2.py3-none-any.whl → 3.0.1264__py2.py3-none-any.whl
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.
- tencentcloud/__init__.py +1 -1
- tencentcloud/ccc/v20200210/models.py +148 -236
- tencentcloud/cdb/v20170320/cdb_client.py +40 -17
- tencentcloud/cdb/v20170320/models.py +215 -68
- tencentcloud/cdc/v20201214/models.py +4 -4
- tencentcloud/cls/v20201016/models.py +104 -2
- tencentcloud/cwp/v20180228/cwp_client.py +0 -25
- tencentcloud/cwp/v20180228/models.py +352 -1771
- tencentcloud/dasb/v20191018/models.py +0 -8
- tencentcloud/emr/v20190103/models.py +58 -2
- tencentcloud/ess/v20201111/models.py +2 -2
- tencentcloud/essbasic/v20210526/models.py +2 -2
- tencentcloud/hai/v20230812/errorcodes.py +18 -0
- tencentcloud/hai/v20230812/models.py +229 -4
- tencentcloud/hunyuan/v20230901/errorcodes.py +2 -2
- tencentcloud/hunyuan/v20230901/hunyuan_client.py +1 -1
- tencentcloud/hunyuan/v20230901/models.py +19 -4
- tencentcloud/iai/v20180301/models.py +4 -4
- tencentcloud/iai/v20200303/models.py +728 -528
- tencentcloud/iss/v20230517/errorcodes.py +0 -9
- tencentcloud/iss/v20230517/iss_client.py +0 -23
- tencentcloud/iss/v20230517/models.py +0 -94
- tencentcloud/redis/v20180412/models.py +6 -10
- tencentcloud/redis/v20180412/redis_client.py +1 -1
- tencentcloud/ssl/v20191205/models.py +148 -0
- tencentcloud/vpc/v20170312/errorcodes.py +3 -0
- tencentcloud/vpc/v20170312/models.py +79 -0
- tencentcloud/vpc/v20170312/vpc_client.py +23 -0
- tencentcloud/wedata/v20210820/errorcodes.py +9 -0
- tencentcloud/wedata/v20210820/models.py +447 -0
- tencentcloud/wedata/v20210820/wedata_client.py +69 -0
- {tencentcloud_sdk_python-3.0.1263.dist-info → tencentcloud_sdk_python-3.0.1264.dist-info}/METADATA +1 -1
- {tencentcloud_sdk_python-3.0.1263.dist-info → tencentcloud_sdk_python-3.0.1264.dist-info}/RECORD +36 -36
- {tencentcloud_sdk_python-3.0.1263.dist-info → tencentcloud_sdk_python-3.0.1264.dist-info}/LICENSE +0 -0
- {tencentcloud_sdk_python-3.0.1263.dist-info → tencentcloud_sdk_python-3.0.1264.dist-info}/WHEEL +0 -0
- {tencentcloud_sdk_python-3.0.1263.dist-info → tencentcloud_sdk_python-3.0.1264.dist-info}/top_level.txt +0 -0
@@ -25,24 +25,31 @@ class AnalyzeDenseLandmarksRequest(AbstractModel):
|
|
25
25
|
|
26
26
|
def __init__(self):
|
27
27
|
r"""
|
28
|
-
:param _Mode: 检测模式。
|
29
|
-
|
30
|
-
|
28
|
+
:param _Mode: 检测模式。
|
29
|
+
- 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
30
|
+
- 默认为 0。
|
31
|
+
- 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
31
32
|
:type Mode: int
|
32
|
-
:param _Image: 图片 base64
|
33
|
-
|
34
|
-
|
33
|
+
:param _Image: 图片 base64 数据。
|
34
|
+
- base64 编码后大小不可超过5M。
|
35
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
36
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
35
37
|
:type Image: str
|
36
|
-
:param _Url: 图片的 Url
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
38
|
+
:param _Url: 图片的 Url 。
|
39
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
40
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
41
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
42
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
43
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
44
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
42
45
|
:type Url: str
|
43
46
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
|
44
47
|
:type FaceModelVersion: str
|
45
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
48
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
49
|
+
- 取值范围:0为不开启,1为开启。
|
50
|
+
- 默认为0。
|
51
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
52
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
46
53
|
:type NeedRotateDetection: int
|
47
54
|
"""
|
48
55
|
self._Mode = None
|
@@ -53,9 +60,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
53
60
|
|
54
61
|
@property
|
55
62
|
def Mode(self):
|
56
|
-
"""检测模式。
|
57
|
-
|
58
|
-
|
63
|
+
"""检测模式。
|
64
|
+
- 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
65
|
+
- 默认为 0。
|
66
|
+
- 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
59
67
|
:rtype: int
|
60
68
|
"""
|
61
69
|
return self._Mode
|
@@ -66,9 +74,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
66
74
|
|
67
75
|
@property
|
68
76
|
def Image(self):
|
69
|
-
"""图片 base64
|
70
|
-
|
71
|
-
|
77
|
+
"""图片 base64 数据。
|
78
|
+
- base64 编码后大小不可超过5M。
|
79
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
80
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
72
81
|
:rtype: str
|
73
82
|
"""
|
74
83
|
return self._Image
|
@@ -79,12 +88,13 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
79
88
|
|
80
89
|
@property
|
81
90
|
def Url(self):
|
82
|
-
"""图片的 Url
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
91
|
+
"""图片的 Url 。
|
92
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
93
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
94
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
95
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
96
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
97
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
88
98
|
:rtype: str
|
89
99
|
"""
|
90
100
|
return self._Url
|
@@ -106,7 +116,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
106
116
|
|
107
117
|
@property
|
108
118
|
def NeedRotateDetection(self):
|
109
|
-
"""是否开启图片旋转识别支持。
|
119
|
+
"""是否开启图片旋转识别支持。
|
120
|
+
- 取值范围:0为不开启,1为开启。
|
121
|
+
- 默认为0。
|
122
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
123
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
110
124
|
:rtype: int
|
111
125
|
"""
|
112
126
|
return self._NeedRotateDetection
|
@@ -232,30 +246,37 @@ class AnalyzeFaceRequest(AbstractModel):
|
|
232
246
|
|
233
247
|
def __init__(self):
|
234
248
|
r"""
|
235
|
-
:param _Mode: 检测模式。
|
249
|
+
:param _Mode: 检测模式。
|
250
|
+
- 取值范围:
|
251
|
+
0 为检测所有出现的人脸。
|
252
|
+
1 为检测面积最大的人脸。
|
253
|
+
- 默认为 0。
|
254
|
+
- 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
236
255
|
:type Mode: int
|
237
|
-
:param _Image: 图片 base64
|
238
|
-
|
239
|
-
|
256
|
+
:param _Image: 图片 base64 数据。
|
257
|
+
- base64 编码后大小不可超过5M。
|
258
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
259
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
240
260
|
:type Image: str
|
241
|
-
:param _Url: 图片的 Url
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
261
|
+
:param _Url: 图片的 Url 。
|
262
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
263
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
264
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
265
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
266
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
267
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
247
268
|
:type Url: str
|
248
269
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
249
|
-
|
250
|
-
|
251
|
-
|
252
|
-
|
253
|
-
|
254
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
255
|
-
|
256
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
270
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
271
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
272
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
273
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
257
274
|
:type FaceModelVersion: str
|
258
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
275
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
276
|
+
- 0为不开启,1为开启。
|
277
|
+
- 默认为0。
|
278
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
279
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
259
280
|
:type NeedRotateDetection: int
|
260
281
|
"""
|
261
282
|
self._Mode = None
|
@@ -266,7 +287,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
266
287
|
|
267
288
|
@property
|
268
289
|
def Mode(self):
|
269
|
-
"""检测模式。
|
290
|
+
"""检测模式。
|
291
|
+
- 取值范围:
|
292
|
+
0 为检测所有出现的人脸。
|
293
|
+
1 为检测面积最大的人脸。
|
294
|
+
- 默认为 0。
|
295
|
+
- 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
270
296
|
:rtype: int
|
271
297
|
"""
|
272
298
|
return self._Mode
|
@@ -277,9 +303,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
277
303
|
|
278
304
|
@property
|
279
305
|
def Image(self):
|
280
|
-
"""图片 base64
|
281
|
-
|
282
|
-
|
306
|
+
"""图片 base64 数据。
|
307
|
+
- base64 编码后大小不可超过5M。
|
308
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
309
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
283
310
|
:rtype: str
|
284
311
|
"""
|
285
312
|
return self._Image
|
@@ -290,12 +317,13 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
290
317
|
|
291
318
|
@property
|
292
319
|
def Url(self):
|
293
|
-
"""图片的 Url
|
294
|
-
|
295
|
-
|
296
|
-
|
297
|
-
|
298
|
-
|
320
|
+
"""图片的 Url 。
|
321
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
322
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
323
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
324
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
325
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
326
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
299
327
|
:rtype: str
|
300
328
|
"""
|
301
329
|
return self._Url
|
@@ -307,14 +335,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
307
335
|
@property
|
308
336
|
def FaceModelVersion(self):
|
309
337
|
"""人脸识别服务所用的算法模型版本。
|
310
|
-
|
311
|
-
|
312
|
-
|
313
|
-
|
314
|
-
|
315
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
316
|
-
|
317
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
338
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
339
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
340
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
341
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
318
342
|
:rtype: str
|
319
343
|
"""
|
320
344
|
return self._FaceModelVersion
|
@@ -325,7 +349,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
325
349
|
|
326
350
|
@property
|
327
351
|
def NeedRotateDetection(self):
|
328
|
-
"""是否开启图片旋转识别支持。
|
352
|
+
"""是否开启图片旋转识别支持。
|
353
|
+
- 0为不开启,1为开启。
|
354
|
+
- 默认为0。
|
355
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
356
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
329
357
|
:rtype: int
|
330
358
|
"""
|
331
359
|
return self._NeedRotateDetection
|
@@ -451,9 +479,10 @@ class AttributeItem(AbstractModel):
|
|
451
479
|
|
452
480
|
def __init__(self):
|
453
481
|
r"""
|
454
|
-
:param _Type:
|
482
|
+
:param _Type: 属性值。
|
455
483
|
:type Type: int
|
456
|
-
:param _Probability: Type
|
484
|
+
:param _Probability: Type识别概率值。
|
485
|
+
- 取值范围:[0,1],代表判断正确的概率。
|
457
486
|
:type Probability: float
|
458
487
|
"""
|
459
488
|
self._Type = None
|
@@ -461,7 +490,7 @@ class AttributeItem(AbstractModel):
|
|
461
490
|
|
462
491
|
@property
|
463
492
|
def Type(self):
|
464
|
-
"""
|
493
|
+
"""属性值。
|
465
494
|
:rtype: int
|
466
495
|
"""
|
467
496
|
return self._Type
|
@@ -472,7 +501,8 @@ class AttributeItem(AbstractModel):
|
|
472
501
|
|
473
502
|
@property
|
474
503
|
def Probability(self):
|
475
|
-
"""Type
|
504
|
+
"""Type识别概率值。
|
505
|
+
- 取值范围:[0,1],代表判断正确的概率。
|
476
506
|
:rtype: float
|
477
507
|
"""
|
478
508
|
return self._Probability
|
@@ -502,25 +532,25 @@ class Candidate(AbstractModel):
|
|
502
532
|
|
503
533
|
def __init__(self):
|
504
534
|
r"""
|
505
|
-
:param _PersonId: 人员ID
|
535
|
+
:param _PersonId: 人员ID。
|
506
536
|
:type PersonId: str
|
507
|
-
:param _FaceId: 人脸ID
|
537
|
+
:param _FaceId: 人脸ID。
|
538
|
+
- 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
|
539
|
+
- 人员搜索类接口采用融合特征方式检索,该字段无意义。
|
508
540
|
:type FaceId: str
|
509
541
|
:param _Score: 候选者的匹配得分。
|
510
|
-
|
511
|
-
|
512
|
-
|
513
|
-
|
514
|
-
|
515
|
-
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
542
|
+
- 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分。
|
543
|
+
- 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分。
|
544
|
+
- 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
545
|
+
- 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
516
546
|
:type Score: float
|
517
|
-
:param _PersonName:
|
547
|
+
:param _PersonName: 人员名称。
|
518
548
|
注意:此字段可能返回 null,表示取不到有效值。
|
519
549
|
:type PersonName: str
|
520
|
-
:param _Gender:
|
550
|
+
:param _Gender: 人员性别。
|
521
551
|
注意:此字段可能返回 null,表示取不到有效值。
|
522
552
|
:type Gender: int
|
523
|
-
:param _PersonGroupInfos:
|
553
|
+
:param _PersonGroupInfos: 包含此人员的人员库及描述字段内容列表。
|
524
554
|
注意:此字段可能返回 null,表示取不到有效值。
|
525
555
|
:type PersonGroupInfos: list of PersonGroupInfo
|
526
556
|
"""
|
@@ -533,7 +563,7 @@ class Candidate(AbstractModel):
|
|
533
563
|
|
534
564
|
@property
|
535
565
|
def PersonId(self):
|
536
|
-
"""人员ID
|
566
|
+
"""人员ID。
|
537
567
|
:rtype: str
|
538
568
|
"""
|
539
569
|
return self._PersonId
|
@@ -544,7 +574,9 @@ class Candidate(AbstractModel):
|
|
544
574
|
|
545
575
|
@property
|
546
576
|
def FaceId(self):
|
547
|
-
"""人脸ID
|
577
|
+
"""人脸ID。
|
578
|
+
- 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
|
579
|
+
- 人员搜索类接口采用融合特征方式检索,该字段无意义。
|
548
580
|
:rtype: str
|
549
581
|
"""
|
550
582
|
return self._FaceId
|
@@ -556,12 +588,10 @@ class Candidate(AbstractModel):
|
|
556
588
|
@property
|
557
589
|
def Score(self):
|
558
590
|
"""候选者的匹配得分。
|
559
|
-
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
564
|
-
一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
591
|
+
- 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分。
|
592
|
+
- 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分。
|
593
|
+
- 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
|
594
|
+
- 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
|
565
595
|
:rtype: float
|
566
596
|
"""
|
567
597
|
return self._Score
|
@@ -572,7 +602,7 @@ class Candidate(AbstractModel):
|
|
572
602
|
|
573
603
|
@property
|
574
604
|
def PersonName(self):
|
575
|
-
"""
|
605
|
+
"""人员名称。
|
576
606
|
注意:此字段可能返回 null,表示取不到有效值。
|
577
607
|
:rtype: str
|
578
608
|
"""
|
@@ -584,7 +614,7 @@ class Candidate(AbstractModel):
|
|
584
614
|
|
585
615
|
@property
|
586
616
|
def Gender(self):
|
587
|
-
"""
|
617
|
+
"""人员性别。
|
588
618
|
注意:此字段可能返回 null,表示取不到有效值。
|
589
619
|
:rtype: int
|
590
620
|
"""
|
@@ -596,7 +626,7 @@ class Candidate(AbstractModel):
|
|
596
626
|
|
597
627
|
@property
|
598
628
|
def PersonGroupInfos(self):
|
599
|
-
"""
|
629
|
+
"""包含此人员的人员库及描述字段内容列表。
|
600
630
|
注意:此字段可能返回 null,表示取不到有效值。
|
601
631
|
:rtype: list of PersonGroupInfo
|
602
632
|
"""
|
@@ -2663,30 +2693,36 @@ class DetectFaceAttributesRequest(AbstractModel):
|
|
2663
2693
|
def __init__(self):
|
2664
2694
|
r"""
|
2665
2695
|
:param _MaxFaceNum: 最多处理的人脸数目。
|
2666
|
-
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
2667
|
-
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2696
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
2697
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2668
2698
|
:type MaxFaceNum: int
|
2669
|
-
:param _Image: 图片 base64
|
2670
|
-
|
2671
|
-
|
2699
|
+
:param _Image: 图片 base64 数据。
|
2700
|
+
- base64 编码后大小不可超过5M。
|
2701
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
2702
|
+
- 所有格式的图片短边像素不小于64。
|
2703
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2672
2704
|
:type Image: str
|
2673
2705
|
:param _Url: 图片的 Url 。
|
2674
|
-
对应图片 base64 编码后大小不可超过5M。
|
2675
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
2676
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
2677
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
2678
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
2679
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2706
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
2707
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
2708
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
2709
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
2710
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
2711
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2680
2712
|
:type Url: str
|
2681
2713
|
:param _FaceAttributesType: 是否返回年龄、性别、情绪等属性。
|
2682
|
-
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
2683
|
-
|
2684
|
-
|
2685
|
-
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
2686
|
-
关于各属性的详细描述,参见下文出参。
|
2687
|
-
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
2714
|
+
- 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
2715
|
+
- None为不需要返回。
|
2716
|
+
- 默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
2717
|
+
- 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
2718
|
+
- 关于各属性的详细描述,参见下文出参。
|
2719
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
2688
2720
|
:type FaceAttributesType: str
|
2689
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
2721
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
2722
|
+
- 0为不开启,1为开启。
|
2723
|
+
- 默认为0。
|
2724
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
2725
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
2690
2726
|
:type NeedRotateDetection: int
|
2691
2727
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
|
2692
2728
|
:type FaceModelVersion: str
|
@@ -2701,8 +2737,8 @@ None为不需要返回。默认为 None。即FaceAttributesType属性为空时
|
|
2701
2737
|
@property
|
2702
2738
|
def MaxFaceNum(self):
|
2703
2739
|
"""最多处理的人脸数目。
|
2704
|
-
默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
2705
|
-
此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2740
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
2741
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2706
2742
|
:rtype: int
|
2707
2743
|
"""
|
2708
2744
|
return self._MaxFaceNum
|
@@ -2713,9 +2749,11 @@ None为不需要返回。默认为 None。即FaceAttributesType属性为空时
|
|
2713
2749
|
|
2714
2750
|
@property
|
2715
2751
|
def Image(self):
|
2716
|
-
"""图片 base64
|
2717
|
-
|
2718
|
-
|
2752
|
+
"""图片 base64 数据。
|
2753
|
+
- base64 编码后大小不可超过5M。
|
2754
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
2755
|
+
- 所有格式的图片短边像素不小于64。
|
2756
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2719
2757
|
:rtype: str
|
2720
2758
|
"""
|
2721
2759
|
return self._Image
|
@@ -2727,12 +2765,12 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
2727
2765
|
@property
|
2728
2766
|
def Url(self):
|
2729
2767
|
"""图片的 Url 。
|
2730
|
-
对应图片 base64 编码后大小不可超过5M。
|
2731
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
2732
|
-
Url、Image必须提供一个,如果都提供,只使用 Url。
|
2733
|
-
图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
2734
|
-
非腾讯云存储的Url速度和稳定性可能受一定影响。
|
2735
|
-
支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2768
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
2769
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
2770
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
2771
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
2772
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
2773
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2736
2774
|
:rtype: str
|
2737
2775
|
"""
|
2738
2776
|
return self._Url
|
@@ -2744,12 +2782,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2744
2782
|
@property
|
2745
2783
|
def FaceAttributesType(self):
|
2746
2784
|
"""是否返回年龄、性别、情绪等属性。
|
2747
|
-
合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
|
2748
|
-
|
2749
|
-
|
2750
|
-
需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
2751
|
-
关于各属性的详细描述,参见下文出参。
|
2752
|
-
最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
2785
|
+
- 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
|
2786
|
+
- None为不需要返回。
|
2787
|
+
- 默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
|
2788
|
+
- 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
|
2789
|
+
- 关于各属性的详细描述,参见下文出参。
|
2790
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
|
2753
2791
|
:rtype: str
|
2754
2792
|
"""
|
2755
2793
|
return self._FaceAttributesType
|
@@ -2760,7 +2798,11 @@ None为不需要返回。默认为 None。即FaceAttributesType属性为空时
|
|
2760
2798
|
|
2761
2799
|
@property
|
2762
2800
|
def NeedRotateDetection(self):
|
2763
|
-
"""是否开启图片旋转识别支持。
|
2801
|
+
"""是否开启图片旋转识别支持。
|
2802
|
+
- 0为不开启,1为开启。
|
2803
|
+
- 默认为0。
|
2804
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
2805
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
2764
2806
|
:rtype: int
|
2765
2807
|
"""
|
2766
2808
|
return self._NeedRotateDetection
|
@@ -2898,41 +2940,53 @@ class DetectFaceRequest(AbstractModel):
|
|
2898
2940
|
|
2899
2941
|
def __init__(self):
|
2900
2942
|
r"""
|
2901
|
-
:param _MaxFaceNum:
|
2902
|
-
|
2943
|
+
:param _MaxFaceNum: 最多处理的人脸数目。
|
2944
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
2945
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2903
2946
|
:type MaxFaceNum: int
|
2904
2947
|
:param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素,低于MinFaceSize值的人脸不会被检测。
|
2905
|
-
只支持设置34和20,建议使用34。
|
2906
|
-
|
2948
|
+
- 只支持设置34和20,建议使用34。
|
2907
2949
|
:type MinFaceSize: int
|
2908
|
-
:param _Image: 图片 base64
|
2909
|
-
|
2910
|
-
|
2950
|
+
:param _Image: 图片 base64 数据。
|
2951
|
+
- base64 编码后大小不可超过5M。
|
2952
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
2953
|
+
- 所有格式的图片短边像素不小于64。
|
2954
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2911
2955
|
:type Image: str
|
2912
|
-
:param _Url: 图片的 Url
|
2913
|
-
|
2914
|
-
|
2915
|
-
|
2916
|
-
|
2917
|
-
|
2956
|
+
:param _Url: 图片的 Url 。
|
2957
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
2958
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
2959
|
+
- 所有格式的图片短边像素不小于64。
|
2960
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
2961
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
2962
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
2963
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2918
2964
|
:type Url: str
|
2919
|
-
:param _NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
2920
|
-
|
2921
|
-
|
2922
|
-
|
2965
|
+
:param _NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。
|
2966
|
+
- 0 为不需要返回,1 为需要返回。
|
2967
|
+
- 默认为 0。
|
2968
|
+
- 非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
2969
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
2970
|
+
- 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
2923
2971
|
:type NeedFaceAttributes: int
|
2924
|
-
:param _NeedQualityDetection: 是否开启质量检测。
|
2925
|
-
|
2926
|
-
|
2927
|
-
|
2972
|
+
:param _NeedQualityDetection: 是否开启质量检测。
|
2973
|
+
- 0 为关闭,1 为开启。
|
2974
|
+
- 默认为 0。
|
2975
|
+
- 非 1 值均视为不进行质量检测。
|
2976
|
+
- 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
2977
|
+
- 建议:人脸入库操作建议开启此功能。
|
2928
2978
|
:type NeedQualityDetection: int
|
2929
2979
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
2930
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
2931
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
2932
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
2933
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
2980
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
2981
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
2982
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
2983
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
2934
2984
|
:type FaceModelVersion: str
|
2935
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
2985
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
2986
|
+
- 0为不开启,1为开启。
|
2987
|
+
- 默认为0。
|
2988
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
2989
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
2936
2990
|
:type NeedRotateDetection: int
|
2937
2991
|
"""
|
2938
2992
|
self._MaxFaceNum = None
|
@@ -2946,8 +3000,9 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2946
3000
|
|
2947
3001
|
@property
|
2948
3002
|
def MaxFaceNum(self):
|
2949
|
-
"""
|
2950
|
-
|
3003
|
+
"""最多处理的人脸数目。
|
3004
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
|
3005
|
+
- 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
|
2951
3006
|
:rtype: int
|
2952
3007
|
"""
|
2953
3008
|
return self._MaxFaceNum
|
@@ -2959,8 +3014,7 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2959
3014
|
@property
|
2960
3015
|
def MinFaceSize(self):
|
2961
3016
|
"""人脸长和宽的最小尺寸,单位为像素,低于MinFaceSize值的人脸不会被检测。
|
2962
|
-
只支持设置34和20,建议使用34。
|
2963
|
-
|
3017
|
+
- 只支持设置34和20,建议使用34。
|
2964
3018
|
:rtype: int
|
2965
3019
|
"""
|
2966
3020
|
return self._MinFaceSize
|
@@ -2971,9 +3025,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
2971
3025
|
|
2972
3026
|
@property
|
2973
3027
|
def Image(self):
|
2974
|
-
"""图片 base64
|
2975
|
-
|
2976
|
-
|
3028
|
+
"""图片 base64 数据。
|
3029
|
+
- base64 编码后大小不可超过5M。
|
3030
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3031
|
+
- 所有格式的图片短边像素不小于64。
|
3032
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2977
3033
|
:rtype: str
|
2978
3034
|
"""
|
2979
3035
|
return self._Image
|
@@ -2984,12 +3040,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
2984
3040
|
|
2985
3041
|
@property
|
2986
3042
|
def Url(self):
|
2987
|
-
"""图片的 Url
|
2988
|
-
|
2989
|
-
|
2990
|
-
|
2991
|
-
|
2992
|
-
|
3043
|
+
"""图片的 Url 。
|
3044
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
3045
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3046
|
+
- 所有格式的图片短边像素不小于64。
|
3047
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
3048
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
3049
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
3050
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
2993
3051
|
:rtype: str
|
2994
3052
|
"""
|
2995
3053
|
return self._Url
|
@@ -3000,10 +3058,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3000
3058
|
|
3001
3059
|
@property
|
3002
3060
|
def NeedFaceAttributes(self):
|
3003
|
-
"""是否需要返回人脸属性信息(FaceAttributesInfo)。
|
3004
|
-
|
3005
|
-
|
3006
|
-
|
3061
|
+
"""是否需要返回人脸属性信息(FaceAttributesInfo)。
|
3062
|
+
- 0 为不需要返回,1 为需要返回。
|
3063
|
+
- 默认为 0。
|
3064
|
+
- 非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
|
3065
|
+
- 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
|
3066
|
+
- 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
|
3007
3067
|
:rtype: int
|
3008
3068
|
"""
|
3009
3069
|
return self._NeedFaceAttributes
|
@@ -3014,10 +3074,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3014
3074
|
|
3015
3075
|
@property
|
3016
3076
|
def NeedQualityDetection(self):
|
3017
|
-
"""是否开启质量检测。
|
3018
|
-
|
3019
|
-
|
3020
|
-
|
3077
|
+
"""是否开启质量检测。
|
3078
|
+
- 0 为关闭,1 为开启。
|
3079
|
+
- 默认为 0。
|
3080
|
+
- 非 1 值均视为不进行质量检测。
|
3081
|
+
- 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
|
3082
|
+
- 建议:人脸入库操作建议开启此功能。
|
3021
3083
|
:rtype: int
|
3022
3084
|
"""
|
3023
3085
|
return self._NeedQualityDetection
|
@@ -3029,10 +3091,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3029
3091
|
@property
|
3030
3092
|
def FaceModelVersion(self):
|
3031
3093
|
"""人脸识别服务所用的算法模型版本。
|
3032
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
3033
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
3034
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
3035
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
3094
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
3095
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
3096
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
3097
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
3036
3098
|
:rtype: str
|
3037
3099
|
"""
|
3038
3100
|
return self._FaceModelVersion
|
@@ -3043,7 +3105,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3043
3105
|
|
3044
3106
|
@property
|
3045
3107
|
def NeedRotateDetection(self):
|
3046
|
-
"""是否开启图片旋转识别支持。
|
3108
|
+
"""是否开启图片旋转识别支持。
|
3109
|
+
- 0为不开启,1为开启。
|
3110
|
+
- 默认为0。
|
3111
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
3112
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
3047
3113
|
:rtype: int
|
3048
3114
|
"""
|
3049
3115
|
return self._NeedRotateDetection
|
@@ -3083,7 +3149,8 @@ class DetectFaceResponse(AbstractModel):
|
|
3083
3149
|
:type ImageWidth: int
|
3084
3150
|
:param _ImageHeight: 请求的图片高度。
|
3085
3151
|
:type ImageHeight: int
|
3086
|
-
:param _FaceInfos:
|
3152
|
+
:param _FaceInfos: 人脸信息列表。
|
3153
|
+
- 包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
|
3087
3154
|
:type FaceInfos: list of FaceInfo
|
3088
3155
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
3089
3156
|
:type FaceModelVersion: str
|
@@ -3120,7 +3187,8 @@ class DetectFaceResponse(AbstractModel):
|
|
3120
3187
|
|
3121
3188
|
@property
|
3122
3189
|
def FaceInfos(self):
|
3123
|
-
"""
|
3190
|
+
"""人脸信息列表。
|
3191
|
+
- 包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
|
3124
3192
|
:rtype: list of FaceInfo
|
3125
3193
|
"""
|
3126
3194
|
return self._FaceInfos
|
@@ -3172,19 +3240,21 @@ class DetectLiveFaceAccurateRequest(AbstractModel):
|
|
3172
3240
|
|
3173
3241
|
def __init__(self):
|
3174
3242
|
r"""
|
3175
|
-
:param _Image: 图片 base64
|
3176
|
-
|
3177
|
-
|
3178
|
-
|
3179
|
-
|
3243
|
+
:param _Image: 图片 base64 数据。
|
3244
|
+
- base64 编码后大小不可超过5M。
|
3245
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3246
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
3247
|
+
- 人脸尺寸大于100X100像素。
|
3248
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3180
3249
|
:type Image: str
|
3181
|
-
:param _Url: 图片的 Url
|
3182
|
-
|
3183
|
-
|
3184
|
-
|
3185
|
-
|
3186
|
-
|
3187
|
-
|
3250
|
+
:param _Url: 图片的 Url 。
|
3251
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
3252
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3253
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
3254
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
3255
|
+
- 人脸尺寸大于100X100像素。
|
3256
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
3257
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3188
3258
|
:type Url: str
|
3189
3259
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
|
3190
3260
|
:type FaceModelVersion: str
|
@@ -3195,11 +3265,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
3195
3265
|
|
3196
3266
|
@property
|
3197
3267
|
def Image(self):
|
3198
|
-
"""图片 base64
|
3199
|
-
|
3200
|
-
|
3201
|
-
|
3202
|
-
|
3268
|
+
"""图片 base64 数据。
|
3269
|
+
- base64 编码后大小不可超过5M。
|
3270
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3271
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
3272
|
+
- 人脸尺寸大于100X100像素。
|
3273
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3203
3274
|
:rtype: str
|
3204
3275
|
"""
|
3205
3276
|
return self._Image
|
@@ -3210,13 +3281,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
3210
3281
|
|
3211
3282
|
@property
|
3212
3283
|
def Url(self):
|
3213
|
-
"""图片的 Url
|
3214
|
-
|
3215
|
-
|
3216
|
-
|
3217
|
-
|
3218
|
-
|
3219
|
-
|
3284
|
+
"""图片的 Url 。
|
3285
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
3286
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
3287
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
3288
|
+
- 图片的宽高比请接近 3:4,手机拍摄比例最佳。
|
3289
|
+
- 人脸尺寸大于100X100像素。
|
3290
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
|
3291
|
+
- 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
3220
3292
|
:rtype: str
|
3221
3293
|
"""
|
3222
3294
|
return self._Url
|
@@ -3258,7 +3330,10 @@ class DetectLiveFaceAccurateResponse(AbstractModel):
|
|
3258
3330
|
|
3259
3331
|
def __init__(self):
|
3260
3332
|
r"""
|
3261
|
-
:param _Score:
|
3333
|
+
:param _Score: 活体打分。
|
3334
|
+
- 取值范围 [0,100]。
|
3335
|
+
- 根据活体分数对应的阈值区间来判断是否为翻拍。
|
3336
|
+
- 目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
|
3262
3337
|
:type Score: float
|
3263
3338
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
3264
3339
|
:type FaceModelVersion: str
|
@@ -3271,7 +3346,10 @@ class DetectLiveFaceAccurateResponse(AbstractModel):
|
|
3271
3346
|
|
3272
3347
|
@property
|
3273
3348
|
def Score(self):
|
3274
|
-
"""
|
3349
|
+
"""活体打分。
|
3350
|
+
- 取值范围 [0,100]。
|
3351
|
+
- 根据活体分数对应的阈值区间来判断是否为翻拍。
|
3352
|
+
- 目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
|
3275
3353
|
:rtype: float
|
3276
3354
|
"""
|
3277
3355
|
return self._Score
|
@@ -3492,16 +3570,16 @@ class Eye(AbstractModel):
|
|
3492
3570
|
def __init__(self):
|
3493
3571
|
r"""
|
3494
3572
|
:param _Glass: 识别是否佩戴眼镜。
|
3495
|
-
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
3573
|
+
- AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
3496
3574
|
:type Glass: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3497
3575
|
:param _EyeOpen: 识别眼睛的睁开、闭合状态。
|
3498
|
-
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
3576
|
+
- AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
3499
3577
|
:type EyeOpen: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3500
3578
|
:param _EyelidType: 识别是否双眼皮。
|
3501
|
-
AttributeItem对应的Type为 —— 0:无,1:有。
|
3579
|
+
- AttributeItem对应的Type为 —— 0:无,1:有。
|
3502
3580
|
:type EyelidType: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3503
3581
|
:param _EyeSize: 眼睛大小。
|
3504
|
-
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
3582
|
+
- AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
3505
3583
|
:type EyeSize: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3506
3584
|
"""
|
3507
3585
|
self._Glass = None
|
@@ -3512,7 +3590,7 @@ AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大
|
|
3512
3590
|
@property
|
3513
3591
|
def Glass(self):
|
3514
3592
|
"""识别是否佩戴眼镜。
|
3515
|
-
AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
3593
|
+
- AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
|
3516
3594
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3517
3595
|
"""
|
3518
3596
|
return self._Glass
|
@@ -3524,7 +3602,7 @@ AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨
|
|
3524
3602
|
@property
|
3525
3603
|
def EyeOpen(self):
|
3526
3604
|
"""识别眼睛的睁开、闭合状态。
|
3527
|
-
AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
3605
|
+
- AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
3528
3606
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3529
3607
|
"""
|
3530
3608
|
return self._EyeOpen
|
@@ -3536,7 +3614,7 @@ AttributeItem对应的Type为 —— 0:睁开,1:闭眼
|
|
3536
3614
|
@property
|
3537
3615
|
def EyelidType(self):
|
3538
3616
|
"""识别是否双眼皮。
|
3539
|
-
AttributeItem对应的Type为 —— 0:无,1:有。
|
3617
|
+
- AttributeItem对应的Type为 —— 0:无,1:有。
|
3540
3618
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3541
3619
|
"""
|
3542
3620
|
return self._EyelidType
|
@@ -3548,7 +3626,7 @@ AttributeItem对应的Type为 —— 0:无,1:有。
|
|
3548
3626
|
@property
|
3549
3627
|
def EyeSize(self):
|
3550
3628
|
"""眼睛大小。
|
3551
|
-
AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
3629
|
+
- AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
|
3552
3630
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3553
3631
|
"""
|
3554
3632
|
return self._EyeSize
|
@@ -3589,13 +3667,13 @@ class Eyebrow(AbstractModel):
|
|
3589
3667
|
def __init__(self):
|
3590
3668
|
r"""
|
3591
3669
|
:param _EyebrowDensity: 眉毛浓密。
|
3592
|
-
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
3670
|
+
- AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
3593
3671
|
:type EyebrowDensity: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3594
3672
|
:param _EyebrowCurve: 眉毛弯曲。
|
3595
|
-
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
3673
|
+
- AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
3596
3674
|
:type EyebrowCurve: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3597
3675
|
:param _EyebrowLength: 眉毛长短。
|
3598
|
-
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
3676
|
+
- AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
3599
3677
|
:type EyebrowLength: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3600
3678
|
"""
|
3601
3679
|
self._EyebrowDensity = None
|
@@ -3605,7 +3683,7 @@ AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
|
3605
3683
|
@property
|
3606
3684
|
def EyebrowDensity(self):
|
3607
3685
|
"""眉毛浓密。
|
3608
|
-
AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
3686
|
+
- AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
3609
3687
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3610
3688
|
"""
|
3611
3689
|
return self._EyebrowDensity
|
@@ -3617,7 +3695,7 @@ AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
|
|
3617
3695
|
@property
|
3618
3696
|
def EyebrowCurve(self):
|
3619
3697
|
"""眉毛弯曲。
|
3620
|
-
AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
3698
|
+
- AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
3621
3699
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3622
3700
|
"""
|
3623
3701
|
return self._EyebrowCurve
|
@@ -3629,7 +3707,7 @@ AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
|
|
3629
3707
|
@property
|
3630
3708
|
def EyebrowLength(self):
|
3631
3709
|
"""眉毛长短。
|
3632
|
-
AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
3710
|
+
- AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
|
3633
3711
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3634
3712
|
"""
|
3635
3713
|
return self._EyebrowLength
|
@@ -3667,35 +3745,59 @@ class FaceAttributesInfo(AbstractModel):
|
|
3667
3745
|
|
3668
3746
|
def __init__(self):
|
3669
3747
|
r"""
|
3670
|
-
:param _Gender:
|
3748
|
+
:param _Gender: 性别。
|
3749
|
+
- 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
|
3750
|
+
- NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3671
3751
|
:type Gender: int
|
3672
|
-
:param _Age: 年龄
|
3752
|
+
:param _Age: 年龄 。
|
3753
|
+
- 取值范围:[0~100]。
|
3754
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3673
3755
|
:type Age: int
|
3674
|
-
:param _Expression:
|
3756
|
+
:param _Expression: 微笑。
|
3757
|
+
- 取值说明:[0(normal,正常)~100(laugh,大笑)]。
|
3758
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3675
3759
|
:type Expression: int
|
3676
|
-
:param _Glass:
|
3760
|
+
:param _Glass: 是否有眼镜。
|
3761
|
+
- 取值范围: [true,false]。
|
3762
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3677
3763
|
:type Glass: bool
|
3678
|
-
:param _Pitch:
|
3679
|
-
|
3764
|
+
:param _Pitch: 上下偏移。
|
3765
|
+
- 取值范围:[-30,30],单位角度。
|
3766
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3767
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
3680
3768
|
:type Pitch: int
|
3681
|
-
:param _Yaw:
|
3682
|
-
|
3769
|
+
:param _Yaw: 左右偏移。
|
3770
|
+
- 取值范围:[-30,30],单位角度。
|
3771
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3772
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
3683
3773
|
:type Yaw: int
|
3684
|
-
:param _Roll:
|
3685
|
-
|
3774
|
+
:param _Roll: 平面旋转。
|
3775
|
+
- 取值范围:[-180,180],单位角度。
|
3776
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3777
|
+
- 建议:人脸入库选择[-20,20]的图片。
|
3686
3778
|
:type Roll: int
|
3687
|
-
:param _Beauty:
|
3779
|
+
:param _Beauty: 魅力。
|
3780
|
+
- 取值范围:[0~100]。
|
3781
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3688
3782
|
:type Beauty: int
|
3689
|
-
:param _Hat:
|
3783
|
+
:param _Hat: 是否有帽子。
|
3784
|
+
- 取值范围: [true,false]。
|
3785
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3690
3786
|
注意:此字段可能返回 null,表示取不到有效值。
|
3691
3787
|
:type Hat: bool
|
3692
|
-
:param _Mask:
|
3788
|
+
:param _Mask: 是否有口罩。
|
3789
|
+
- 取值范围: [true,false]。
|
3790
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3693
3791
|
注意:此字段可能返回 null,表示取不到有效值。
|
3694
3792
|
:type Mask: bool
|
3695
|
-
:param _Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
3793
|
+
:param _Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
3794
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3696
3795
|
注意:此字段可能返回 null,表示取不到有效值。
|
3697
3796
|
:type Hair: :class:`tencentcloud.iai.v20200303.models.FaceHairAttributesInfo`
|
3698
|
-
:param _EyeOpen:
|
3797
|
+
:param _EyeOpen: 双眼是否睁开。
|
3798
|
+
- 取值范围: [true,false]。
|
3799
|
+
- 只要有超过一只眼睛闭眼,就返回false。
|
3800
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3699
3801
|
注意:此字段可能返回 null,表示取不到有效值。
|
3700
3802
|
:type EyeOpen: bool
|
3701
3803
|
"""
|
@@ -3714,7 +3816,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3714
3816
|
|
3715
3817
|
@property
|
3716
3818
|
def Gender(self):
|
3717
|
-
"""
|
3819
|
+
"""性别。
|
3820
|
+
- 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
|
3821
|
+
- NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3718
3822
|
:rtype: int
|
3719
3823
|
"""
|
3720
3824
|
return self._Gender
|
@@ -3725,7 +3829,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3725
3829
|
|
3726
3830
|
@property
|
3727
3831
|
def Age(self):
|
3728
|
-
"""年龄
|
3832
|
+
"""年龄 。
|
3833
|
+
- 取值范围:[0~100]。
|
3834
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3729
3835
|
:rtype: int
|
3730
3836
|
"""
|
3731
3837
|
return self._Age
|
@@ -3736,7 +3842,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3736
3842
|
|
3737
3843
|
@property
|
3738
3844
|
def Expression(self):
|
3739
|
-
"""
|
3845
|
+
"""微笑。
|
3846
|
+
- 取值说明:[0(normal,正常)~100(laugh,大笑)]。
|
3847
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3740
3848
|
:rtype: int
|
3741
3849
|
"""
|
3742
3850
|
return self._Expression
|
@@ -3747,7 +3855,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3747
3855
|
|
3748
3856
|
@property
|
3749
3857
|
def Glass(self):
|
3750
|
-
"""
|
3858
|
+
"""是否有眼镜。
|
3859
|
+
- 取值范围: [true,false]。
|
3860
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3751
3861
|
:rtype: bool
|
3752
3862
|
"""
|
3753
3863
|
return self._Glass
|
@@ -3758,8 +3868,10 @@ class FaceAttributesInfo(AbstractModel):
|
|
3758
3868
|
|
3759
3869
|
@property
|
3760
3870
|
def Pitch(self):
|
3761
|
-
"""
|
3762
|
-
|
3871
|
+
"""上下偏移。
|
3872
|
+
- 取值范围:[-30,30],单位角度。
|
3873
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3874
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
3763
3875
|
:rtype: int
|
3764
3876
|
"""
|
3765
3877
|
return self._Pitch
|
@@ -3770,8 +3882,10 @@ class FaceAttributesInfo(AbstractModel):
|
|
3770
3882
|
|
3771
3883
|
@property
|
3772
3884
|
def Yaw(self):
|
3773
|
-
"""
|
3774
|
-
|
3885
|
+
"""左右偏移。
|
3886
|
+
- 取值范围:[-30,30],单位角度。
|
3887
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3888
|
+
- 建议:人脸入库选择[-10,10]的图片。
|
3775
3889
|
:rtype: int
|
3776
3890
|
"""
|
3777
3891
|
return self._Yaw
|
@@ -3782,8 +3896,10 @@ class FaceAttributesInfo(AbstractModel):
|
|
3782
3896
|
|
3783
3897
|
@property
|
3784
3898
|
def Roll(self):
|
3785
|
-
"""
|
3786
|
-
|
3899
|
+
"""平面旋转。
|
3900
|
+
- 取值范围:[-180,180],单位角度。
|
3901
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3902
|
+
- 建议:人脸入库选择[-20,20]的图片。
|
3787
3903
|
:rtype: int
|
3788
3904
|
"""
|
3789
3905
|
return self._Roll
|
@@ -3794,7 +3910,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3794
3910
|
|
3795
3911
|
@property
|
3796
3912
|
def Beauty(self):
|
3797
|
-
"""
|
3913
|
+
"""魅力。
|
3914
|
+
- 取值范围:[0~100]。
|
3915
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3798
3916
|
:rtype: int
|
3799
3917
|
"""
|
3800
3918
|
return self._Beauty
|
@@ -3805,7 +3923,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3805
3923
|
|
3806
3924
|
@property
|
3807
3925
|
def Hat(self):
|
3808
|
-
"""
|
3926
|
+
"""是否有帽子。
|
3927
|
+
- 取值范围: [true,false]。
|
3928
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3809
3929
|
注意:此字段可能返回 null,表示取不到有效值。
|
3810
3930
|
:rtype: bool
|
3811
3931
|
"""
|
@@ -3817,7 +3937,9 @@ class FaceAttributesInfo(AbstractModel):
|
|
3817
3937
|
|
3818
3938
|
@property
|
3819
3939
|
def Mask(self):
|
3820
|
-
"""
|
3940
|
+
"""是否有口罩。
|
3941
|
+
- 取值范围: [true,false]。
|
3942
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3821
3943
|
注意:此字段可能返回 null,表示取不到有效值。
|
3822
3944
|
:rtype: bool
|
3823
3945
|
"""
|
@@ -3829,7 +3951,8 @@ class FaceAttributesInfo(AbstractModel):
|
|
3829
3951
|
|
3830
3952
|
@property
|
3831
3953
|
def Hair(self):
|
3832
|
-
"""头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
3954
|
+
"""头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
3955
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3833
3956
|
注意:此字段可能返回 null,表示取不到有效值。
|
3834
3957
|
:rtype: :class:`tencentcloud.iai.v20200303.models.FaceHairAttributesInfo`
|
3835
3958
|
"""
|
@@ -3841,7 +3964,10 @@ class FaceAttributesInfo(AbstractModel):
|
|
3841
3964
|
|
3842
3965
|
@property
|
3843
3966
|
def EyeOpen(self):
|
3844
|
-
"""
|
3967
|
+
"""双眼是否睁开。
|
3968
|
+
- 取值范围: [true,false]。
|
3969
|
+
- 只要有超过一只眼睛闭眼,就返回false。
|
3970
|
+
- NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3845
3971
|
注意:此字段可能返回 null,表示取不到有效值。
|
3846
3972
|
:rtype: bool
|
3847
3973
|
"""
|
@@ -3888,60 +4014,63 @@ class FaceDetailAttributesInfo(AbstractModel):
|
|
3888
4014
|
|
3889
4015
|
def __init__(self):
|
3890
4016
|
r"""
|
3891
|
-
:param _Age:
|
3892
|
-
|
4017
|
+
:param _Age: 年龄。
|
4018
|
+
- 取值范围: [0,65],其中65代表“65岁及以上”。
|
4019
|
+
- FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3893
4020
|
:type Age: int
|
3894
|
-
:param _Beauty:
|
3895
|
-
|
4021
|
+
:param _Beauty: 美丑打分。
|
4022
|
+
- 取值范围:[0,100]。
|
4023
|
+
- FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3896
4024
|
:type Beauty: int
|
3897
4025
|
:param _Emotion: 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
3898
|
-
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6
|
3899
|
-
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4026
|
+
- AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕。
|
4027
|
+
- FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3900
4028
|
:type Emotion: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3901
4029
|
:param _Eye: 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
3902
|
-
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4030
|
+
- FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3903
4031
|
:type Eye: :class:`tencentcloud.iai.v20200303.models.Eye`
|
3904
4032
|
:param _Eyebrow: 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
|
3905
4033
|
FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3906
4034
|
:type Eyebrow: :class:`tencentcloud.iai.v20200303.models.Eyebrow`
|
3907
4035
|
:param _Gender: 性别信息。
|
3908
|
-
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
3909
|
-
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4036
|
+
- AttributeItem对应的Type为 —— 0:男性,1:女性。
|
4037
|
+
- FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3910
4038
|
:type Gender: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3911
4039
|
:param _Hair: 头发信息,包含头发长度、有无刘海、头发颜色。
|
3912
|
-
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4040
|
+
- FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3913
4041
|
:type Hair: :class:`tencentcloud.iai.v20200303.models.Hair`
|
3914
4042
|
:param _Hat: 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
3915
|
-
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4043
|
+
- FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3916
4044
|
:type Hat: :class:`tencentcloud.iai.v20200303.models.Hat`
|
3917
4045
|
:param _HeadPose: 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
3918
|
-
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4046
|
+
- FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3919
4047
|
:type HeadPose: :class:`tencentcloud.iai.v20200303.models.HeadPose`
|
3920
4048
|
:param _Mask: 口罩佩戴信息。
|
3921
|
-
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
3922
|
-
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4049
|
+
- AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
4050
|
+
- FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3923
4051
|
:type Mask: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3924
4052
|
:param _Mouth: 嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
3925
|
-
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4053
|
+
- FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3926
4054
|
:type Mouth: :class:`tencentcloud.iai.v20200303.models.Mouth`
|
3927
4055
|
:param _Moustache: 胡子信息。
|
3928
|
-
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
3929
|
-
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4056
|
+
- AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
4057
|
+
- FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3930
4058
|
:type Moustache: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3931
4059
|
:param _Nose: 鼻子信息。
|
3932
|
-
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
3933
|
-
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4060
|
+
- AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
4061
|
+
- FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3934
4062
|
:type Nose: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3935
4063
|
:param _Shape: 脸型信息。
|
3936
|
-
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
3937
|
-
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4064
|
+
- AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
4065
|
+
- FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3938
4066
|
:type Shape: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3939
4067
|
:param _Skin: 肤色信息。
|
3940
|
-
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
3941
|
-
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4068
|
+
- AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
4069
|
+
- FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3942
4070
|
:type Skin: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3943
|
-
:param _Smile:
|
3944
|
-
|
4071
|
+
:param _Smile: 微笑程度
|
4072
|
+
- 取值范围:[0,100]。
|
4073
|
+
- FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3945
4074
|
:type Smile: int
|
3946
4075
|
"""
|
3947
4076
|
self._Age = None
|
@@ -3963,8 +4092,9 @@ FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返
|
|
3963
4092
|
|
3964
4093
|
@property
|
3965
4094
|
def Age(self):
|
3966
|
-
"""
|
3967
|
-
|
4095
|
+
"""年龄。
|
4096
|
+
- 取值范围: [0,65],其中65代表“65岁及以上”。
|
4097
|
+
- FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3968
4098
|
:rtype: int
|
3969
4099
|
"""
|
3970
4100
|
return self._Age
|
@@ -3975,8 +4105,9 @@ FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回
|
|
3975
4105
|
|
3976
4106
|
@property
|
3977
4107
|
def Beauty(self):
|
3978
|
-
"""
|
3979
|
-
|
4108
|
+
"""美丑打分。
|
4109
|
+
- 取值范围:[0,100]。
|
4110
|
+
- FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3980
4111
|
:rtype: int
|
3981
4112
|
"""
|
3982
4113
|
return self._Beauty
|
@@ -3988,8 +4119,8 @@ FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍
|
|
3988
4119
|
@property
|
3989
4120
|
def Emotion(self):
|
3990
4121
|
"""情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
|
3991
|
-
AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6
|
3992
|
-
FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4122
|
+
- AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕。
|
4123
|
+
- FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
3993
4124
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
3994
4125
|
"""
|
3995
4126
|
return self._Emotion
|
@@ -4001,7 +4132,7 @@ FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍
|
|
4001
4132
|
@property
|
4002
4133
|
def Eye(self):
|
4003
4134
|
"""眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
|
4004
|
-
FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4135
|
+
- FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4005
4136
|
:rtype: :class:`tencentcloud.iai.v20200303.models.Eye`
|
4006
4137
|
"""
|
4007
4138
|
return self._Eye
|
@@ -4025,8 +4156,8 @@ FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍
|
|
4025
4156
|
@property
|
4026
4157
|
def Gender(self):
|
4027
4158
|
"""性别信息。
|
4028
|
-
AttributeItem对应的Type为 —— 0:男性,1:女性。
|
4029
|
-
FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4159
|
+
- AttributeItem对应的Type为 —— 0:男性,1:女性。
|
4160
|
+
- FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4030
4161
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4031
4162
|
"""
|
4032
4163
|
return self._Gender
|
@@ -4038,7 +4169,7 @@ FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返
|
|
4038
4169
|
@property
|
4039
4170
|
def Hair(self):
|
4040
4171
|
"""头发信息,包含头发长度、有无刘海、头发颜色。
|
4041
|
-
FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4172
|
+
- FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4042
4173
|
:rtype: :class:`tencentcloud.iai.v20200303.models.Hair`
|
4043
4174
|
"""
|
4044
4175
|
return self._Hair
|
@@ -4050,7 +4181,7 @@ FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返
|
|
4050
4181
|
@property
|
4051
4182
|
def Hat(self):
|
4052
4183
|
"""帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
|
4053
|
-
FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4184
|
+
- FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4054
4185
|
:rtype: :class:`tencentcloud.iai.v20200303.models.Hat`
|
4055
4186
|
"""
|
4056
4187
|
return self._Hat
|
@@ -4062,7 +4193,7 @@ FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回
|
|
4062
4193
|
@property
|
4063
4194
|
def HeadPose(self):
|
4064
4195
|
"""姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
|
4065
|
-
FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4196
|
+
- FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4066
4197
|
:rtype: :class:`tencentcloud.iai.v20200303.models.HeadPose`
|
4067
4198
|
"""
|
4068
4199
|
return self._HeadPose
|
@@ -4074,8 +4205,8 @@ FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍
|
|
4074
4205
|
@property
|
4075
4206
|
def Mask(self):
|
4076
4207
|
"""口罩佩戴信息。
|
4077
|
-
AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
4078
|
-
FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4208
|
+
- AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
|
4209
|
+
- FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4079
4210
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4080
4211
|
"""
|
4081
4212
|
return self._Mask
|
@@ -4087,7 +4218,7 @@ FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返
|
|
4087
4218
|
@property
|
4088
4219
|
def Mouth(self):
|
4089
4220
|
"""嘴巴信息,可识别是否张嘴、嘴唇厚度。
|
4090
|
-
FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4221
|
+
- FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4091
4222
|
:rtype: :class:`tencentcloud.iai.v20200303.models.Mouth`
|
4092
4223
|
"""
|
4093
4224
|
return self._Mouth
|
@@ -4099,8 +4230,8 @@ FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返
|
|
4099
4230
|
@property
|
4100
4231
|
def Moustache(self):
|
4101
4232
|
"""胡子信息。
|
4102
|
-
AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
4103
|
-
FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4233
|
+
- AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
|
4234
|
+
- FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4104
4235
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4105
4236
|
"""
|
4106
4237
|
return self._Moustache
|
@@ -4112,8 +4243,8 @@ FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数
|
|
4112
4243
|
@property
|
4113
4244
|
def Nose(self):
|
4114
4245
|
"""鼻子信息。
|
4115
|
-
AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
4116
|
-
FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4246
|
+
- AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
|
4247
|
+
- FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4117
4248
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4118
4249
|
"""
|
4119
4250
|
return self._Nose
|
@@ -4125,8 +4256,8 @@ FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返
|
|
4125
4256
|
@property
|
4126
4257
|
def Shape(self):
|
4127
4258
|
"""脸型信息。
|
4128
|
-
AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
4129
|
-
FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4259
|
+
- AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
|
4260
|
+
- FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4130
4261
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4131
4262
|
"""
|
4132
4263
|
return self._Shape
|
@@ -4138,8 +4269,8 @@ FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返
|
|
4138
4269
|
@property
|
4139
4270
|
def Skin(self):
|
4140
4271
|
"""肤色信息。
|
4141
|
-
AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
4142
|
-
FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4272
|
+
- AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
|
4273
|
+
- FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4143
4274
|
:rtype: :class:`tencentcloud.iai.v20200303.models.AttributeItem`
|
4144
4275
|
"""
|
4145
4276
|
return self._Skin
|
@@ -4150,8 +4281,9 @@ FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返
|
|
4150
4281
|
|
4151
4282
|
@property
|
4152
4283
|
def Smile(self):
|
4153
|
-
"""
|
4154
|
-
|
4284
|
+
"""微笑程度
|
4285
|
+
- 取值范围:[0,100]。
|
4286
|
+
- FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
4155
4287
|
:rtype: int
|
4156
4288
|
"""
|
4157
4289
|
return self._Smile
|
@@ -4223,11 +4355,9 @@ class FaceDetailInfo(AbstractModel):
|
|
4223
4355
|
r"""
|
4224
4356
|
:param _FaceRect: 检测出的人脸框位置。
|
4225
4357
|
:type FaceRect: :class:`tencentcloud.iai.v20200303.models.FaceRect`
|
4226
|
-
:param _FaceDetailAttributesInfo:
|
4227
|
-
|
4228
|
-
|
4229
|
-
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
4230
|
-
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
4358
|
+
:param _FaceDetailAttributesInfo: 人脸属性信息。
|
4359
|
+
- 根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)、情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)、头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache) 、鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
4360
|
+
- 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
4231
4361
|
:type FaceDetailAttributesInfo: :class:`tencentcloud.iai.v20200303.models.FaceDetailAttributesInfo`
|
4232
4362
|
"""
|
4233
4363
|
self._FaceRect = None
|
@@ -4246,11 +4376,9 @@ class FaceDetailInfo(AbstractModel):
|
|
4246
4376
|
|
4247
4377
|
@property
|
4248
4378
|
def FaceDetailAttributesInfo(self):
|
4249
|
-
"""
|
4250
|
-
|
4251
|
-
|
4252
|
-
鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
4253
|
-
若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
4379
|
+
"""人脸属性信息。
|
4380
|
+
- 根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)、情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)、头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache) 、鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
|
4381
|
+
- 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
|
4254
4382
|
:rtype: :class:`tencentcloud.iai.v20200303.models.FaceDetailAttributesInfo`
|
4255
4383
|
"""
|
4256
4384
|
return self._FaceDetailAttributesInfo
|
@@ -4284,13 +4412,13 @@ class FaceHairAttributesInfo(AbstractModel):
|
|
4284
4412
|
|
4285
4413
|
def __init__(self):
|
4286
4414
|
r"""
|
4287
|
-
:param _Length: 0:光头,1:短发,2:中发,3:长发,4
|
4415
|
+
:param _Length: 取值范围:0:光头,1:短发,2:中发,3:长发,4:绑发。
|
4288
4416
|
注意:此字段可能返回 null,表示取不到有效值。
|
4289
4417
|
:type Length: int
|
4290
|
-
:param _Bang: 0:有刘海,1
|
4418
|
+
:param _Bang: 取值范围:0:有刘海,1:无刘海。
|
4291
4419
|
注意:此字段可能返回 null,表示取不到有效值。
|
4292
4420
|
:type Bang: int
|
4293
|
-
:param _Color: 0:黑色,1:金色,2:棕色,3
|
4421
|
+
:param _Color: 取值范围:0:黑色,1:金色,2:棕色,3:灰白色。
|
4294
4422
|
注意:此字段可能返回 null,表示取不到有效值。
|
4295
4423
|
:type Color: int
|
4296
4424
|
"""
|
@@ -4300,7 +4428,7 @@ class FaceHairAttributesInfo(AbstractModel):
|
|
4300
4428
|
|
4301
4429
|
@property
|
4302
4430
|
def Length(self):
|
4303
|
-
"""0:光头,1:短发,2:中发,3:长发,4
|
4431
|
+
"""取值范围:0:光头,1:短发,2:中发,3:长发,4:绑发。
|
4304
4432
|
注意:此字段可能返回 null,表示取不到有效值。
|
4305
4433
|
:rtype: int
|
4306
4434
|
"""
|
@@ -4312,7 +4440,7 @@ class FaceHairAttributesInfo(AbstractModel):
|
|
4312
4440
|
|
4313
4441
|
@property
|
4314
4442
|
def Bang(self):
|
4315
|
-
"""0:有刘海,1
|
4443
|
+
"""取值范围:0:有刘海,1:无刘海。
|
4316
4444
|
注意:此字段可能返回 null,表示取不到有效值。
|
4317
4445
|
:rtype: int
|
4318
4446
|
"""
|
@@ -4324,7 +4452,7 @@ class FaceHairAttributesInfo(AbstractModel):
|
|
4324
4452
|
|
4325
4453
|
@property
|
4326
4454
|
def Color(self):
|
4327
|
-
"""0:黑色,1:金色,2:棕色,3
|
4455
|
+
"""取值范围:0:黑色,1:金色,2:棕色,3:灰白色。
|
4328
4456
|
注意:此字段可能返回 null,表示取不到有效值。
|
4329
4457
|
:rtype: int
|
4330
4458
|
"""
|
@@ -4357,21 +4485,24 @@ class FaceInfo(AbstractModel):
|
|
4357
4485
|
def __init__(self):
|
4358
4486
|
r"""
|
4359
4487
|
:param _X: 人脸框左上角横坐标。
|
4360
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4361
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4488
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4489
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4362
4490
|
:type X: int
|
4363
4491
|
:param _Y: 人脸框左上角纵坐标。
|
4364
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4365
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4492
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4493
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4366
4494
|
:type Y: int
|
4367
4495
|
:param _Width: 人脸框宽度。
|
4368
4496
|
:type Width: int
|
4369
4497
|
:param _Height: 人脸框高度。
|
4370
4498
|
:type Height: int
|
4371
|
-
:param _FaceAttributesInfo:
|
4372
|
-
|
4499
|
+
:param _FaceAttributesInfo: 人脸属性信息。
|
4500
|
+
- 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。
|
4501
|
+
- 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
4373
4502
|
:type FaceAttributesInfo: :class:`tencentcloud.iai.v20200303.models.FaceAttributesInfo`
|
4374
|
-
:param _FaceQualityInfo:
|
4503
|
+
:param _FaceQualityInfo: 人脸质量信息。
|
4504
|
+
- 包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。
|
4505
|
+
- 只有当NeedFaceDetection设为1时才返回有效信息。
|
4375
4506
|
注意:此字段可能返回 null,表示取不到有效值。
|
4376
4507
|
:type FaceQualityInfo: :class:`tencentcloud.iai.v20200303.models.FaceQualityInfo`
|
4377
4508
|
"""
|
@@ -4385,8 +4516,8 @@ class FaceInfo(AbstractModel):
|
|
4385
4516
|
@property
|
4386
4517
|
def X(self):
|
4387
4518
|
"""人脸框左上角横坐标。
|
4388
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4389
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4519
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4520
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4390
4521
|
:rtype: int
|
4391
4522
|
"""
|
4392
4523
|
return self._X
|
@@ -4398,8 +4529,8 @@ class FaceInfo(AbstractModel):
|
|
4398
4529
|
@property
|
4399
4530
|
def Y(self):
|
4400
4531
|
"""人脸框左上角纵坐标。
|
4401
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4402
|
-
若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4532
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4533
|
+
- 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
|
4403
4534
|
:rtype: int
|
4404
4535
|
"""
|
4405
4536
|
return self._Y
|
@@ -4432,8 +4563,9 @@ class FaceInfo(AbstractModel):
|
|
4432
4563
|
|
4433
4564
|
@property
|
4434
4565
|
def FaceAttributesInfo(self):
|
4435
|
-
"""
|
4436
|
-
|
4566
|
+
"""人脸属性信息。
|
4567
|
+
- 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。
|
4568
|
+
- 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
|
4437
4569
|
:rtype: :class:`tencentcloud.iai.v20200303.models.FaceAttributesInfo`
|
4438
4570
|
"""
|
4439
4571
|
return self._FaceAttributesInfo
|
@@ -4444,7 +4576,9 @@ class FaceInfo(AbstractModel):
|
|
4444
4576
|
|
4445
4577
|
@property
|
4446
4578
|
def FaceQualityInfo(self):
|
4447
|
-
"""
|
4579
|
+
"""人脸质量信息。
|
4580
|
+
- 包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。
|
4581
|
+
- 只有当NeedFaceDetection设为1时才返回有效信息。
|
4448
4582
|
注意:此字段可能返回 null,表示取不到有效值。
|
4449
4583
|
:rtype: :class:`tencentcloud.iai.v20200303.models.FaceQualityInfo`
|
4450
4584
|
"""
|
@@ -4483,28 +4617,34 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4483
4617
|
|
4484
4618
|
def __init__(self):
|
4485
4619
|
r"""
|
4486
|
-
:param _Eyebrow:
|
4487
|
-
|
4620
|
+
:param _Eyebrow: 眉毛的遮挡分数。
|
4621
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4622
|
+
- 参考范围:[0,80]表示发生遮挡。
|
4488
4623
|
注意:此字段可能返回 null,表示取不到有效值。
|
4489
4624
|
:type Eyebrow: int
|
4490
|
-
:param _Eye:
|
4491
|
-
|
4625
|
+
:param _Eye: 眼睛的遮挡分数。
|
4626
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4627
|
+
- 参考范围:[0,80]表示发生遮挡。
|
4492
4628
|
注意:此字段可能返回 null,表示取不到有效值。
|
4493
4629
|
:type Eye: int
|
4494
|
-
:param _Nose:
|
4495
|
-
|
4630
|
+
:param _Nose: 鼻子的遮挡分数。
|
4631
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4632
|
+
- 参考范围:[0,60]表示发生遮挡。
|
4496
4633
|
注意:此字段可能返回 null,表示取不到有效值。
|
4497
4634
|
:type Nose: int
|
4498
|
-
:param _Cheek:
|
4499
|
-
|
4635
|
+
:param _Cheek: 脸颊的遮挡分数。
|
4636
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4637
|
+
- 参考范围:[0,70]表示发生遮挡。
|
4500
4638
|
注意:此字段可能返回 null,表示取不到有效值。
|
4501
4639
|
:type Cheek: int
|
4502
|
-
:param _Mouth:
|
4503
|
-
|
4640
|
+
:param _Mouth: 嘴巴的遮挡分数。
|
4641
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4642
|
+
- 参考范围:[0,50]表示发生遮挡。
|
4504
4643
|
注意:此字段可能返回 null,表示取不到有效值。
|
4505
4644
|
:type Mouth: int
|
4506
|
-
:param _Chin:
|
4507
|
-
|
4645
|
+
:param _Chin: 下巴的遮挡分数。
|
4646
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4647
|
+
- 参考范围:[0,70]表示发生遮挡。
|
4508
4648
|
注意:此字段可能返回 null,表示取不到有效值。
|
4509
4649
|
:type Chin: int
|
4510
4650
|
"""
|
@@ -4517,8 +4657,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4517
4657
|
|
4518
4658
|
@property
|
4519
4659
|
def Eyebrow(self):
|
4520
|
-
"""
|
4521
|
-
|
4660
|
+
"""眉毛的遮挡分数。
|
4661
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4662
|
+
- 参考范围:[0,80]表示发生遮挡。
|
4522
4663
|
注意:此字段可能返回 null,表示取不到有效值。
|
4523
4664
|
:rtype: int
|
4524
4665
|
"""
|
@@ -4530,8 +4671,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4530
4671
|
|
4531
4672
|
@property
|
4532
4673
|
def Eye(self):
|
4533
|
-
"""
|
4534
|
-
|
4674
|
+
"""眼睛的遮挡分数。
|
4675
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4676
|
+
- 参考范围:[0,80]表示发生遮挡。
|
4535
4677
|
注意:此字段可能返回 null,表示取不到有效值。
|
4536
4678
|
:rtype: int
|
4537
4679
|
"""
|
@@ -4543,8 +4685,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4543
4685
|
|
4544
4686
|
@property
|
4545
4687
|
def Nose(self):
|
4546
|
-
"""
|
4547
|
-
|
4688
|
+
"""鼻子的遮挡分数。
|
4689
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4690
|
+
- 参考范围:[0,60]表示发生遮挡。
|
4548
4691
|
注意:此字段可能返回 null,表示取不到有效值。
|
4549
4692
|
:rtype: int
|
4550
4693
|
"""
|
@@ -4556,8 +4699,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4556
4699
|
|
4557
4700
|
@property
|
4558
4701
|
def Cheek(self):
|
4559
|
-
"""
|
4560
|
-
|
4702
|
+
"""脸颊的遮挡分数。
|
4703
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4704
|
+
- 参考范围:[0,70]表示发生遮挡。
|
4561
4705
|
注意:此字段可能返回 null,表示取不到有效值。
|
4562
4706
|
:rtype: int
|
4563
4707
|
"""
|
@@ -4569,8 +4713,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4569
4713
|
|
4570
4714
|
@property
|
4571
4715
|
def Mouth(self):
|
4572
|
-
"""
|
4573
|
-
|
4716
|
+
"""嘴巴的遮挡分数。
|
4717
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4718
|
+
- 参考范围:[0,50]表示发生遮挡。
|
4574
4719
|
注意:此字段可能返回 null,表示取不到有效值。
|
4575
4720
|
:rtype: int
|
4576
4721
|
"""
|
@@ -4582,8 +4727,9 @@ class FaceQualityCompleteness(AbstractModel):
|
|
4582
4727
|
|
4583
4728
|
@property
|
4584
4729
|
def Chin(self):
|
4585
|
-
"""
|
4586
|
-
|
4730
|
+
"""下巴的遮挡分数。
|
4731
|
+
- 取值范围:[0,100],分数越高遮挡越少。
|
4732
|
+
- 参考范围:[0,70]表示发生遮挡。
|
4587
4733
|
注意:此字段可能返回 null,表示取不到有效值。
|
4588
4734
|
:rtype: int
|
4589
4735
|
"""
|
@@ -4618,20 +4764,23 @@ class FaceQualityInfo(AbstractModel):
|
|
4618
4764
|
|
4619
4765
|
def __init__(self):
|
4620
4766
|
r"""
|
4621
|
-
:param _Score:
|
4622
|
-
|
4623
|
-
|
4624
|
-
|
4767
|
+
:param _Score: 质量分。
|
4768
|
+
- 取值范围:[0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
4769
|
+
- 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
4770
|
+
- 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
4771
|
+
- 建议:人脸入库选取70以上的图片。
|
4625
4772
|
注意:此字段可能返回 null,表示取不到有效值。
|
4626
4773
|
:type Score: int
|
4627
|
-
:param _Sharpness:
|
4628
|
-
|
4629
|
-
|
4774
|
+
:param _Sharpness: 清晰分。
|
4775
|
+
- 取值范围:[0,100],评价图片清晰程度,分数越高越清晰。
|
4776
|
+
- 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
4777
|
+
- 建议:人脸入库选取80以上的图片。
|
4630
4778
|
注意:此字段可能返回 null,表示取不到有效值。
|
4631
4779
|
:type Sharpness: int
|
4632
|
-
:param _Brightness:
|
4633
|
-
|
4634
|
-
|
4780
|
+
:param _Brightness: 光照分。
|
4781
|
+
- 取值范围:[0,100],评价图片光照程度,分数越高越亮。
|
4782
|
+
- 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
4783
|
+
- 建议:人脸入库选取[30,70]的图片。
|
4635
4784
|
注意:此字段可能返回 null,表示取不到有效值。
|
4636
4785
|
:type Brightness: int
|
4637
4786
|
:param _Completeness: 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
|
@@ -4645,10 +4794,11 @@ class FaceQualityInfo(AbstractModel):
|
|
4645
4794
|
|
4646
4795
|
@property
|
4647
4796
|
def Score(self):
|
4648
|
-
"""
|
4649
|
-
|
4650
|
-
|
4651
|
-
|
4797
|
+
"""质量分。
|
4798
|
+
- 取值范围:[0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
|
4799
|
+
- 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
|
4800
|
+
- 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
|
4801
|
+
- 建议:人脸入库选取70以上的图片。
|
4652
4802
|
注意:此字段可能返回 null,表示取不到有效值。
|
4653
4803
|
:rtype: int
|
4654
4804
|
"""
|
@@ -4660,9 +4810,10 @@ class FaceQualityInfo(AbstractModel):
|
|
4660
4810
|
|
4661
4811
|
@property
|
4662
4812
|
def Sharpness(self):
|
4663
|
-
"""
|
4664
|
-
|
4665
|
-
|
4813
|
+
"""清晰分。
|
4814
|
+
- 取值范围:[0,100],评价图片清晰程度,分数越高越清晰。
|
4815
|
+
- 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
|
4816
|
+
- 建议:人脸入库选取80以上的图片。
|
4666
4817
|
注意:此字段可能返回 null,表示取不到有效值。
|
4667
4818
|
:rtype: int
|
4668
4819
|
"""
|
@@ -4674,9 +4825,10 @@ class FaceQualityInfo(AbstractModel):
|
|
4674
4825
|
|
4675
4826
|
@property
|
4676
4827
|
def Brightness(self):
|
4677
|
-
"""
|
4678
|
-
|
4679
|
-
|
4828
|
+
"""光照分。
|
4829
|
+
- 取值范围:[0,100],评价图片光照程度,分数越高越亮。
|
4830
|
+
- 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
|
4831
|
+
- 建议:人脸入库选取[30,70]的图片。
|
4680
4832
|
注意:此字段可能返回 null,表示取不到有效值。
|
4681
4833
|
:rtype: int
|
4682
4834
|
"""
|
@@ -4724,16 +4876,16 @@ class FaceRect(AbstractModel):
|
|
4724
4876
|
def __init__(self):
|
4725
4877
|
r"""
|
4726
4878
|
:param _X: 人脸框左上角横坐标。
|
4727
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4728
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4879
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4880
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4729
4881
|
:type X: int
|
4730
4882
|
:param _Y: 人脸框左上角纵坐标。
|
4731
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4732
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4883
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4884
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4733
4885
|
:type Y: int
|
4734
|
-
:param _Width:
|
4886
|
+
:param _Width: 人脸宽度。
|
4735
4887
|
:type Width: int
|
4736
|
-
:param _Height:
|
4888
|
+
:param _Height: 人脸高度。
|
4737
4889
|
:type Height: int
|
4738
4890
|
"""
|
4739
4891
|
self._X = None
|
@@ -4744,8 +4896,8 @@ class FaceRect(AbstractModel):
|
|
4744
4896
|
@property
|
4745
4897
|
def X(self):
|
4746
4898
|
"""人脸框左上角横坐标。
|
4747
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4748
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4899
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4900
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4749
4901
|
:rtype: int
|
4750
4902
|
"""
|
4751
4903
|
return self._X
|
@@ -4757,8 +4909,8 @@ class FaceRect(AbstractModel):
|
|
4757
4909
|
@property
|
4758
4910
|
def Y(self):
|
4759
4911
|
"""人脸框左上角纵坐标。
|
4760
|
-
人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4761
|
-
若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4912
|
+
- 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
|
4913
|
+
- 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
|
4762
4914
|
:rtype: int
|
4763
4915
|
"""
|
4764
4916
|
return self._Y
|
@@ -4769,7 +4921,7 @@ class FaceRect(AbstractModel):
|
|
4769
4921
|
|
4770
4922
|
@property
|
4771
4923
|
def Width(self):
|
4772
|
-
"""
|
4924
|
+
"""人脸宽度。
|
4773
4925
|
:rtype: int
|
4774
4926
|
"""
|
4775
4927
|
return self._Width
|
@@ -4780,7 +4932,7 @@ class FaceRect(AbstractModel):
|
|
4780
4932
|
|
4781
4933
|
@property
|
4782
4934
|
def Height(self):
|
4783
|
-
"""
|
4935
|
+
"""人脸高度。
|
4784
4936
|
:rtype: int
|
4785
4937
|
"""
|
4786
4938
|
return self._Height
|
@@ -6163,9 +6315,9 @@ class GroupExDescriptionInfo(AbstractModel):
|
|
6163
6315
|
|
6164
6316
|
def __init__(self):
|
6165
6317
|
r"""
|
6166
|
-
:param _GroupExDescriptionIndex: 人员库自定义描述字段Index,从0
|
6318
|
+
:param _GroupExDescriptionIndex: 人员库自定义描述字段Index,从0开始。
|
6167
6319
|
:type GroupExDescriptionIndex: int
|
6168
|
-
:param _GroupExDescription:
|
6320
|
+
:param _GroupExDescription: 需要更新的人员库自定义描述字段内容。
|
6169
6321
|
:type GroupExDescription: str
|
6170
6322
|
"""
|
6171
6323
|
self._GroupExDescriptionIndex = None
|
@@ -6173,7 +6325,7 @@ class GroupExDescriptionInfo(AbstractModel):
|
|
6173
6325
|
|
6174
6326
|
@property
|
6175
6327
|
def GroupExDescriptionIndex(self):
|
6176
|
-
"""人员库自定义描述字段Index,从0
|
6328
|
+
"""人员库自定义描述字段Index,从0开始。
|
6177
6329
|
:rtype: int
|
6178
6330
|
"""
|
6179
6331
|
return self._GroupExDescriptionIndex
|
@@ -6184,7 +6336,7 @@ class GroupExDescriptionInfo(AbstractModel):
|
|
6184
6336
|
|
6185
6337
|
@property
|
6186
6338
|
def GroupExDescription(self):
|
6187
|
-
"""
|
6339
|
+
"""需要更新的人员库自定义描述字段内容。
|
6188
6340
|
:rtype: str
|
6189
6341
|
"""
|
6190
6342
|
return self._GroupExDescription
|
@@ -6214,21 +6366,23 @@ class GroupInfo(AbstractModel):
|
|
6214
6366
|
|
6215
6367
|
def __init__(self):
|
6216
6368
|
r"""
|
6217
|
-
:param _GroupName:
|
6369
|
+
:param _GroupName: 人员库名称。
|
6218
6370
|
:type GroupName: str
|
6219
|
-
:param _GroupId: 人员库ID
|
6371
|
+
:param _GroupId: 人员库ID。
|
6220
6372
|
:type GroupId: str
|
6221
|
-
:param _GroupExDescriptions:
|
6373
|
+
:param _GroupExDescriptions: 人员库自定义描述字段。
|
6222
6374
|
注意:此字段可能返回 null,表示取不到有效值。
|
6223
6375
|
:type GroupExDescriptions: list of str
|
6224
|
-
:param _Tag:
|
6376
|
+
:param _Tag: 人员库信息备注。
|
6225
6377
|
注意:此字段可能返回 null,表示取不到有效值。
|
6226
6378
|
:type Tag: str
|
6227
6379
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
6228
6380
|
注意:此字段可能返回 null,表示取不到有效值。
|
6229
6381
|
:type FaceModelVersion: str
|
6230
|
-
:param _CreationTimestamp: Group的创建时间和日期 CreationTimestamp。
|
6231
|
-
|
6382
|
+
:param _CreationTimestamp: Group的创建时间和日期 CreationTimestamp。
|
6383
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
6384
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
6385
|
+
- 有关更多信息,请参阅 Unix 时间。
|
6232
6386
|
注意:此字段可能返回 null,表示取不到有效值。
|
6233
6387
|
:type CreationTimestamp: int
|
6234
6388
|
"""
|
@@ -6241,7 +6395,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
6241
6395
|
|
6242
6396
|
@property
|
6243
6397
|
def GroupName(self):
|
6244
|
-
"""
|
6398
|
+
"""人员库名称。
|
6245
6399
|
:rtype: str
|
6246
6400
|
"""
|
6247
6401
|
return self._GroupName
|
@@ -6252,7 +6406,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
6252
6406
|
|
6253
6407
|
@property
|
6254
6408
|
def GroupId(self):
|
6255
|
-
"""人员库ID
|
6409
|
+
"""人员库ID。
|
6256
6410
|
:rtype: str
|
6257
6411
|
"""
|
6258
6412
|
return self._GroupId
|
@@ -6263,7 +6417,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
6263
6417
|
|
6264
6418
|
@property
|
6265
6419
|
def GroupExDescriptions(self):
|
6266
|
-
"""
|
6420
|
+
"""人员库自定义描述字段。
|
6267
6421
|
注意:此字段可能返回 null,表示取不到有效值。
|
6268
6422
|
:rtype: list of str
|
6269
6423
|
"""
|
@@ -6275,7 +6429,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
6275
6429
|
|
6276
6430
|
@property
|
6277
6431
|
def Tag(self):
|
6278
|
-
"""
|
6432
|
+
"""人员库信息备注。
|
6279
6433
|
注意:此字段可能返回 null,表示取不到有效值。
|
6280
6434
|
:rtype: str
|
6281
6435
|
"""
|
@@ -6299,8 +6453,10 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
6299
6453
|
|
6300
6454
|
@property
|
6301
6455
|
def CreationTimestamp(self):
|
6302
|
-
"""Group的创建时间和日期 CreationTimestamp。
|
6303
|
-
|
6456
|
+
"""Group的创建时间和日期 CreationTimestamp。
|
6457
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
|
6458
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
6459
|
+
- 有关更多信息,请参阅 Unix 时间。
|
6304
6460
|
注意:此字段可能返回 null,表示取不到有效值。
|
6305
6461
|
:rtype: int
|
6306
6462
|
"""
|
@@ -6885,9 +7041,9 @@ class PersonExDescriptionInfo(AbstractModel):
|
|
6885
7041
|
|
6886
7042
|
def __init__(self):
|
6887
7043
|
r"""
|
6888
|
-
:param _PersonExDescriptionIndex: 人员描述字段Index,从0
|
7044
|
+
:param _PersonExDescriptionIndex: 人员描述字段Index,从0开始。
|
6889
7045
|
:type PersonExDescriptionIndex: int
|
6890
|
-
:param _PersonExDescription:
|
7046
|
+
:param _PersonExDescription: 需要更新的人员描述字段内容。
|
6891
7047
|
:type PersonExDescription: str
|
6892
7048
|
"""
|
6893
7049
|
self._PersonExDescriptionIndex = None
|
@@ -6895,7 +7051,7 @@ class PersonExDescriptionInfo(AbstractModel):
|
|
6895
7051
|
|
6896
7052
|
@property
|
6897
7053
|
def PersonExDescriptionIndex(self):
|
6898
|
-
"""人员描述字段Index,从0
|
7054
|
+
"""人员描述字段Index,从0开始。
|
6899
7055
|
:rtype: int
|
6900
7056
|
"""
|
6901
7057
|
return self._PersonExDescriptionIndex
|
@@ -6906,7 +7062,7 @@ class PersonExDescriptionInfo(AbstractModel):
|
|
6906
7062
|
|
6907
7063
|
@property
|
6908
7064
|
def PersonExDescription(self):
|
6909
|
-
"""
|
7065
|
+
"""需要更新的人员描述字段内容。
|
6910
7066
|
:rtype: str
|
6911
7067
|
"""
|
6912
7068
|
return self._PersonExDescription
|
@@ -6936,9 +7092,9 @@ class PersonGroupInfo(AbstractModel):
|
|
6936
7092
|
|
6937
7093
|
def __init__(self):
|
6938
7094
|
r"""
|
6939
|
-
:param _GroupId: 包含此人员的人员库ID
|
7095
|
+
:param _GroupId: 包含此人员的人员库ID。
|
6940
7096
|
:type GroupId: str
|
6941
|
-
:param _PersonExDescriptions:
|
7097
|
+
:param _PersonExDescriptions: 人员描述字段内容。
|
6942
7098
|
:type PersonExDescriptions: list of str
|
6943
7099
|
"""
|
6944
7100
|
self._GroupId = None
|
@@ -6946,7 +7102,7 @@ class PersonGroupInfo(AbstractModel):
|
|
6946
7102
|
|
6947
7103
|
@property
|
6948
7104
|
def GroupId(self):
|
6949
|
-
"""包含此人员的人员库ID
|
7105
|
+
"""包含此人员的人员库ID。
|
6950
7106
|
:rtype: str
|
6951
7107
|
"""
|
6952
7108
|
return self._GroupId
|
@@ -6957,7 +7113,7 @@ class PersonGroupInfo(AbstractModel):
|
|
6957
7113
|
|
6958
7114
|
@property
|
6959
7115
|
def PersonExDescriptions(self):
|
6960
|
-
"""
|
7116
|
+
"""人员描述字段内容。
|
6961
7117
|
:rtype: list of str
|
6962
7118
|
"""
|
6963
7119
|
return self._PersonExDescriptions
|
@@ -6987,18 +7143,20 @@ class PersonInfo(AbstractModel):
|
|
6987
7143
|
|
6988
7144
|
def __init__(self):
|
6989
7145
|
r"""
|
6990
|
-
:param _PersonName:
|
7146
|
+
:param _PersonName: 人员名称。
|
6991
7147
|
:type PersonName: str
|
6992
|
-
:param _PersonId: 人员Id
|
7148
|
+
:param _PersonId: 人员Id。
|
6993
7149
|
:type PersonId: str
|
6994
|
-
:param _Gender:
|
7150
|
+
:param _Gender: 人员性别。
|
6995
7151
|
:type Gender: int
|
6996
|
-
:param _PersonExDescriptions:
|
7152
|
+
:param _PersonExDescriptions: 人员描述字段内容。
|
6997
7153
|
:type PersonExDescriptions: list of str
|
6998
|
-
:param _FaceIds:
|
7154
|
+
:param _FaceIds: 包含的人脸照片列表。
|
6999
7155
|
:type FaceIds: list of str
|
7000
|
-
:param _CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。
|
7001
|
-
|
7156
|
+
:param _CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。
|
7157
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
7158
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
7159
|
+
- 有关更多信息,请参阅 Unix 时间。
|
7002
7160
|
:type CreationTimestamp: int
|
7003
7161
|
"""
|
7004
7162
|
self._PersonName = None
|
@@ -7010,7 +7168,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7010
7168
|
|
7011
7169
|
@property
|
7012
7170
|
def PersonName(self):
|
7013
|
-
"""
|
7171
|
+
"""人员名称。
|
7014
7172
|
:rtype: str
|
7015
7173
|
"""
|
7016
7174
|
return self._PersonName
|
@@ -7021,7 +7179,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7021
7179
|
|
7022
7180
|
@property
|
7023
7181
|
def PersonId(self):
|
7024
|
-
"""人员Id
|
7182
|
+
"""人员Id。
|
7025
7183
|
:rtype: str
|
7026
7184
|
"""
|
7027
7185
|
return self._PersonId
|
@@ -7032,7 +7190,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7032
7190
|
|
7033
7191
|
@property
|
7034
7192
|
def Gender(self):
|
7035
|
-
"""
|
7193
|
+
"""人员性别。
|
7036
7194
|
:rtype: int
|
7037
7195
|
"""
|
7038
7196
|
return self._Gender
|
@@ -7043,7 +7201,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7043
7201
|
|
7044
7202
|
@property
|
7045
7203
|
def PersonExDescriptions(self):
|
7046
|
-
"""
|
7204
|
+
"""人员描述字段内容。
|
7047
7205
|
:rtype: list of str
|
7048
7206
|
"""
|
7049
7207
|
return self._PersonExDescriptions
|
@@ -7054,7 +7212,7 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7054
7212
|
|
7055
7213
|
@property
|
7056
7214
|
def FaceIds(self):
|
7057
|
-
"""
|
7215
|
+
"""包含的人脸照片列表。
|
7058
7216
|
:rtype: list of str
|
7059
7217
|
"""
|
7060
7218
|
return self._FaceIds
|
@@ -7065,8 +7223,10 @@ Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00
|
|
7065
7223
|
|
7066
7224
|
@property
|
7067
7225
|
def CreationTimestamp(self):
|
7068
|
-
"""人员的创建时间和日期 CreationTimestamp。
|
7069
|
-
|
7226
|
+
"""人员的创建时间和日期 CreationTimestamp。
|
7227
|
+
- CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
|
7228
|
+
- Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
|
7229
|
+
- 有关更多信息,请参阅 Unix 时间。
|
7070
7230
|
:rtype: int
|
7071
7231
|
"""
|
7072
7232
|
return self._CreationTimestamp
|
@@ -7100,9 +7260,9 @@ class Point(AbstractModel):
|
|
7100
7260
|
|
7101
7261
|
def __init__(self):
|
7102
7262
|
r"""
|
7103
|
-
:param _X: x
|
7263
|
+
:param _X: x坐标。
|
7104
7264
|
:type X: int
|
7105
|
-
:param _Y: Y
|
7265
|
+
:param _Y: Y坐标。
|
7106
7266
|
:type Y: int
|
7107
7267
|
"""
|
7108
7268
|
self._X = None
|
@@ -7110,7 +7270,7 @@ class Point(AbstractModel):
|
|
7110
7270
|
|
7111
7271
|
@property
|
7112
7272
|
def X(self):
|
7113
|
-
"""x
|
7273
|
+
"""x坐标。
|
7114
7274
|
:rtype: int
|
7115
7275
|
"""
|
7116
7276
|
return self._X
|
@@ -7121,7 +7281,7 @@ class Point(AbstractModel):
|
|
7121
7281
|
|
7122
7282
|
@property
|
7123
7283
|
def Y(self):
|
7124
|
-
"""Y
|
7284
|
+
"""Y坐标。
|
7125
7285
|
:rtype: int
|
7126
7286
|
"""
|
7127
7287
|
return self._Y
|
@@ -7151,12 +7311,13 @@ class Result(AbstractModel):
|
|
7151
7311
|
|
7152
7312
|
def __init__(self):
|
7153
7313
|
r"""
|
7154
|
-
:param _Candidates:
|
7314
|
+
:param _Candidates: 识别出的最相似候选人。
|
7155
7315
|
:type Candidates: list of Candidate
|
7156
|
-
:param _FaceRect:
|
7316
|
+
:param _FaceRect: 检测出的人脸框位置。
|
7157
7317
|
:type FaceRect: :class:`tencentcloud.iai.v20200303.models.FaceRect`
|
7158
|
-
:param _RetCode: 检测出的人脸图片状态返回码。
|
7159
|
-
-
|
7318
|
+
:param _RetCode: 检测出的人脸图片状态返回码。
|
7319
|
+
- 0 表示正常。
|
7320
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
7160
7321
|
:type RetCode: int
|
7161
7322
|
"""
|
7162
7323
|
self._Candidates = None
|
@@ -7165,7 +7326,7 @@ class Result(AbstractModel):
|
|
7165
7326
|
|
7166
7327
|
@property
|
7167
7328
|
def Candidates(self):
|
7168
|
-
"""
|
7329
|
+
"""识别出的最相似候选人。
|
7169
7330
|
:rtype: list of Candidate
|
7170
7331
|
"""
|
7171
7332
|
return self._Candidates
|
@@ -7176,7 +7337,7 @@ class Result(AbstractModel):
|
|
7176
7337
|
|
7177
7338
|
@property
|
7178
7339
|
def FaceRect(self):
|
7179
|
-
"""
|
7340
|
+
"""检测出的人脸框位置。
|
7180
7341
|
:rtype: :class:`tencentcloud.iai.v20200303.models.FaceRect`
|
7181
7342
|
"""
|
7182
7343
|
return self._FaceRect
|
@@ -7187,8 +7348,9 @@ class Result(AbstractModel):
|
|
7187
7348
|
|
7188
7349
|
@property
|
7189
7350
|
def RetCode(self):
|
7190
|
-
"""检测出的人脸图片状态返回码。
|
7191
|
-
-
|
7351
|
+
"""检测出的人脸图片状态返回码。
|
7352
|
+
- 0 表示正常。
|
7353
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
7192
7354
|
:rtype: int
|
7193
7355
|
"""
|
7194
7356
|
return self._RetCode
|
@@ -7230,8 +7392,9 @@ class ResultsReturnsByGroup(AbstractModel):
|
|
7230
7392
|
:type FaceRect: :class:`tencentcloud.iai.v20200303.models.FaceRect`
|
7231
7393
|
:param _GroupCandidates: 识别结果。
|
7232
7394
|
:type GroupCandidates: list of GroupCandidate
|
7233
|
-
:param _RetCode: 检测出的人脸图片状态返回码。
|
7234
|
-
-
|
7395
|
+
:param _RetCode: 检测出的人脸图片状态返回码。
|
7396
|
+
- 0 表示正常。
|
7397
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
7235
7398
|
:type RetCode: int
|
7236
7399
|
"""
|
7237
7400
|
self._FaceRect = None
|
@@ -7262,8 +7425,9 @@ class ResultsReturnsByGroup(AbstractModel):
|
|
7262
7425
|
|
7263
7426
|
@property
|
7264
7427
|
def RetCode(self):
|
7265
|
-
"""检测出的人脸图片状态返回码。
|
7266
|
-
-
|
7428
|
+
"""检测出的人脸图片状态返回码。
|
7429
|
+
- 0 表示正常。
|
7430
|
+
- -1601代表不符合图片质量控制要求,此时Candidate内容为空。
|
7267
7431
|
:rtype: int
|
7268
7432
|
"""
|
7269
7433
|
return self._RetCode
|
@@ -8726,29 +8890,38 @@ class VerifyFaceRequest(AbstractModel):
|
|
8726
8890
|
r"""
|
8727
8891
|
:param _PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
8728
8892
|
:type PersonId: str
|
8729
|
-
:param _Image: 图片 base64
|
8730
|
-
|
8731
|
-
|
8732
|
-
|
8893
|
+
:param _Image: 图片 base64 数据。
|
8894
|
+
- base64 编码后大小不可超过5M。
|
8895
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8896
|
+
- 所有格式的图片短边像素不小于64。
|
8897
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8898
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8733
8899
|
:type Image: str
|
8734
|
-
:param _Url: 图片的 Url
|
8735
|
-
|
8736
|
-
|
8737
|
-
|
8738
|
-
|
8739
|
-
|
8740
|
-
|
8900
|
+
:param _Url: 图片的 Url 。
|
8901
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8902
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8903
|
+
- 所有格式的图片短边像素不小于64。
|
8904
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8905
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8906
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8907
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8908
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8741
8909
|
:type Url: str
|
8742
8910
|
:param _QualityControl: 图片质量控制。
|
8743
|
-
|
8744
|
-
|
8745
|
-
|
8746
|
-
|
8747
|
-
|
8748
|
-
|
8749
|
-
|
8911
|
+
- 取值范围:
|
8912
|
+
0: 不进行控制。
|
8913
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8914
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8915
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8916
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8917
|
+
- 默认 0。
|
8918
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8750
8919
|
:type QualityControl: int
|
8751
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8920
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8921
|
+
- 取值范围:0为不开启,1为开启。
|
8922
|
+
- 默认为0。
|
8923
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8924
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8752
8925
|
:type NeedRotateDetection: int
|
8753
8926
|
"""
|
8754
8927
|
self._PersonId = None
|
@@ -8770,10 +8943,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
8770
8943
|
|
8771
8944
|
@property
|
8772
8945
|
def Image(self):
|
8773
|
-
"""图片 base64
|
8774
|
-
|
8775
|
-
|
8776
|
-
|
8946
|
+
"""图片 base64 数据。
|
8947
|
+
- base64 编码后大小不可超过5M。
|
8948
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8949
|
+
- 所有格式的图片短边像素不小于64。
|
8950
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8951
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8777
8952
|
:rtype: str
|
8778
8953
|
"""
|
8779
8954
|
return self._Image
|
@@ -8784,13 +8959,15 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
8784
8959
|
|
8785
8960
|
@property
|
8786
8961
|
def Url(self):
|
8787
|
-
"""图片的 Url
|
8788
|
-
|
8789
|
-
|
8790
|
-
|
8791
|
-
|
8792
|
-
|
8793
|
-
|
8962
|
+
"""图片的 Url 。
|
8963
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8964
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8965
|
+
- 所有格式的图片短边像素不小于64。
|
8966
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8967
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8968
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8969
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8970
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8794
8971
|
:rtype: str
|
8795
8972
|
"""
|
8796
8973
|
return self._Url
|
@@ -8802,13 +8979,14 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
8802
8979
|
@property
|
8803
8980
|
def QualityControl(self):
|
8804
8981
|
"""图片质量控制。
|
8805
|
-
|
8806
|
-
|
8807
|
-
|
8808
|
-
|
8809
|
-
|
8810
|
-
|
8811
|
-
|
8982
|
+
- 取值范围:
|
8983
|
+
0: 不进行控制。
|
8984
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8985
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8986
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8987
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8988
|
+
- 默认 0。
|
8989
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8812
8990
|
:rtype: int
|
8813
8991
|
"""
|
8814
8992
|
return self._QualityControl
|
@@ -8819,7 +8997,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
8819
8997
|
|
8820
8998
|
@property
|
8821
8999
|
def NeedRotateDetection(self):
|
8822
|
-
"""是否开启图片旋转识别支持。
|
9000
|
+
"""是否开启图片旋转识别支持。
|
9001
|
+
- 取值范围:0为不开启,1为开启。
|
9002
|
+
- 默认为0。
|
9003
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
9004
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8823
9005
|
:rtype: int
|
8824
9006
|
"""
|
8825
9007
|
return self._NeedRotateDetection
|
@@ -8852,15 +9034,16 @@ class VerifyFaceResponse(AbstractModel):
|
|
8852
9034
|
|
8853
9035
|
def __init__(self):
|
8854
9036
|
r"""
|
8855
|
-
:param _Score: 给定的人脸图片与 PersonId
|
8856
|
-
|
8857
|
-
不同算法版本返回的相似度分数不同。
|
8858
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
8859
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
9037
|
+
:param _Score: 给定的人脸图片与 PersonId 对应人脸的相似度。
|
9038
|
+
- 若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
9039
|
+
- 不同算法版本返回的相似度分数不同。
|
9040
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
9041
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
8860
9042
|
:type Score: float
|
8861
|
-
:param _IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score
|
9043
|
+
:param _IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断。
|
8862
9044
|
:type IsMatch: bool
|
8863
|
-
:param _FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person
|
9045
|
+
:param _FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
9046
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
8864
9047
|
:type FaceModelVersion: str
|
8865
9048
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
8866
9049
|
:type RequestId: str
|
@@ -8872,11 +9055,11 @@ class VerifyFaceResponse(AbstractModel):
|
|
8872
9055
|
|
8873
9056
|
@property
|
8874
9057
|
def Score(self):
|
8875
|
-
"""给定的人脸图片与 PersonId
|
8876
|
-
|
8877
|
-
不同算法版本返回的相似度分数不同。
|
8878
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
8879
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
9058
|
+
"""给定的人脸图片与 PersonId 对应人脸的相似度。
|
9059
|
+
- 若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
|
9060
|
+
- 不同算法版本返回的相似度分数不同。
|
9061
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
9062
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
8880
9063
|
:rtype: float
|
8881
9064
|
"""
|
8882
9065
|
return self._Score
|
@@ -8887,7 +9070,7 @@ class VerifyFaceResponse(AbstractModel):
|
|
8887
9070
|
|
8888
9071
|
@property
|
8889
9072
|
def IsMatch(self):
|
8890
|
-
"""是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score
|
9073
|
+
"""是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断。
|
8891
9074
|
:rtype: bool
|
8892
9075
|
"""
|
8893
9076
|
return self._IsMatch
|
@@ -8898,7 +9081,8 @@ class VerifyFaceResponse(AbstractModel):
|
|
8898
9081
|
|
8899
9082
|
@property
|
8900
9083
|
def FaceModelVersion(self):
|
8901
|
-
"""人脸识别所用的算法模型版本,是该 Person
|
9084
|
+
"""人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
9085
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
8902
9086
|
:rtype: str
|
8903
9087
|
"""
|
8904
9088
|
return self._FaceModelVersion
|
@@ -8936,28 +9120,35 @@ class VerifyPersonRequest(AbstractModel):
|
|
8936
9120
|
:param _PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
|
8937
9121
|
:type PersonId: str
|
8938
9122
|
:param _Image: 图片 base64 数据。
|
8939
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8940
|
-
|
8941
|
-
|
9123
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
9124
|
+
- 所有格式的图片短边像素不小于64。
|
9125
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
9126
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8942
9127
|
:type Image: str
|
8943
9128
|
:param _Url: 图片的 Url
|
8944
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
|
8945
|
-
|
8946
|
-
|
8947
|
-
|
8948
|
-
|
8949
|
-
|
9129
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
9130
|
+
- 所有格式的图片短边像素不小于64。
|
9131
|
+
- 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
9132
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
9133
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
9134
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
9135
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8950
9136
|
:type Url: str
|
8951
9137
|
:param _QualityControl: 图片质量控制。
|
8952
|
-
|
8953
|
-
|
8954
|
-
|
8955
|
-
|
8956
|
-
|
8957
|
-
|
8958
|
-
|
9138
|
+
- 取值范围:
|
9139
|
+
0: 不进行控制。
|
9140
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
9141
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
9142
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
9143
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
9144
|
+
- 默认 0。
|
9145
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8959
9146
|
:type QualityControl: int
|
8960
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
9147
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
9148
|
+
- 取值范围:0为不开启,1为开启。
|
9149
|
+
- 默认为0。
|
9150
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
9151
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8961
9152
|
:type NeedRotateDetection: int
|
8962
9153
|
"""
|
8963
9154
|
self._PersonId = None
|
@@ -8980,9 +9171,10 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
8980
9171
|
@property
|
8981
9172
|
def Image(self):
|
8982
9173
|
"""图片 base64 数据。
|
8983
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8984
|
-
|
8985
|
-
|
9174
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
9175
|
+
- 所有格式的图片短边像素不小于64。
|
9176
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
9177
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8986
9178
|
:rtype: str
|
8987
9179
|
"""
|
8988
9180
|
return self._Image
|
@@ -8994,12 +9186,13 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
8994
9186
|
@property
|
8995
9187
|
def Url(self):
|
8996
9188
|
"""图片的 Url
|
8997
|
-
jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
|
8998
|
-
|
8999
|
-
|
9000
|
-
|
9001
|
-
|
9002
|
-
|
9189
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
9190
|
+
- 所有格式的图片短边像素不小于64。
|
9191
|
+
- 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
9192
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
9193
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
9194
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
9195
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
9003
9196
|
:rtype: str
|
9004
9197
|
"""
|
9005
9198
|
return self._Url
|
@@ -9011,13 +9204,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
9011
9204
|
@property
|
9012
9205
|
def QualityControl(self):
|
9013
9206
|
"""图片质量控制。
|
9014
|
-
|
9015
|
-
|
9016
|
-
|
9017
|
-
|
9018
|
-
|
9019
|
-
|
9020
|
-
|
9207
|
+
- 取值范围:
|
9208
|
+
0: 不进行控制。
|
9209
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
9210
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
9211
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
9212
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
9213
|
+
- 默认 0。
|
9214
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
9021
9215
|
:rtype: int
|
9022
9216
|
"""
|
9023
9217
|
return self._QualityControl
|
@@ -9028,7 +9222,11 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
9028
9222
|
|
9029
9223
|
@property
|
9030
9224
|
def NeedRotateDetection(self):
|
9031
|
-
"""是否开启图片旋转识别支持。
|
9225
|
+
"""是否开启图片旋转识别支持。
|
9226
|
+
- 取值范围:0为不开启,1为开启。
|
9227
|
+
- 默认为0。
|
9228
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
9229
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
9032
9230
|
:rtype: int
|
9033
9231
|
"""
|
9034
9232
|
return self._NeedRotateDetection
|
@@ -9065,7 +9263,8 @@ class VerifyPersonResponse(AbstractModel):
|
|
9065
9263
|
:type Score: float
|
9066
9264
|
:param _IsMatch: 是否为同一人的判断。
|
9067
9265
|
:type IsMatch: bool
|
9068
|
-
:param _FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person
|
9266
|
+
:param _FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
9267
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
9069
9268
|
:type FaceModelVersion: str
|
9070
9269
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
9071
9270
|
:type RequestId: str
|
@@ -9099,7 +9298,8 @@ class VerifyPersonResponse(AbstractModel):
|
|
9099
9298
|
|
9100
9299
|
@property
|
9101
9300
|
def FaceModelVersion(self):
|
9102
|
-
"""人脸识别所用的算法模型版本,是该 Person
|
9301
|
+
"""人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
|
9302
|
+
- 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
|
9103
9303
|
:rtype: str
|
9104
9304
|
"""
|
9105
9305
|
return self._FaceModelVersion
|