tencentcloud-sdk-python 3.0.1265__py2.py3-none-any.whl → 3.0.1267__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/apm/v20210622/models.py +128 -0
- tencentcloud/asr/v20190614/models.py +2 -2
- tencentcloud/autoscaling/v20180419/models.py +65 -6
- tencentcloud/batch/v20170312/models.py +20 -2
- tencentcloud/cat/v20180409/models.py +20 -0
- tencentcloud/cbs/v20170312/models.py +124 -70
- tencentcloud/ccc/v20200210/models.py +125 -0
- tencentcloud/cdb/v20170320/cdb_client.py +2 -2
- tencentcloud/cdb/v20170320/errorcodes.py +1 -1
- tencentcloud/cdb/v20170320/models.py +17 -6
- tencentcloud/cdc/v20201214/models.py +2 -54
- tencentcloud/cdz/v20221123/models.py +75 -1
- tencentcloud/ckafka/v20190819/models.py +67 -22
- tencentcloud/clb/v20180317/clb_client.py +1 -1
- tencentcloud/clb/v20180317/models.py +54 -20
- tencentcloud/cloudstudio/v20230508/models.py +0 -18
- tencentcloud/cls/v20201016/models.py +91 -0
- tencentcloud/cvm/v20170312/models.py +99 -22
- tencentcloud/cwp/v20180228/cwp_client.py +0 -25
- tencentcloud/cwp/v20180228/models.py +0 -197
- tencentcloud/dasb/v20191018/models.py +150 -0
- tencentcloud/emr/v20190103/emr_client.py +9 -9
- tencentcloud/emr/v20190103/models.py +325 -1
- tencentcloud/es/v20180416/errorcodes.py +3 -0
- tencentcloud/es/v20180416/models.py +30 -0
- tencentcloud/ess/v20201111/ess_client.py +22 -30
- tencentcloud/ess/v20201111/models.py +59 -14
- tencentcloud/essbasic/v20210526/essbasic_client.py +34 -8
- tencentcloud/essbasic/v20210526/models.py +77 -28
- tencentcloud/faceid/v20180301/models.py +983 -539
- tencentcloud/gme/v20180711/errorcodes.py +9 -0
- tencentcloud/gme/v20180711/models.py +17 -2
- tencentcloud/hai/v20230812/models.py +2 -2
- tencentcloud/hunyuan/v20230901/models.py +30 -0
- tencentcloud/iai/v20180301/models.py +40 -26
- tencentcloud/iai/v20200303/models.py +760 -546
- tencentcloud/iotexplorer/v20190423/errorcodes.py +1 -1
- tencentcloud/iotexplorer/v20190423/models.py +8 -8
- tencentcloud/iotvideo/v20191126/models.py +4 -4
- tencentcloud/lke/v20231130/models.py +12 -12
- tencentcloud/monitor/v20180724/models.py +17 -0
- tencentcloud/mrs/v20200910/models.py +27 -8
- tencentcloud/ms/v20180408/ms_client.py +3 -1
- tencentcloud/ocr/v20181119/models.py +519 -14
- tencentcloud/ocr/v20181119/ocr_client.py +49 -2
- tencentcloud/omics/v20221128/models.py +100 -232
- tencentcloud/partners/v20180321/models.py +2 -92
- tencentcloud/rce/v20201103/errorcodes.py +132 -0
- tencentcloud/rce/v20201103/models.py +261 -0
- tencentcloud/rce/v20201103/rce_client.py +23 -0
- tencentcloud/redis/v20180412/models.py +2 -6
- tencentcloud/rum/v20210622/models.py +15 -0
- tencentcloud/scf/v20180416/models.py +2 -2
- tencentcloud/ssl/v20191205/models.py +2 -2
- tencentcloud/tdmq/v20200217/models.py +40 -10
- tencentcloud/tds/v20220801/models.py +4 -4
- tencentcloud/thpc/v20230321/models.py +2 -2
- tencentcloud/tke/v20180525/models.py +2 -4
- tencentcloud/tmt/v20180321/models.py +60 -5
- tencentcloud/trro/v20220325/models.py +0 -30
- tencentcloud/trtc/v20190722/models.py +97 -2
- tencentcloud/vclm/v20240523/models.py +170 -100
- tencentcloud/vclm/v20240523/vclm_client.py +52 -52
- tencentcloud/vod/v20180717/models.py +114 -2
- tencentcloud/vod/v20180717/vod_client.py +1 -1
- tencentcloud/vod/v20240718/models.py +15 -15
- tencentcloud/vpc/v20170312/errorcodes.py +3 -0
- tencentcloud/vpc/v20170312/models.py +167 -10
- tencentcloud/vpc/v20170312/vpc_client.py +7 -2
- tencentcloud/waf/v20180125/models.py +618 -0
- tencentcloud/waf/v20180125/waf_client.py +69 -0
- tencentcloud/wedata/v20210820/models.py +18 -18
- {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/METADATA +1 -1
- {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/RECORD +78 -78
- {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/LICENSE +0 -0
- {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/WHEEL +0 -0
- {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/top_level.txt +0 -0
@@ -666,52 +666,58 @@ class CompareFaceRequest(AbstractModel):
|
|
666
666
|
|
667
667
|
def __init__(self):
|
668
668
|
r"""
|
669
|
-
:param _ImageA: A 图片 base64
|
670
|
-
|
671
|
-
|
672
|
-
|
669
|
+
:param _ImageA: A 图片 base64 数据。
|
670
|
+
- base64 编码后大小不可超过5M。
|
671
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
672
|
+
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
673
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
673
674
|
:type ImageA: str
|
674
|
-
:param _ImageB: B 图片 base64
|
675
|
-
|
676
|
-
|
677
|
-
|
675
|
+
:param _ImageB: B 图片 base64 数据。
|
676
|
+
- base64 编码后大小不可超过5M。
|
677
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
678
|
+
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
679
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
678
680
|
:type ImageB: str
|
679
|
-
:param _UrlA: A 图片的 Url
|
680
|
-
|
681
|
-
|
682
|
-
|
683
|
-
|
684
|
-
|
685
|
-
|
681
|
+
:param _UrlA: A 图片的 Url。
|
682
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
683
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
684
|
+
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
685
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
686
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
687
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
688
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
686
689
|
:type UrlA: str
|
687
|
-
:param _UrlB: B 图片的 Url
|
688
|
-
|
689
|
-
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
|
690
|
+
:param _UrlB: B 图片的 Url 。
|
691
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
692
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
693
|
+
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
694
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
695
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
696
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
697
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
694
698
|
:type UrlB: str
|
695
699
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
696
|
-
|
697
|
-
|
698
|
-
|
699
|
-
|
700
|
-
|
701
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
702
|
-
|
703
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
700
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
701
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
702
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
703
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
704
704
|
:type FaceModelVersion: str
|
705
705
|
:param _QualityControl: 图片质量控制。
|
706
|
+
- 取值范围:
|
706
707
|
0: 不进行控制;
|
707
708
|
1: 较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
708
709
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
709
710
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
710
711
|
4: 很高的质量要求,各个维度均为最好或最多,在某一维度上存在轻微问题;
|
711
712
|
默认 0。
|
712
|
-
|
713
|
+
|
714
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
713
715
|
:type QualityControl: int
|
714
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
716
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
717
|
+
- 取值范围:0为不开启,1为开启。
|
718
|
+
- 默认为0。
|
719
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
720
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
715
721
|
:type NeedRotateDetection: int
|
716
722
|
"""
|
717
723
|
self._ImageA = None
|
@@ -724,10 +730,11 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
724
730
|
|
725
731
|
@property
|
726
732
|
def ImageA(self):
|
727
|
-
"""A 图片 base64
|
728
|
-
|
729
|
-
|
730
|
-
|
733
|
+
"""A 图片 base64 数据。
|
734
|
+
- base64 编码后大小不可超过5M。
|
735
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
736
|
+
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
737
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
731
738
|
:rtype: str
|
732
739
|
"""
|
733
740
|
return self._ImageA
|
@@ -738,10 +745,11 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
738
745
|
|
739
746
|
@property
|
740
747
|
def ImageB(self):
|
741
|
-
"""B 图片 base64
|
742
|
-
|
743
|
-
|
744
|
-
|
748
|
+
"""B 图片 base64 数据。
|
749
|
+
- base64 编码后大小不可超过5M。
|
750
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
751
|
+
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
|
752
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
745
753
|
:rtype: str
|
746
754
|
"""
|
747
755
|
return self._ImageB
|
@@ -752,13 +760,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
752
760
|
|
753
761
|
@property
|
754
762
|
def UrlA(self):
|
755
|
-
"""A 图片的 Url
|
756
|
-
|
757
|
-
|
758
|
-
|
759
|
-
|
760
|
-
|
761
|
-
|
763
|
+
"""A 图片的 Url。
|
764
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
765
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
766
|
+
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
767
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
768
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
769
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
770
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
762
771
|
:rtype: str
|
763
772
|
"""
|
764
773
|
return self._UrlA
|
@@ -769,13 +778,14 @@ A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
769
778
|
|
770
779
|
@property
|
771
780
|
def UrlB(self):
|
772
|
-
"""B 图片的 Url
|
773
|
-
|
774
|
-
|
775
|
-
|
776
|
-
|
777
|
-
|
778
|
-
|
781
|
+
"""B 图片的 Url 。
|
782
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
783
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
784
|
+
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
785
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
786
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
787
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
788
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
779
789
|
:rtype: str
|
780
790
|
"""
|
781
791
|
return self._UrlB
|
@@ -787,14 +797,10 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
787
797
|
@property
|
788
798
|
def FaceModelVersion(self):
|
789
799
|
"""人脸识别服务所用的算法模型版本。
|
790
|
-
|
791
|
-
|
792
|
-
|
793
|
-
|
794
|
-
|
795
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
796
|
-
|
797
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
800
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
801
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
802
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
803
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
798
804
|
:rtype: str
|
799
805
|
"""
|
800
806
|
return self._FaceModelVersion
|
@@ -806,13 +812,15 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
806
812
|
@property
|
807
813
|
def QualityControl(self):
|
808
814
|
"""图片质量控制。
|
815
|
+
- 取值范围:
|
809
816
|
0: 不进行控制;
|
810
817
|
1: 较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
811
818
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
812
819
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
813
820
|
4: 很高的质量要求,各个维度均为最好或最多,在某一维度上存在轻微问题;
|
814
821
|
默认 0。
|
815
|
-
|
822
|
+
|
823
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
816
824
|
:rtype: int
|
817
825
|
"""
|
818
826
|
return self._QualityControl
|
@@ -823,7 +831,11 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
823
831
|
|
824
832
|
@property
|
825
833
|
def NeedRotateDetection(self):
|
826
|
-
"""是否开启图片旋转识别支持。
|
834
|
+
"""是否开启图片旋转识别支持。
|
835
|
+
- 取值范围:0为不开启,1为开启。
|
836
|
+
- 默认为0。
|
837
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
838
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
827
839
|
:rtype: int
|
828
840
|
"""
|
829
841
|
return self._NeedRotateDetection
|
@@ -859,10 +871,10 @@ class CompareFaceResponse(AbstractModel):
|
|
859
871
|
def __init__(self):
|
860
872
|
r"""
|
861
873
|
:param _Score: 两张图片中人脸的相似度分数。
|
862
|
-
不同算法版本返回的相似度分数不同。
|
863
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
864
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
865
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
874
|
+
- 不同算法版本返回的相似度分数不同。
|
875
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
876
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
877
|
+
- 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
866
878
|
:type Score: float
|
867
879
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
868
880
|
:type FaceModelVersion: str
|
@@ -876,10 +888,10 @@ class CompareFaceResponse(AbstractModel):
|
|
876
888
|
@property
|
877
889
|
def Score(self):
|
878
890
|
"""两张图片中人脸的相似度分数。
|
879
|
-
不同算法版本返回的相似度分数不同。
|
880
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
881
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
882
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
891
|
+
- 不同算法版本返回的相似度分数不同。
|
892
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
893
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
894
|
+
- 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
883
895
|
:rtype: float
|
884
896
|
"""
|
885
897
|
return self._Score
|
@@ -924,42 +936,47 @@ class CompareMaskFaceRequest(AbstractModel):
|
|
924
936
|
|
925
937
|
def __init__(self):
|
926
938
|
r"""
|
927
|
-
:param _ImageA: A 图片 base64
|
928
|
-
|
929
|
-
|
930
|
-
|
939
|
+
:param _ImageA: A 图片 base64 数据。
|
940
|
+
- base64 编码后大小不可超过5M。
|
941
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
942
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
943
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
931
944
|
:type ImageA: str
|
932
|
-
:param _ImageB: B 图片 base64
|
933
|
-
|
934
|
-
|
935
|
-
|
945
|
+
:param _ImageB: B 图片 base64 数据。
|
946
|
+
- base64 编码后大小不可超过5M。
|
947
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
948
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
949
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
936
950
|
:type ImageB: str
|
937
|
-
:param _UrlA: A 图片的 Url
|
938
|
-
|
939
|
-
|
940
|
-
|
941
|
-
|
942
|
-
|
943
|
-
|
951
|
+
:param _UrlA: A 图片的 Url 。
|
952
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
953
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
954
|
+
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
955
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
956
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
957
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
958
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
944
959
|
:type UrlA: str
|
945
|
-
:param _UrlB: B 图片的 Url
|
946
|
-
|
947
|
-
|
948
|
-
|
949
|
-
|
950
|
-
|
951
|
-
|
960
|
+
:param _UrlB: B 图片的 Url 。
|
961
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
962
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
963
|
+
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
964
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
965
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
966
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
967
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
952
968
|
:type UrlB: str
|
953
969
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。该接口只支持"3.0"
|
954
970
|
:type FaceModelVersion: str
|
955
971
|
:param _QualityControl: 图片质量控制。
|
972
|
+
- 取值范围:
|
956
973
|
0: 不进行控制;
|
957
974
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
958
975
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
959
976
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
960
977
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
961
|
-
默认 0。
|
962
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
978
|
+
- 默认 0。
|
979
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
963
980
|
:type QualityControl: int
|
964
981
|
"""
|
965
982
|
self._ImageA = None
|
@@ -971,10 +988,11 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
971
988
|
|
972
989
|
@property
|
973
990
|
def ImageA(self):
|
974
|
-
"""A 图片 base64
|
975
|
-
|
976
|
-
|
977
|
-
|
991
|
+
"""A 图片 base64 数据。
|
992
|
+
- base64 编码后大小不可超过5M。
|
993
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
994
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
995
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
978
996
|
:rtype: str
|
979
997
|
"""
|
980
998
|
return self._ImageA
|
@@ -985,10 +1003,11 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
985
1003
|
|
986
1004
|
@property
|
987
1005
|
def ImageB(self):
|
988
|
-
"""B 图片 base64
|
989
|
-
|
990
|
-
|
991
|
-
|
1006
|
+
"""B 图片 base64 数据。
|
1007
|
+
- base64 编码后大小不可超过5M。
|
1008
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1009
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1010
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
992
1011
|
:rtype: str
|
993
1012
|
"""
|
994
1013
|
return self._ImageB
|
@@ -999,13 +1018,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
999
1018
|
|
1000
1019
|
@property
|
1001
1020
|
def UrlA(self):
|
1002
|
-
"""A 图片的 Url
|
1003
|
-
|
1004
|
-
|
1005
|
-
|
1006
|
-
|
1007
|
-
|
1008
|
-
|
1021
|
+
"""A 图片的 Url 。
|
1022
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1023
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1024
|
+
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
1025
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1026
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1027
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1028
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1009
1029
|
:rtype: str
|
1010
1030
|
"""
|
1011
1031
|
return self._UrlA
|
@@ -1016,13 +1036,14 @@ A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1016
1036
|
|
1017
1037
|
@property
|
1018
1038
|
def UrlB(self):
|
1019
|
-
"""B 图片的 Url
|
1020
|
-
|
1021
|
-
|
1022
|
-
|
1023
|
-
|
1024
|
-
|
1025
|
-
|
1039
|
+
"""B 图片的 Url 。
|
1040
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1041
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1042
|
+
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
1043
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1044
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1045
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1046
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1026
1047
|
:rtype: str
|
1027
1048
|
"""
|
1028
1049
|
return self._UrlB
|
@@ -1045,13 +1066,14 @@ B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1045
1066
|
@property
|
1046
1067
|
def QualityControl(self):
|
1047
1068
|
"""图片质量控制。
|
1069
|
+
- 取值范围:
|
1048
1070
|
0: 不进行控制;
|
1049
1071
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
1050
1072
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
1051
1073
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
1052
1074
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
1053
|
-
默认 0。
|
1054
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1075
|
+
- 默认 0。
|
1076
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1055
1077
|
:rtype: int
|
1056
1078
|
"""
|
1057
1079
|
return self._QualityControl
|
@@ -1086,10 +1108,10 @@ class CompareMaskFaceResponse(AbstractModel):
|
|
1086
1108
|
def __init__(self):
|
1087
1109
|
r"""
|
1088
1110
|
:param _Score: 两张图片中人脸的相似度分数。
|
1089
|
-
不同算法版本返回的相似度分数不同。
|
1090
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
1091
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
1092
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
1111
|
+
- 不同算法版本返回的相似度分数不同。
|
1112
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
1113
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
1114
|
+
- 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
1093
1115
|
:type Score: float
|
1094
1116
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
1095
1117
|
:type FaceModelVersion: str
|
@@ -1103,10 +1125,10 @@ class CompareMaskFaceResponse(AbstractModel):
|
|
1103
1125
|
@property
|
1104
1126
|
def Score(self):
|
1105
1127
|
"""两张图片中人脸的相似度分数。
|
1106
|
-
不同算法版本返回的相似度分数不同。
|
1107
|
-
若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
1108
|
-
2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
1109
|
-
若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
1128
|
+
- 不同算法版本返回的相似度分数不同。
|
1129
|
+
- 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
|
1130
|
+
- 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
|
1131
|
+
- 若需要验证两张图片中的人脸是否为同一人,建议使用人脸验证接口。
|
1110
1132
|
:rtype: float
|
1111
1133
|
"""
|
1112
1134
|
return self._Score
|
@@ -1151,9 +1173,9 @@ class CopyPersonRequest(AbstractModel):
|
|
1151
1173
|
|
1152
1174
|
def __init__(self):
|
1153
1175
|
r"""
|
1154
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
1176
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
1155
1177
|
:type PersonId: str
|
1156
|
-
:param _GroupIds: 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId
|
1178
|
+
:param _GroupIds: 待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId。
|
1157
1179
|
:type GroupIds: list of str
|
1158
1180
|
"""
|
1159
1181
|
self._PersonId = None
|
@@ -1161,7 +1183,7 @@ class CopyPersonRequest(AbstractModel):
|
|
1161
1183
|
|
1162
1184
|
@property
|
1163
1185
|
def PersonId(self):
|
1164
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
1186
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
1165
1187
|
:rtype: str
|
1166
1188
|
"""
|
1167
1189
|
return self._PersonId
|
@@ -1172,7 +1194,7 @@ class CopyPersonRequest(AbstractModel):
|
|
1172
1194
|
|
1173
1195
|
@property
|
1174
1196
|
def GroupIds(self):
|
1175
|
-
"""待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId
|
1197
|
+
"""待加入的人员库列表,数组元素取值为创建人员库接口中的GroupId。
|
1176
1198
|
:rtype: list of str
|
1177
1199
|
"""
|
1178
1200
|
return self._GroupIds
|
@@ -1202,9 +1224,9 @@ class CopyPersonResponse(AbstractModel):
|
|
1202
1224
|
|
1203
1225
|
def __init__(self):
|
1204
1226
|
r"""
|
1205
|
-
:param _SucGroupNum:
|
1227
|
+
:param _SucGroupNum: 成功加入的人员库数量。
|
1206
1228
|
:type SucGroupNum: int
|
1207
|
-
:param _SucGroupIds:
|
1229
|
+
:param _SucGroupIds: 成功加入的人员库列表。
|
1208
1230
|
:type SucGroupIds: list of str
|
1209
1231
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
1210
1232
|
:type RequestId: str
|
@@ -1215,7 +1237,7 @@ class CopyPersonResponse(AbstractModel):
|
|
1215
1237
|
|
1216
1238
|
@property
|
1217
1239
|
def SucGroupNum(self):
|
1218
|
-
"""
|
1240
|
+
"""成功加入的人员库数量。
|
1219
1241
|
:rtype: int
|
1220
1242
|
"""
|
1221
1243
|
return self._SucGroupNum
|
@@ -1226,7 +1248,7 @@ class CopyPersonResponse(AbstractModel):
|
|
1226
1248
|
|
1227
1249
|
@property
|
1228
1250
|
def SucGroupIds(self):
|
1229
|
-
"""
|
1251
|
+
"""成功加入的人员库列表。
|
1230
1252
|
:rtype: list of str
|
1231
1253
|
"""
|
1232
1254
|
return self._SucGroupIds
|
@@ -1260,36 +1282,44 @@ class CreateFaceRequest(AbstractModel):
|
|
1260
1282
|
|
1261
1283
|
def __init__(self):
|
1262
1284
|
r"""
|
1263
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
1285
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
1264
1286
|
:type PersonId: str
|
1265
|
-
:param _Images: 图片 base64
|
1266
|
-
|
1267
|
-
|
1268
|
-
|
1269
|
-
|
1287
|
+
:param _Images: 图片 base64 数据。
|
1288
|
+
- base64 编码后大小不可超过5M。
|
1289
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1290
|
+
- 人员人脸总数量不可超过5张。
|
1291
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1292
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1270
1293
|
:type Images: list of str
|
1271
|
-
:param _Urls: 图片的 Url
|
1272
|
-
|
1273
|
-
|
1274
|
-
|
1275
|
-
|
1276
|
-
|
1277
|
-
|
1278
|
-
|
1294
|
+
:param _Urls: 图片的 Url 。
|
1295
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1296
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1297
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
1298
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1299
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1300
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1301
|
+
- 人员人脸总数量不可超过5张。
|
1302
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1279
1303
|
:type Urls: list of str
|
1280
1304
|
:param _FaceMatchThreshold: 只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
1281
|
-
默认值60
|
1305
|
+
- 默认值60分。
|
1306
|
+
- 取值范围:[0,100] 。
|
1282
1307
|
:type FaceMatchThreshold: float
|
1283
1308
|
:param _QualityControl: 图片质量控制。
|
1309
|
+
- 取值范围:
|
1284
1310
|
0: 不进行控制;
|
1285
1311
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
1286
1312
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
1287
1313
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
1288
1314
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
1289
|
-
默认 0。
|
1290
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1315
|
+
- 默认 0。
|
1316
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1291
1317
|
:type QualityControl: int
|
1292
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
1318
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
1319
|
+
- 取值范围:0为不开启,1为开启。
|
1320
|
+
- 默认为0。
|
1321
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1322
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1293
1323
|
:type NeedRotateDetection: int
|
1294
1324
|
"""
|
1295
1325
|
self._PersonId = None
|
@@ -1301,7 +1331,7 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1301
1331
|
|
1302
1332
|
@property
|
1303
1333
|
def PersonId(self):
|
1304
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
1334
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
1305
1335
|
:rtype: str
|
1306
1336
|
"""
|
1307
1337
|
return self._PersonId
|
@@ -1312,11 +1342,12 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1312
1342
|
|
1313
1343
|
@property
|
1314
1344
|
def Images(self):
|
1315
|
-
"""图片 base64
|
1316
|
-
|
1317
|
-
|
1318
|
-
|
1319
|
-
|
1345
|
+
"""图片 base64 数据。
|
1346
|
+
- base64 编码后大小不可超过5M。
|
1347
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1348
|
+
- 人员人脸总数量不可超过5张。
|
1349
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1350
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1320
1351
|
:rtype: list of str
|
1321
1352
|
"""
|
1322
1353
|
return self._Images
|
@@ -1327,14 +1358,15 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
1327
1358
|
|
1328
1359
|
@property
|
1329
1360
|
def Urls(self):
|
1330
|
-
"""图片的 Url
|
1331
|
-
|
1332
|
-
|
1333
|
-
|
1334
|
-
|
1335
|
-
|
1336
|
-
|
1337
|
-
|
1361
|
+
"""图片的 Url 。
|
1362
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1363
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1364
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
1365
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1366
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1367
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1368
|
+
- 人员人脸总数量不可超过5张。
|
1369
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
1338
1370
|
:rtype: list of str
|
1339
1371
|
"""
|
1340
1372
|
return self._Urls
|
@@ -1346,7 +1378,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1346
1378
|
@property
|
1347
1379
|
def FaceMatchThreshold(self):
|
1348
1380
|
"""只有和该人员已有的人脸相似度超过FaceMatchThreshold值的人脸,才能增加人脸成功。
|
1349
|
-
默认值60
|
1381
|
+
- 默认值60分。
|
1382
|
+
- 取值范围:[0,100] 。
|
1350
1383
|
:rtype: float
|
1351
1384
|
"""
|
1352
1385
|
return self._FaceMatchThreshold
|
@@ -1358,13 +1391,14 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1358
1391
|
@property
|
1359
1392
|
def QualityControl(self):
|
1360
1393
|
"""图片质量控制。
|
1394
|
+
- 取值范围:
|
1361
1395
|
0: 不进行控制;
|
1362
1396
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
1363
1397
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
1364
1398
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
1365
1399
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
1366
|
-
默认 0。
|
1367
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1400
|
+
- 默认 0。
|
1401
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1368
1402
|
:rtype: int
|
1369
1403
|
"""
|
1370
1404
|
return self._QualityControl
|
@@ -1375,7 +1409,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1375
1409
|
|
1376
1410
|
@property
|
1377
1411
|
def NeedRotateDetection(self):
|
1378
|
-
"""是否开启图片旋转识别支持。
|
1412
|
+
"""是否开启图片旋转识别支持。
|
1413
|
+
- 取值范围:0为不开启,1为开启。
|
1414
|
+
- 默认为0。
|
1415
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1416
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1379
1417
|
:rtype: int
|
1380
1418
|
"""
|
1381
1419
|
return self._NeedRotateDetection
|
@@ -1409,17 +1447,22 @@ class CreateFaceResponse(AbstractModel):
|
|
1409
1447
|
|
1410
1448
|
def __init__(self):
|
1411
1449
|
r"""
|
1412
|
-
:param _SucFaceNum:
|
1450
|
+
:param _SucFaceNum: 加入成功的人脸数量。
|
1413
1451
|
:type SucFaceNum: int
|
1414
|
-
:param _SucFaceIds: 加入成功的人脸ID
|
1452
|
+
:param _SucFaceIds: 加入成功的人脸ID列表。
|
1415
1453
|
:type SucFaceIds: list of str
|
1416
|
-
:param _RetCode:
|
1417
|
-
-
|
1418
|
-
|
1419
|
-
|
1454
|
+
:param _RetCode: 每张人脸图片添加结果。
|
1455
|
+
- 其他非 0 值代表算法服务异常,取值范围:
|
1456
|
+
-1101 代表未检测到人脸。
|
1457
|
+
-1102 代表图片解码失败。
|
1458
|
+
-1109 代表图片尺寸过大或者过小。
|
1459
|
+
-1601代表不符合图片质量控制要求。
|
1460
|
+
-1604 代表人脸相似度没有超过FaceMatchThreshold。
|
1461
|
+
- RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
1420
1462
|
:type RetCode: list of int
|
1421
|
-
:param _SucIndexes:
|
1422
|
-
|
1463
|
+
:param _SucIndexes: 加入成功的人脸索引。
|
1464
|
+
- 索引顺序和入参中 Images 或 Urls 的顺序一致。
|
1465
|
+
- 例如, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
1423
1466
|
:type SucIndexes: list of int non-negative
|
1424
1467
|
:param _SucFaceRects: 加入成功的人脸框位置。顺序和入参中 Images 或 Urls 的顺序一致。
|
1425
1468
|
:type SucFaceRects: list of FaceRect
|
@@ -1438,7 +1481,7 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
1438
1481
|
|
1439
1482
|
@property
|
1440
1483
|
def SucFaceNum(self):
|
1441
|
-
"""
|
1484
|
+
"""加入成功的人脸数量。
|
1442
1485
|
:rtype: int
|
1443
1486
|
"""
|
1444
1487
|
return self._SucFaceNum
|
@@ -1449,7 +1492,7 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
1449
1492
|
|
1450
1493
|
@property
|
1451
1494
|
def SucFaceIds(self):
|
1452
|
-
"""加入成功的人脸ID
|
1495
|
+
"""加入成功的人脸ID列表。
|
1453
1496
|
:rtype: list of str
|
1454
1497
|
"""
|
1455
1498
|
return self._SucFaceIds
|
@@ -1460,10 +1503,14 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
1460
1503
|
|
1461
1504
|
@property
|
1462
1505
|
def RetCode(self):
|
1463
|
-
"""
|
1464
|
-
-
|
1465
|
-
|
1466
|
-
|
1506
|
+
"""每张人脸图片添加结果。
|
1507
|
+
- 其他非 0 值代表算法服务异常,取值范围:
|
1508
|
+
-1101 代表未检测到人脸。
|
1509
|
+
-1102 代表图片解码失败。
|
1510
|
+
-1109 代表图片尺寸过大或者过小。
|
1511
|
+
-1601代表不符合图片质量控制要求。
|
1512
|
+
-1604 代表人脸相似度没有超过FaceMatchThreshold。
|
1513
|
+
- RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
1467
1514
|
:rtype: list of int
|
1468
1515
|
"""
|
1469
1516
|
return self._RetCode
|
@@ -1474,8 +1521,9 @@ RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
|
|
1474
1521
|
|
1475
1522
|
@property
|
1476
1523
|
def SucIndexes(self):
|
1477
|
-
"""
|
1478
|
-
|
1524
|
+
"""加入成功的人脸索引。
|
1525
|
+
- 索引顺序和入参中 Images 或 Urls 的顺序一致。
|
1526
|
+
- 例如, Urls 中 有 3 个 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
|
1479
1527
|
:rtype: list of int non-negative
|
1480
1528
|
"""
|
1481
1529
|
return self._SucIndexes
|
@@ -1545,20 +1593,18 @@ class CreateGroupRequest(AbstractModel):
|
|
1545
1593
|
:param _GroupId: 人员库 ID,不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B。
|
1546
1594
|
:type GroupId: str
|
1547
1595
|
:param _GroupExDescriptions: 人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
1548
|
-
最多可以创建5个。
|
1549
|
-
每个自定义描述字段支持[1,30]个字符。
|
1550
|
-
在同一人员库中自定义描述字段不可重复。
|
1551
|
-
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
1552
|
-
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
1553
|
-
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
1596
|
+
- 最多可以创建5个。
|
1597
|
+
- 每个自定义描述字段支持[1,30]个字符。
|
1598
|
+
- 在同一人员库中自定义描述字段不可重复。
|
1599
|
+
- 例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"], 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段, 可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
1554
1600
|
:type GroupExDescriptions: list of str
|
1555
1601
|
:param _Tag: 人员库信息备注,[0,40]个字符。
|
1556
1602
|
:type Tag: str
|
1557
1603
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
1558
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
1559
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1560
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1561
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1604
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
1605
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1606
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1607
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1562
1608
|
:type FaceModelVersion: str
|
1563
1609
|
"""
|
1564
1610
|
self._GroupName = None
|
@@ -1592,12 +1638,10 @@ class CreateGroupRequest(AbstractModel):
|
|
1592
1638
|
@property
|
1593
1639
|
def GroupExDescriptions(self):
|
1594
1640
|
"""人员库自定义描述字段,用于描述人员库中人员属性,该人员库下所有人员将拥有此描述字段。
|
1595
|
-
最多可以创建5个。
|
1596
|
-
每个自定义描述字段支持[1,30]个字符。
|
1597
|
-
在同一人员库中自定义描述字段不可重复。
|
1598
|
-
例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"],
|
1599
|
-
则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段,
|
1600
|
-
可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
1641
|
+
- 最多可以创建5个。
|
1642
|
+
- 每个自定义描述字段支持[1,30]个字符。
|
1643
|
+
- 在同一人员库中自定义描述字段不可重复。
|
1644
|
+
- 例: 设置某人员库“自定义描述字段”为["学号","工号","手机号"], 则该人员库下所有人员将拥有名为“学号”、“工号”、“手机号”的描述字段, 可在对应人员描述字段中填写内容,登记该人员的学号、工号、手机号等信息。
|
1601
1645
|
:rtype: list of str
|
1602
1646
|
"""
|
1603
1647
|
return self._GroupExDescriptions
|
@@ -1620,10 +1664,10 @@ class CreateGroupRequest(AbstractModel):
|
|
1620
1664
|
@property
|
1621
1665
|
def FaceModelVersion(self):
|
1622
1666
|
"""人脸识别服务所用的算法模型版本。
|
1623
|
-
目前入参支持 “2.0”和“3.0“ 两个输入。
|
1624
|
-
2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1625
|
-
2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1626
|
-
不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1667
|
+
- 目前入参支持 “2.0”和“3.0“ 两个输入。
|
1668
|
+
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
|
1669
|
+
- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
|
1670
|
+
- 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
|
1627
1671
|
:rtype: str
|
1628
1672
|
"""
|
1629
1673
|
return self._FaceModelVersion
|
@@ -1699,48 +1743,59 @@ class CreatePersonRequest(AbstractModel):
|
|
1699
1743
|
|
1700
1744
|
def __init__(self):
|
1701
1745
|
r"""
|
1702
|
-
:param _GroupId: 待加入的人员库ID,取值为创建人员库接口中的GroupId
|
1746
|
+
:param _GroupId: 待加入的人员库ID,取值为创建人员库接口中的GroupId。
|
1703
1747
|
:type GroupId: str
|
1704
1748
|
:param _PersonName: 人员名称。[1,60]个字符,可修改,可重复。
|
1705
1749
|
:type PersonName: str
|
1706
|
-
:param _PersonId: 人员ID
|
1750
|
+
:param _PersonId: 人员ID。
|
1751
|
+
- 单个腾讯云账号下不可修改,不可重复。
|
1752
|
+
- 支持英文、数字、-%@#&_,长度限制64B。
|
1707
1753
|
:type PersonId: str
|
1708
|
-
:param _Gender:
|
1754
|
+
:param _Gender: 性别。
|
1755
|
+
- 取值范围:0代表未填写,1代表男性,2代表女性。
|
1709
1756
|
:type Gender: int
|
1710
1757
|
:param _PersonExDescriptionInfos: 人员描述字段内容,key-value。[0,60]个字符,可修改,可重复。
|
1711
1758
|
:type PersonExDescriptionInfos: list of PersonExDescriptionInfo
|
1712
|
-
:param _Image: 图片 base64
|
1713
|
-
|
1714
|
-
|
1759
|
+
:param _Image: 图片 base64 数据。
|
1760
|
+
- base64 编码后大小不可超过5M。
|
1761
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1762
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1715
1763
|
:type Image: str
|
1716
|
-
:param _Url: 图片的 Url
|
1717
|
-
|
1718
|
-
|
1719
|
-
|
1720
|
-
|
1721
|
-
|
1764
|
+
:param _Url: 图片的 Url 。
|
1765
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1766
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1767
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
1768
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1769
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1770
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1722
1771
|
:type Url: str
|
1723
1772
|
:param _UniquePersonControl: 此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
1724
|
-
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
1725
|
-
如果判断没有,则完成创建人员。
|
1773
|
+
- 如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
1774
|
+
- 如果判断没有,则完成创建人员。
|
1775
|
+
- 取值范围:
|
1726
1776
|
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
1727
1777
|
1:较低的同一人判断要求(百一误识别率);
|
1728
1778
|
2: 一般的同一人判断要求(千一误识别率);
|
1729
1779
|
3: 较高的同一人判断要求(万一误识别率);
|
1730
1780
|
4: 很高的同一人判断要求(十万一误识别率)。
|
1731
|
-
默认 0。
|
1732
|
-
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
1781
|
+
- 默认 0。
|
1782
|
+
- 注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
1733
1783
|
:type UniquePersonControl: int
|
1734
1784
|
:param _QualityControl: 图片质量控制。
|
1785
|
+
- 取值范围:
|
1735
1786
|
0: 不进行控制;
|
1736
1787
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
1737
1788
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
1738
1789
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
1739
1790
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
1740
|
-
默认 0。
|
1741
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1791
|
+
- 默认 0。
|
1792
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1742
1793
|
:type QualityControl: int
|
1743
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
1794
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
1795
|
+
- 取值范围:0为不开启,1为开启。
|
1796
|
+
- 默认为0。
|
1797
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1798
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1744
1799
|
:type NeedRotateDetection: int
|
1745
1800
|
"""
|
1746
1801
|
self._GroupId = None
|
@@ -1756,7 +1811,7 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1756
1811
|
|
1757
1812
|
@property
|
1758
1813
|
def GroupId(self):
|
1759
|
-
"""待加入的人员库ID,取值为创建人员库接口中的GroupId
|
1814
|
+
"""待加入的人员库ID,取值为创建人员库接口中的GroupId。
|
1760
1815
|
:rtype: str
|
1761
1816
|
"""
|
1762
1817
|
return self._GroupId
|
@@ -1778,7 +1833,9 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1778
1833
|
|
1779
1834
|
@property
|
1780
1835
|
def PersonId(self):
|
1781
|
-
"""人员ID
|
1836
|
+
"""人员ID。
|
1837
|
+
- 单个腾讯云账号下不可修改,不可重复。
|
1838
|
+
- 支持英文、数字、-%@#&_,长度限制64B。
|
1782
1839
|
:rtype: str
|
1783
1840
|
"""
|
1784
1841
|
return self._PersonId
|
@@ -1789,7 +1846,8 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1789
1846
|
|
1790
1847
|
@property
|
1791
1848
|
def Gender(self):
|
1792
|
-
"""
|
1849
|
+
"""性别。
|
1850
|
+
- 取值范围:0代表未填写,1代表男性,2代表女性。
|
1793
1851
|
:rtype: int
|
1794
1852
|
"""
|
1795
1853
|
return self._Gender
|
@@ -1811,9 +1869,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1811
1869
|
|
1812
1870
|
@property
|
1813
1871
|
def Image(self):
|
1814
|
-
"""图片 base64
|
1815
|
-
|
1816
|
-
|
1872
|
+
"""图片 base64 数据。
|
1873
|
+
- base64 编码后大小不可超过5M。
|
1874
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1875
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1817
1876
|
:rtype: str
|
1818
1877
|
"""
|
1819
1878
|
return self._Image
|
@@ -1824,12 +1883,13 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
1824
1883
|
|
1825
1884
|
@property
|
1826
1885
|
def Url(self):
|
1827
|
-
"""图片的 Url
|
1828
|
-
|
1829
|
-
|
1830
|
-
|
1831
|
-
|
1832
|
-
|
1886
|
+
"""图片的 Url 。
|
1887
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
1888
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
|
1889
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
1890
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
1891
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
1892
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
1833
1893
|
:rtype: str
|
1834
1894
|
"""
|
1835
1895
|
return self._Url
|
@@ -1841,15 +1901,16 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1841
1901
|
@property
|
1842
1902
|
def UniquePersonControl(self):
|
1843
1903
|
"""此参数用于控制判断 Image 或 Url 中图片包含的人脸,是否在人员库中已有疑似的同一人。
|
1844
|
-
如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
1845
|
-
如果判断没有,则完成创建人员。
|
1904
|
+
- 如果判断为已有相同人在人员库中,则不会创建新的人员,返回疑似同一人的人员信息。
|
1905
|
+
- 如果判断没有,则完成创建人员。
|
1906
|
+
- 取值范围:
|
1846
1907
|
0: 不进行判断,无论是否有疑似同一人在库中均完成入库;
|
1847
1908
|
1:较低的同一人判断要求(百一误识别率);
|
1848
1909
|
2: 一般的同一人判断要求(千一误识别率);
|
1849
1910
|
3: 较高的同一人判断要求(万一误识别率);
|
1850
1911
|
4: 很高的同一人判断要求(十万一误识别率)。
|
1851
|
-
默认 0。
|
1852
|
-
注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
1912
|
+
- 默认 0。
|
1913
|
+
- 注: 要求越高,则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值,您可以根据实际情况调整。
|
1853
1914
|
:rtype: int
|
1854
1915
|
"""
|
1855
1916
|
return self._UniquePersonControl
|
@@ -1861,13 +1922,14 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1861
1922
|
@property
|
1862
1923
|
def QualityControl(self):
|
1863
1924
|
"""图片质量控制。
|
1925
|
+
- 取值范围:
|
1864
1926
|
0: 不进行控制;
|
1865
1927
|
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
|
1866
1928
|
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
|
1867
1929
|
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
|
1868
1930
|
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
|
1869
|
-
默认 0。
|
1870
|
-
若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1931
|
+
- 默认 0。
|
1932
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
1871
1933
|
:rtype: int
|
1872
1934
|
"""
|
1873
1935
|
return self._QualityControl
|
@@ -1878,7 +1940,11 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
1878
1940
|
|
1879
1941
|
@property
|
1880
1942
|
def NeedRotateDetection(self):
|
1881
|
-
"""是否开启图片旋转识别支持。
|
1943
|
+
"""是否开启图片旋转识别支持。
|
1944
|
+
- 取值范围:0为不开启,1为开启。
|
1945
|
+
- 默认为0。
|
1946
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
1947
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
1882
1948
|
:rtype: int
|
1883
1949
|
"""
|
1884
1950
|
return self._NeedRotateDetection
|
@@ -1927,7 +1993,7 @@ class CreatePersonResponse(AbstractModel):
|
|
1927
1993
|
注意:此字段可能返回 null,表示取不到有效值。
|
1928
1994
|
:type FaceRect: :class:`tencentcloud.iai.v20200303.models.FaceRect`
|
1929
1995
|
:param _SimilarPersonId: 疑似同一人的PersonId。
|
1930
|
-
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
1996
|
+
- 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
1931
1997
|
:type SimilarPersonId: str
|
1932
1998
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
1933
1999
|
:type FaceModelVersion: str
|
@@ -1966,7 +2032,7 @@ class CreatePersonResponse(AbstractModel):
|
|
1966
2032
|
@property
|
1967
2033
|
def SimilarPersonId(self):
|
1968
2034
|
"""疑似同一人的PersonId。
|
1969
|
-
当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
2035
|
+
- 当 UniquePersonControl 参数不为0且人员库中有疑似的同一人,此参数才有意义。
|
1970
2036
|
:rtype: str
|
1971
2037
|
"""
|
1972
2038
|
return self._SimilarPersonId
|
@@ -2015,9 +2081,9 @@ class DeleteFaceRequest(AbstractModel):
|
|
2015
2081
|
|
2016
2082
|
def __init__(self):
|
2017
2083
|
r"""
|
2018
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
2084
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
2019
2085
|
:type PersonId: str
|
2020
|
-
:param _FaceIds: 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId
|
2086
|
+
:param _FaceIds: 待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId。
|
2021
2087
|
:type FaceIds: list of str
|
2022
2088
|
"""
|
2023
2089
|
self._PersonId = None
|
@@ -2025,7 +2091,7 @@ class DeleteFaceRequest(AbstractModel):
|
|
2025
2091
|
|
2026
2092
|
@property
|
2027
2093
|
def PersonId(self):
|
2028
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
2094
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
2029
2095
|
:rtype: str
|
2030
2096
|
"""
|
2031
2097
|
return self._PersonId
|
@@ -2036,7 +2102,7 @@ class DeleteFaceRequest(AbstractModel):
|
|
2036
2102
|
|
2037
2103
|
@property
|
2038
2104
|
def FaceIds(self):
|
2039
|
-
"""待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId
|
2105
|
+
"""待删除的人脸ID列表,数组元素取值为增加人脸接口返回的FaceId。
|
2040
2106
|
:rtype: list of str
|
2041
2107
|
"""
|
2042
2108
|
return self._FaceIds
|
@@ -2066,9 +2132,9 @@ class DeleteFaceResponse(AbstractModel):
|
|
2066
2132
|
|
2067
2133
|
def __init__(self):
|
2068
2134
|
r"""
|
2069
|
-
:param _SucDeletedNum:
|
2135
|
+
:param _SucDeletedNum: 删除成功的人脸数量.
|
2070
2136
|
:type SucDeletedNum: int
|
2071
|
-
:param _SucFaceIds: 删除成功的人脸ID
|
2137
|
+
:param _SucFaceIds: 删除成功的人脸ID列表。
|
2072
2138
|
:type SucFaceIds: list of str
|
2073
2139
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
2074
2140
|
:type RequestId: str
|
@@ -2079,7 +2145,7 @@ class DeleteFaceResponse(AbstractModel):
|
|
2079
2145
|
|
2080
2146
|
@property
|
2081
2147
|
def SucDeletedNum(self):
|
2082
|
-
"""
|
2148
|
+
"""删除成功的人脸数量.
|
2083
2149
|
:rtype: int
|
2084
2150
|
"""
|
2085
2151
|
return self._SucDeletedNum
|
@@ -2090,7 +2156,7 @@ class DeleteFaceResponse(AbstractModel):
|
|
2090
2156
|
|
2091
2157
|
@property
|
2092
2158
|
def SucFaceIds(self):
|
2093
|
-
"""删除成功的人脸ID
|
2159
|
+
"""删除成功的人脸ID列表。
|
2094
2160
|
:rtype: list of str
|
2095
2161
|
"""
|
2096
2162
|
return self._SucFaceIds
|
@@ -2124,14 +2190,14 @@ class DeleteGroupRequest(AbstractModel):
|
|
2124
2190
|
|
2125
2191
|
def __init__(self):
|
2126
2192
|
r"""
|
2127
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
2193
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
2128
2194
|
:type GroupId: str
|
2129
2195
|
"""
|
2130
2196
|
self._GroupId = None
|
2131
2197
|
|
2132
2198
|
@property
|
2133
2199
|
def GroupId(self):
|
2134
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
2200
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
2135
2201
|
:rtype: str
|
2136
2202
|
"""
|
2137
2203
|
return self._GroupId
|
@@ -2188,9 +2254,9 @@ class DeletePersonFromGroupRequest(AbstractModel):
|
|
2188
2254
|
|
2189
2255
|
def __init__(self):
|
2190
2256
|
r"""
|
2191
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
2257
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
2192
2258
|
:type PersonId: str
|
2193
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
2259
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
2194
2260
|
:type GroupId: str
|
2195
2261
|
"""
|
2196
2262
|
self._PersonId = None
|
@@ -2198,7 +2264,7 @@ class DeletePersonFromGroupRequest(AbstractModel):
|
|
2198
2264
|
|
2199
2265
|
@property
|
2200
2266
|
def PersonId(self):
|
2201
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
2267
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
2202
2268
|
:rtype: str
|
2203
2269
|
"""
|
2204
2270
|
return self._PersonId
|
@@ -2209,7 +2275,7 @@ class DeletePersonFromGroupRequest(AbstractModel):
|
|
2209
2275
|
|
2210
2276
|
@property
|
2211
2277
|
def GroupId(self):
|
2212
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
2278
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
2213
2279
|
:rtype: str
|
2214
2280
|
"""
|
2215
2281
|
return self._GroupId
|
@@ -2267,14 +2333,14 @@ class DeletePersonRequest(AbstractModel):
|
|
2267
2333
|
|
2268
2334
|
def __init__(self):
|
2269
2335
|
r"""
|
2270
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
2336
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
2271
2337
|
:type PersonId: str
|
2272
2338
|
"""
|
2273
2339
|
self._PersonId = None
|
2274
2340
|
|
2275
2341
|
@property
|
2276
2342
|
def PersonId(self):
|
2277
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
2343
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
2278
2344
|
:rtype: str
|
2279
2345
|
"""
|
2280
2346
|
return self._PersonId
|
@@ -5165,14 +5231,14 @@ class GetGroupInfoRequest(AbstractModel):
|
|
5165
5231
|
|
5166
5232
|
def __init__(self):
|
5167
5233
|
r"""
|
5168
|
-
:param _GroupId: 人员库 ID,取值为创建人员库接口中的GroupId
|
5234
|
+
:param _GroupId: 人员库 ID,取值为创建人员库接口中的GroupId。
|
5169
5235
|
:type GroupId: str
|
5170
5236
|
"""
|
5171
5237
|
self._GroupId = None
|
5172
5238
|
|
5173
5239
|
@property
|
5174
5240
|
def GroupId(self):
|
5175
|
-
"""人员库 ID,取值为创建人员库接口中的GroupId
|
5241
|
+
"""人员库 ID,取值为创建人员库接口中的GroupId。
|
5176
5242
|
:rtype: str
|
5177
5243
|
"""
|
5178
5244
|
return self._GroupId
|
@@ -5201,13 +5267,13 @@ class GetGroupInfoResponse(AbstractModel):
|
|
5201
5267
|
|
5202
5268
|
def __init__(self):
|
5203
5269
|
r"""
|
5204
|
-
:param _GroupName:
|
5270
|
+
:param _GroupName: 人员库名称。
|
5205
5271
|
:type GroupName: str
|
5206
|
-
:param _GroupId: 人员库ID
|
5272
|
+
:param _GroupId: 人员库ID。
|
5207
5273
|
:type GroupId: str
|
5208
|
-
:param _GroupExDescriptions:
|
5274
|
+
:param _GroupExDescriptions: 人员库自定义描述字段。
|
5209
5275
|
:type GroupExDescriptions: list of str
|
5210
|
-
:param _Tag:
|
5276
|
+
:param _Tag: 人员库信息备注。
|
5211
5277
|
:type Tag: str
|
5212
5278
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
5213
5279
|
:type FaceModelVersion: str
|
@@ -5226,7 +5292,7 @@ class GetGroupInfoResponse(AbstractModel):
|
|
5226
5292
|
|
5227
5293
|
@property
|
5228
5294
|
def GroupName(self):
|
5229
|
-
"""
|
5295
|
+
"""人员库名称。
|
5230
5296
|
:rtype: str
|
5231
5297
|
"""
|
5232
5298
|
return self._GroupName
|
@@ -5237,7 +5303,7 @@ class GetGroupInfoResponse(AbstractModel):
|
|
5237
5303
|
|
5238
5304
|
@property
|
5239
5305
|
def GroupId(self):
|
5240
|
-
"""人员库ID
|
5306
|
+
"""人员库ID。
|
5241
5307
|
:rtype: str
|
5242
5308
|
"""
|
5243
5309
|
return self._GroupId
|
@@ -5248,7 +5314,7 @@ class GetGroupInfoResponse(AbstractModel):
|
|
5248
5314
|
|
5249
5315
|
@property
|
5250
5316
|
def GroupExDescriptions(self):
|
5251
|
-
"""
|
5317
|
+
"""人员库自定义描述字段。
|
5252
5318
|
:rtype: list of str
|
5253
5319
|
"""
|
5254
5320
|
return self._GroupExDescriptions
|
@@ -5259,7 +5325,7 @@ class GetGroupInfoResponse(AbstractModel):
|
|
5259
5325
|
|
5260
5326
|
@property
|
5261
5327
|
def Tag(self):
|
5262
|
-
"""
|
5328
|
+
"""人员库信息备注。
|
5263
5329
|
:rtype: str
|
5264
5330
|
"""
|
5265
5331
|
return self._Tag
|
@@ -5435,14 +5501,14 @@ class GetPersonBaseInfoRequest(AbstractModel):
|
|
5435
5501
|
|
5436
5502
|
def __init__(self):
|
5437
5503
|
r"""
|
5438
|
-
:param _PersonId: 人员ID,创建人员接口中的PersonId
|
5504
|
+
:param _PersonId: 人员ID,创建人员接口中的PersonId。
|
5439
5505
|
:type PersonId: str
|
5440
5506
|
"""
|
5441
5507
|
self._PersonId = None
|
5442
5508
|
|
5443
5509
|
@property
|
5444
5510
|
def PersonId(self):
|
5445
|
-
"""人员ID,创建人员接口中的PersonId
|
5511
|
+
"""人员ID,创建人员接口中的PersonId。
|
5446
5512
|
:rtype: str
|
5447
5513
|
"""
|
5448
5514
|
return self._PersonId
|
@@ -5471,11 +5537,12 @@ class GetPersonBaseInfoResponse(AbstractModel):
|
|
5471
5537
|
|
5472
5538
|
def __init__(self):
|
5473
5539
|
r"""
|
5474
|
-
:param _PersonName:
|
5540
|
+
:param _PersonName: 人员名称。
|
5475
5541
|
:type PersonName: str
|
5476
|
-
:param _Gender:
|
5542
|
+
:param _Gender: 人员性别。
|
5543
|
+
- 取值范围:0代表未填写,1代表男性,2代表女性。
|
5477
5544
|
:type Gender: int
|
5478
|
-
:param _FaceIds: 包含的人脸 ID
|
5545
|
+
:param _FaceIds: 包含的人脸 ID 列表。
|
5479
5546
|
:type FaceIds: list of str
|
5480
5547
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
5481
5548
|
:type RequestId: str
|
@@ -5487,7 +5554,7 @@ class GetPersonBaseInfoResponse(AbstractModel):
|
|
5487
5554
|
|
5488
5555
|
@property
|
5489
5556
|
def PersonName(self):
|
5490
|
-
"""
|
5557
|
+
"""人员名称。
|
5491
5558
|
:rtype: str
|
5492
5559
|
"""
|
5493
5560
|
return self._PersonName
|
@@ -5498,7 +5565,8 @@ class GetPersonBaseInfoResponse(AbstractModel):
|
|
5498
5565
|
|
5499
5566
|
@property
|
5500
5567
|
def Gender(self):
|
5501
|
-
"""
|
5568
|
+
"""人员性别。
|
5569
|
+
- 取值范围:0代表未填写,1代表男性,2代表女性。
|
5502
5570
|
:rtype: int
|
5503
5571
|
"""
|
5504
5572
|
return self._Gender
|
@@ -5509,7 +5577,7 @@ class GetPersonBaseInfoResponse(AbstractModel):
|
|
5509
5577
|
|
5510
5578
|
@property
|
5511
5579
|
def FaceIds(self):
|
5512
|
-
"""包含的人脸 ID
|
5580
|
+
"""包含的人脸 ID 列表。
|
5513
5581
|
:rtype: list of str
|
5514
5582
|
"""
|
5515
5583
|
return self._FaceIds
|
@@ -5544,11 +5612,11 @@ class GetPersonGroupInfoRequest(AbstractModel):
|
|
5544
5612
|
|
5545
5613
|
def __init__(self):
|
5546
5614
|
r"""
|
5547
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
5615
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
5548
5616
|
:type PersonId: str
|
5549
|
-
:param _Offset: 起始序号,默认值为0
|
5617
|
+
:param _Offset: 起始序号,默认值为0。
|
5550
5618
|
:type Offset: int
|
5551
|
-
:param _Limit: 返回数量,默认值为10,最大值为100
|
5619
|
+
:param _Limit: 返回数量,默认值为10,最大值为100。
|
5552
5620
|
:type Limit: int
|
5553
5621
|
"""
|
5554
5622
|
self._PersonId = None
|
@@ -5557,7 +5625,7 @@ class GetPersonGroupInfoRequest(AbstractModel):
|
|
5557
5625
|
|
5558
5626
|
@property
|
5559
5627
|
def PersonId(self):
|
5560
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
5628
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
5561
5629
|
:rtype: str
|
5562
5630
|
"""
|
5563
5631
|
return self._PersonId
|
@@ -5568,7 +5636,7 @@ class GetPersonGroupInfoRequest(AbstractModel):
|
|
5568
5636
|
|
5569
5637
|
@property
|
5570
5638
|
def Offset(self):
|
5571
|
-
"""起始序号,默认值为0
|
5639
|
+
"""起始序号,默认值为0。
|
5572
5640
|
:rtype: int
|
5573
5641
|
"""
|
5574
5642
|
return self._Offset
|
@@ -5579,7 +5647,7 @@ class GetPersonGroupInfoRequest(AbstractModel):
|
|
5579
5647
|
|
5580
5648
|
@property
|
5581
5649
|
def Limit(self):
|
5582
|
-
"""返回数量,默认值为10,最大值为100
|
5650
|
+
"""返回数量,默认值为10,最大值为100。
|
5583
5651
|
:rtype: int
|
5584
5652
|
"""
|
5585
5653
|
return self._Limit
|
@@ -5610,9 +5678,9 @@ class GetPersonGroupInfoResponse(AbstractModel):
|
|
5610
5678
|
|
5611
5679
|
def __init__(self):
|
5612
5680
|
r"""
|
5613
|
-
:param _PersonGroupInfos:
|
5681
|
+
:param _PersonGroupInfos: 包含此人员的人员库及描述字段内容列表。
|
5614
5682
|
:type PersonGroupInfos: list of PersonGroupInfo
|
5615
|
-
:param _GroupNum:
|
5683
|
+
:param _GroupNum: 人员库总数量。
|
5616
5684
|
注意:此字段可能返回 null,表示取不到有效值。
|
5617
5685
|
:type GroupNum: int
|
5618
5686
|
:param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
|
@@ -5628,7 +5696,7 @@ class GetPersonGroupInfoResponse(AbstractModel):
|
|
5628
5696
|
|
5629
5697
|
@property
|
5630
5698
|
def PersonGroupInfos(self):
|
5631
|
-
"""
|
5699
|
+
"""包含此人员的人员库及描述字段内容列表。
|
5632
5700
|
:rtype: list of PersonGroupInfo
|
5633
5701
|
"""
|
5634
5702
|
return self._PersonGroupInfos
|
@@ -5639,7 +5707,7 @@ class GetPersonGroupInfoResponse(AbstractModel):
|
|
5639
5707
|
|
5640
5708
|
@property
|
5641
5709
|
def GroupNum(self):
|
5642
|
-
"""
|
5710
|
+
"""人员库总数量。
|
5643
5711
|
注意:此字段可能返回 null,表示取不到有效值。
|
5644
5712
|
:rtype: int
|
5645
5713
|
"""
|
@@ -5692,14 +5760,14 @@ class GetPersonListNumRequest(AbstractModel):
|
|
5692
5760
|
|
5693
5761
|
def __init__(self):
|
5694
5762
|
r"""
|
5695
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
5763
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
5696
5764
|
:type GroupId: str
|
5697
5765
|
"""
|
5698
5766
|
self._GroupId = None
|
5699
5767
|
|
5700
5768
|
@property
|
5701
5769
|
def GroupId(self):
|
5702
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
5770
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
5703
5771
|
:rtype: str
|
5704
5772
|
"""
|
5705
5773
|
return self._GroupId
|
@@ -5728,9 +5796,9 @@ class GetPersonListNumResponse(AbstractModel):
|
|
5728
5796
|
|
5729
5797
|
def __init__(self):
|
5730
5798
|
r"""
|
5731
|
-
:param _PersonNum:
|
5799
|
+
:param _PersonNum: 人员数量。
|
5732
5800
|
:type PersonNum: int
|
5733
|
-
:param _FaceNum:
|
5801
|
+
:param _FaceNum: 人脸数量。
|
5734
5802
|
:type FaceNum: int
|
5735
5803
|
:param _RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
|
5736
5804
|
:type RequestId: str
|
@@ -5741,7 +5809,7 @@ class GetPersonListNumResponse(AbstractModel):
|
|
5741
5809
|
|
5742
5810
|
@property
|
5743
5811
|
def PersonNum(self):
|
5744
|
-
"""
|
5812
|
+
"""人员数量。
|
5745
5813
|
:rtype: int
|
5746
5814
|
"""
|
5747
5815
|
return self._PersonNum
|
@@ -5752,7 +5820,7 @@ class GetPersonListNumResponse(AbstractModel):
|
|
5752
5820
|
|
5753
5821
|
@property
|
5754
5822
|
def FaceNum(self):
|
5755
|
-
"""
|
5823
|
+
"""人脸数量。
|
5756
5824
|
:rtype: int
|
5757
5825
|
"""
|
5758
5826
|
return self._FaceNum
|
@@ -5786,11 +5854,11 @@ class GetPersonListRequest(AbstractModel):
|
|
5786
5854
|
|
5787
5855
|
def __init__(self):
|
5788
5856
|
r"""
|
5789
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
5857
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
5790
5858
|
:type GroupId: str
|
5791
|
-
:param _Offset: 起始序号,默认值为0
|
5859
|
+
:param _Offset: 起始序号,默认值为0。
|
5792
5860
|
:type Offset: int
|
5793
|
-
:param _Limit: 返回数量,默认值为10,最大值为1000
|
5861
|
+
:param _Limit: 返回数量,默认值为10,最大值为1000。
|
5794
5862
|
:type Limit: int
|
5795
5863
|
"""
|
5796
5864
|
self._GroupId = None
|
@@ -5799,7 +5867,7 @@ class GetPersonListRequest(AbstractModel):
|
|
5799
5867
|
|
5800
5868
|
@property
|
5801
5869
|
def GroupId(self):
|
5802
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
5870
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
5803
5871
|
:rtype: str
|
5804
5872
|
"""
|
5805
5873
|
return self._GroupId
|
@@ -5810,7 +5878,7 @@ class GetPersonListRequest(AbstractModel):
|
|
5810
5878
|
|
5811
5879
|
@property
|
5812
5880
|
def Offset(self):
|
5813
|
-
"""起始序号,默认值为0
|
5881
|
+
"""起始序号,默认值为0。
|
5814
5882
|
:rtype: int
|
5815
5883
|
"""
|
5816
5884
|
return self._Offset
|
@@ -5821,7 +5889,7 @@ class GetPersonListRequest(AbstractModel):
|
|
5821
5889
|
|
5822
5890
|
@property
|
5823
5891
|
def Limit(self):
|
5824
|
-
"""返回数量,默认值为10,最大值为1000
|
5892
|
+
"""返回数量,默认值为10,最大值为1000。
|
5825
5893
|
:rtype: int
|
5826
5894
|
"""
|
5827
5895
|
return self._Limit
|
@@ -5852,12 +5920,12 @@ class GetPersonListResponse(AbstractModel):
|
|
5852
5920
|
|
5853
5921
|
def __init__(self):
|
5854
5922
|
r"""
|
5855
|
-
:param _PersonInfos:
|
5923
|
+
:param _PersonInfos: 返回的人员信息。
|
5856
5924
|
:type PersonInfos: list of PersonInfo
|
5857
|
-
:param _PersonNum:
|
5925
|
+
:param _PersonNum: 该人员库的人员数量。
|
5858
5926
|
注意:此字段可能返回 null,表示取不到有效值。
|
5859
5927
|
:type PersonNum: int
|
5860
|
-
:param _FaceNum:
|
5928
|
+
:param _FaceNum: 该人员库的人脸数量。
|
5861
5929
|
注意:此字段可能返回 null,表示取不到有效值。
|
5862
5930
|
:type FaceNum: int
|
5863
5931
|
:param _FaceModelVersion: 人脸识别所用的算法模型版本。
|
@@ -5874,7 +5942,7 @@ class GetPersonListResponse(AbstractModel):
|
|
5874
5942
|
|
5875
5943
|
@property
|
5876
5944
|
def PersonInfos(self):
|
5877
|
-
"""
|
5945
|
+
"""返回的人员信息。
|
5878
5946
|
:rtype: list of PersonInfo
|
5879
5947
|
"""
|
5880
5948
|
return self._PersonInfos
|
@@ -5885,7 +5953,7 @@ class GetPersonListResponse(AbstractModel):
|
|
5885
5953
|
|
5886
5954
|
@property
|
5887
5955
|
def PersonNum(self):
|
5888
|
-
"""
|
5956
|
+
"""该人员库的人员数量。
|
5889
5957
|
注意:此字段可能返回 null,表示取不到有效值。
|
5890
5958
|
:rtype: int
|
5891
5959
|
"""
|
@@ -5897,7 +5965,7 @@ class GetPersonListResponse(AbstractModel):
|
|
5897
5965
|
|
5898
5966
|
@property
|
5899
5967
|
def FaceNum(self):
|
5900
|
-
"""
|
5968
|
+
"""该人员库的人脸数量。
|
5901
5969
|
注意:此字段可能返回 null,表示取不到有效值。
|
5902
5970
|
:rtype: int
|
5903
5971
|
"""
|
@@ -6694,13 +6762,13 @@ class ModifyGroupRequest(AbstractModel):
|
|
6694
6762
|
|
6695
6763
|
def __init__(self):
|
6696
6764
|
r"""
|
6697
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
6765
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
6698
6766
|
:type GroupId: str
|
6699
|
-
:param _GroupName:
|
6767
|
+
:param _GroupName: 人员库名称。
|
6700
6768
|
:type GroupName: str
|
6701
|
-
:param _GroupExDescriptionInfos: 需要修改的人员库自定义描述字段,key-value
|
6769
|
+
:param _GroupExDescriptionInfos: 需要修改的人员库自定义描述字段,key-value。
|
6702
6770
|
:type GroupExDescriptionInfos: list of GroupExDescriptionInfo
|
6703
|
-
:param _Tag:
|
6771
|
+
:param _Tag: 人员库信息备注。
|
6704
6772
|
:type Tag: str
|
6705
6773
|
"""
|
6706
6774
|
self._GroupId = None
|
@@ -6710,7 +6778,7 @@ class ModifyGroupRequest(AbstractModel):
|
|
6710
6778
|
|
6711
6779
|
@property
|
6712
6780
|
def GroupId(self):
|
6713
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
6781
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
6714
6782
|
:rtype: str
|
6715
6783
|
"""
|
6716
6784
|
return self._GroupId
|
@@ -6721,7 +6789,7 @@ class ModifyGroupRequest(AbstractModel):
|
|
6721
6789
|
|
6722
6790
|
@property
|
6723
6791
|
def GroupName(self):
|
6724
|
-
"""
|
6792
|
+
"""人员库名称。
|
6725
6793
|
:rtype: str
|
6726
6794
|
"""
|
6727
6795
|
return self._GroupName
|
@@ -6732,7 +6800,7 @@ class ModifyGroupRequest(AbstractModel):
|
|
6732
6800
|
|
6733
6801
|
@property
|
6734
6802
|
def GroupExDescriptionInfos(self):
|
6735
|
-
"""需要修改的人员库自定义描述字段,key-value
|
6803
|
+
"""需要修改的人员库自定义描述字段,key-value。
|
6736
6804
|
:rtype: list of GroupExDescriptionInfo
|
6737
6805
|
"""
|
6738
6806
|
return self._GroupExDescriptionInfos
|
@@ -6743,7 +6811,7 @@ class ModifyGroupRequest(AbstractModel):
|
|
6743
6811
|
|
6744
6812
|
@property
|
6745
6813
|
def Tag(self):
|
6746
|
-
"""
|
6814
|
+
"""人员库信息备注。
|
6747
6815
|
:rtype: str
|
6748
6816
|
"""
|
6749
6817
|
return self._Tag
|
@@ -6808,11 +6876,11 @@ class ModifyPersonBaseInfoRequest(AbstractModel):
|
|
6808
6876
|
|
6809
6877
|
def __init__(self):
|
6810
6878
|
r"""
|
6811
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
6879
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
6812
6880
|
:type PersonId: str
|
6813
|
-
:param _PersonName:
|
6881
|
+
:param _PersonName: 需要修改的人员名称。
|
6814
6882
|
:type PersonName: str
|
6815
|
-
:param _Gender: 需要修改的人员性别,1代表男性,2
|
6883
|
+
:param _Gender: 需要修改的人员性别,1代表男性,2代表女性。
|
6816
6884
|
:type Gender: int
|
6817
6885
|
"""
|
6818
6886
|
self._PersonId = None
|
@@ -6821,7 +6889,7 @@ class ModifyPersonBaseInfoRequest(AbstractModel):
|
|
6821
6889
|
|
6822
6890
|
@property
|
6823
6891
|
def PersonId(self):
|
6824
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
6892
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
6825
6893
|
:rtype: str
|
6826
6894
|
"""
|
6827
6895
|
return self._PersonId
|
@@ -6832,7 +6900,7 @@ class ModifyPersonBaseInfoRequest(AbstractModel):
|
|
6832
6900
|
|
6833
6901
|
@property
|
6834
6902
|
def PersonName(self):
|
6835
|
-
"""
|
6903
|
+
"""需要修改的人员名称。
|
6836
6904
|
:rtype: str
|
6837
6905
|
"""
|
6838
6906
|
return self._PersonName
|
@@ -6843,7 +6911,7 @@ class ModifyPersonBaseInfoRequest(AbstractModel):
|
|
6843
6911
|
|
6844
6912
|
@property
|
6845
6913
|
def Gender(self):
|
6846
|
-
"""需要修改的人员性别,1代表男性,2
|
6914
|
+
"""需要修改的人员性别,1代表男性,2代表女性。
|
6847
6915
|
:rtype: int
|
6848
6916
|
"""
|
6849
6917
|
return self._Gender
|
@@ -6902,11 +6970,11 @@ class ModifyPersonGroupInfoRequest(AbstractModel):
|
|
6902
6970
|
|
6903
6971
|
def __init__(self):
|
6904
6972
|
r"""
|
6905
|
-
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId
|
6973
|
+
:param _GroupId: 人员库ID,取值为创建人员库接口中的GroupId。
|
6906
6974
|
:type GroupId: str
|
6907
|
-
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId
|
6975
|
+
:param _PersonId: 人员ID,取值为创建人员接口中的PersonId。
|
6908
6976
|
:type PersonId: str
|
6909
|
-
:param _PersonExDescriptionInfos: 需要修改的人员描述字段内容,key-value
|
6977
|
+
:param _PersonExDescriptionInfos: 需要修改的人员描述字段内容,key-value。
|
6910
6978
|
:type PersonExDescriptionInfos: list of PersonExDescriptionInfo
|
6911
6979
|
"""
|
6912
6980
|
self._GroupId = None
|
@@ -6915,7 +6983,7 @@ class ModifyPersonGroupInfoRequest(AbstractModel):
|
|
6915
6983
|
|
6916
6984
|
@property
|
6917
6985
|
def GroupId(self):
|
6918
|
-
"""人员库ID,取值为创建人员库接口中的GroupId
|
6986
|
+
"""人员库ID,取值为创建人员库接口中的GroupId。
|
6919
6987
|
:rtype: str
|
6920
6988
|
"""
|
6921
6989
|
return self._GroupId
|
@@ -6926,7 +6994,7 @@ class ModifyPersonGroupInfoRequest(AbstractModel):
|
|
6926
6994
|
|
6927
6995
|
@property
|
6928
6996
|
def PersonId(self):
|
6929
|
-
"""人员ID,取值为创建人员接口中的PersonId
|
6997
|
+
"""人员ID,取值为创建人员接口中的PersonId。
|
6930
6998
|
:rtype: str
|
6931
6999
|
"""
|
6932
7000
|
return self._PersonId
|
@@ -6937,7 +7005,7 @@ class ModifyPersonGroupInfoRequest(AbstractModel):
|
|
6937
7005
|
|
6938
7006
|
@property
|
6939
7007
|
def PersonExDescriptionInfos(self):
|
6940
|
-
"""需要修改的人员描述字段内容,key-value
|
7008
|
+
"""需要修改的人员描述字段内容,key-value。
|
6941
7009
|
:rtype: list of PersonExDescriptionInfo
|
6942
7010
|
"""
|
6943
7011
|
return self._PersonExDescriptionInfos
|
@@ -7529,44 +7597,63 @@ class SearchFacesRequest(AbstractModel):
|
|
7529
7597
|
|
7530
7598
|
def __init__(self):
|
7531
7599
|
r"""
|
7532
|
-
:param _GroupIds: 希望搜索的人员库列表,上限100
|
7533
|
-
|
7600
|
+
:param _GroupIds: 希望搜索的人员库列表,上限100个。
|
7601
|
+
- 数组元素取值为创建人员库接口中的GroupId。
|
7602
|
+
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
7534
7603
|
:type GroupIds: list of str
|
7535
|
-
:param _Image: 图片 base64
|
7536
|
-
|
7537
|
-
|
7604
|
+
:param _Image: 图片 base64 数据。
|
7605
|
+
- base64 编码后大小不可超过5M。
|
7606
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7607
|
+
- 所有格式的图片短边像素不小于64。
|
7608
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7538
7609
|
:type Image: str
|
7539
|
-
:param _Url: 图片的 Url
|
7540
|
-
|
7541
|
-
|
7542
|
-
|
7543
|
-
|
7544
|
-
|
7610
|
+
:param _Url: 图片的 Url 。
|
7611
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
7612
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7613
|
+
- 所有格式的图片短边像素不小于64。
|
7614
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
7615
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
7616
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
7617
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7545
7618
|
:type Url: str
|
7546
|
-
:param _MaxFaceNum:
|
7547
|
-
|
7548
|
-
|
7619
|
+
:param _MaxFaceNum: 最多识别的人脸数目。
|
7620
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
7621
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
7622
|
+
- 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
7549
7623
|
:type MaxFaceNum: int
|
7550
|
-
:param _MinFaceSize:
|
7624
|
+
:param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
7625
|
+
- 默认为34。
|
7626
|
+
- 低于34的人脸图片无法被识别。
|
7627
|
+
- 建议设置为80。
|
7551
7628
|
:type MinFaceSize: int
|
7552
|
-
:param _MaxPersonNum:
|
7553
|
-
|
7554
|
-
|
7629
|
+
:param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
|
7630
|
+
- 默认值为5,最大值为100。
|
7631
|
+
- 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
7632
|
+
- 值越大,需要处理的时间越长。
|
7633
|
+
- 建议不要超过10。
|
7555
7634
|
:type MaxPersonNum: int
|
7556
|
-
:param _NeedPersonInfo: 是否返回人员具体信息。
|
7635
|
+
:param _NeedPersonInfo: 是否返回人员具体信息。
|
7636
|
+
- 取值范围:0 为关闭,1 为开启。
|
7637
|
+
- 默认为 0。
|
7638
|
+
- 其他非0非1值默认为0。
|
7557
7639
|
:type NeedPersonInfo: int
|
7558
7640
|
:param _QualityControl: 图片质量控制。
|
7559
|
-
|
7560
|
-
|
7561
|
-
|
7562
|
-
|
7563
|
-
|
7564
|
-
|
7565
|
-
|
7641
|
+
- 取值范围:
|
7642
|
+
0: 不进行控制。
|
7643
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
7644
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
7645
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
7646
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
7647
|
+
- 默认 0。
|
7648
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
7566
7649
|
:type QualityControl: int
|
7567
7650
|
:param _FaceMatchThreshold: 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
7568
7651
|
:type FaceMatchThreshold: float
|
7569
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
7652
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
7653
|
+
- 取值范围:0为不开启,1为开启。
|
7654
|
+
- 默认为0。
|
7655
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
7656
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
7570
7657
|
:type NeedRotateDetection: int
|
7571
7658
|
"""
|
7572
7659
|
self._GroupIds = None
|
@@ -7582,8 +7669,9 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7582
7669
|
|
7583
7670
|
@property
|
7584
7671
|
def GroupIds(self):
|
7585
|
-
"""希望搜索的人员库列表,上限100
|
7586
|
-
|
7672
|
+
"""希望搜索的人员库列表,上限100个。
|
7673
|
+
- 数组元素取值为创建人员库接口中的GroupId。
|
7674
|
+
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
7587
7675
|
:rtype: list of str
|
7588
7676
|
"""
|
7589
7677
|
return self._GroupIds
|
@@ -7594,9 +7682,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7594
7682
|
|
7595
7683
|
@property
|
7596
7684
|
def Image(self):
|
7597
|
-
"""图片 base64
|
7598
|
-
|
7599
|
-
|
7685
|
+
"""图片 base64 数据。
|
7686
|
+
- base64 编码后大小不可超过5M。
|
7687
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7688
|
+
- 所有格式的图片短边像素不小于64。
|
7689
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7600
7690
|
:rtype: str
|
7601
7691
|
"""
|
7602
7692
|
return self._Image
|
@@ -7607,12 +7697,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
7607
7697
|
|
7608
7698
|
@property
|
7609
7699
|
def Url(self):
|
7610
|
-
"""图片的 Url
|
7611
|
-
|
7612
|
-
|
7613
|
-
|
7614
|
-
|
7615
|
-
|
7700
|
+
"""图片的 Url 。
|
7701
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
7702
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7703
|
+
- 所有格式的图片短边像素不小于64。
|
7704
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
7705
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
7706
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
7707
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7616
7708
|
:rtype: str
|
7617
7709
|
"""
|
7618
7710
|
return self._Url
|
@@ -7623,9 +7715,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
7623
7715
|
|
7624
7716
|
@property
|
7625
7717
|
def MaxFaceNum(self):
|
7626
|
-
"""
|
7627
|
-
|
7628
|
-
|
7718
|
+
"""最多识别的人脸数目。
|
7719
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
7720
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
7721
|
+
- 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
7629
7722
|
:rtype: int
|
7630
7723
|
"""
|
7631
7724
|
return self._MaxFaceNum
|
@@ -7636,7 +7729,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7636
7729
|
|
7637
7730
|
@property
|
7638
7731
|
def MinFaceSize(self):
|
7639
|
-
"""
|
7732
|
+
"""人脸长和宽的最小尺寸,单位为像素。
|
7733
|
+
- 默认为34。
|
7734
|
+
- 低于34的人脸图片无法被识别。
|
7735
|
+
- 建议设置为80。
|
7640
7736
|
:rtype: int
|
7641
7737
|
"""
|
7642
7738
|
return self._MinFaceSize
|
@@ -7647,9 +7743,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7647
7743
|
|
7648
7744
|
@property
|
7649
7745
|
def MaxPersonNum(self):
|
7650
|
-
"""
|
7651
|
-
|
7652
|
-
|
7746
|
+
"""单张被识别的人脸返回的最相似人员数量。
|
7747
|
+
- 默认值为5,最大值为100。
|
7748
|
+
- 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
7749
|
+
- 值越大,需要处理的时间越长。
|
7750
|
+
- 建议不要超过10。
|
7653
7751
|
:rtype: int
|
7654
7752
|
"""
|
7655
7753
|
return self._MaxPersonNum
|
@@ -7660,7 +7758,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7660
7758
|
|
7661
7759
|
@property
|
7662
7760
|
def NeedPersonInfo(self):
|
7663
|
-
"""是否返回人员具体信息。
|
7761
|
+
"""是否返回人员具体信息。
|
7762
|
+
- 取值范围:0 为关闭,1 为开启。
|
7763
|
+
- 默认为 0。
|
7764
|
+
- 其他非0非1值默认为0。
|
7664
7765
|
:rtype: int
|
7665
7766
|
"""
|
7666
7767
|
return self._NeedPersonInfo
|
@@ -7672,13 +7773,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7672
7773
|
@property
|
7673
7774
|
def QualityControl(self):
|
7674
7775
|
"""图片质量控制。
|
7675
|
-
|
7676
|
-
|
7677
|
-
|
7678
|
-
|
7679
|
-
|
7680
|
-
|
7681
|
-
|
7776
|
+
- 取值范围:
|
7777
|
+
0: 不进行控制。
|
7778
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
7779
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
7780
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
7781
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
7782
|
+
- 默认 0。
|
7783
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
7682
7784
|
:rtype: int
|
7683
7785
|
"""
|
7684
7786
|
return self._QualityControl
|
@@ -7700,7 +7802,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7700
7802
|
|
7701
7803
|
@property
|
7702
7804
|
def NeedRotateDetection(self):
|
7703
|
-
"""是否开启图片旋转识别支持。
|
7805
|
+
"""是否开启图片旋转识别支持。
|
7806
|
+
- 取值范围:0为不开启,1为开启。
|
7807
|
+
- 默认为0。
|
7808
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
7809
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
7704
7810
|
:rtype: int
|
7705
7811
|
"""
|
7706
7812
|
return self._NeedRotateDetection
|
@@ -7816,45 +7922,63 @@ class SearchFacesReturnsByGroupRequest(AbstractModel):
|
|
7816
7922
|
|
7817
7923
|
def __init__(self):
|
7818
7924
|
r"""
|
7819
|
-
:param _GroupIds: 希望搜索的人员库列表,上限60
|
7820
|
-
|
7925
|
+
:param _GroupIds: 希望搜索的人员库列表,上限60个。
|
7926
|
+
- 数组元素取值为创建人员库接口中的GroupId。
|
7927
|
+
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
7821
7928
|
:type GroupIds: list of str
|
7822
|
-
:param _Image: 图片 base64
|
7823
|
-
|
7824
|
-
|
7929
|
+
:param _Image: 图片 base64 数据。
|
7930
|
+
- base64 编码后大小不可超过5M。
|
7931
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7932
|
+
- 所有格式的图片短边像素不小于64。
|
7933
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7825
7934
|
:type Image: str
|
7826
|
-
:param _Url: 图片的 Url
|
7827
|
-
|
7828
|
-
|
7829
|
-
|
7830
|
-
|
7831
|
-
|
7935
|
+
:param _Url: 图片的 Url 。
|
7936
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
7937
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
7938
|
+
- 所有格式的图片短边像素不小于64。
|
7939
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
7940
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
7941
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
7942
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7832
7943
|
:type Url: str
|
7833
|
-
:param _MaxFaceNum:
|
7834
|
-
|
7835
|
-
|
7944
|
+
:param _MaxFaceNum: 最多识别的人脸数目。
|
7945
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
7946
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
7947
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
7836
7948
|
:type MaxFaceNum: int
|
7837
|
-
:param _MinFaceSize:
|
7949
|
+
:param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
7950
|
+
- 默认为34。
|
7951
|
+
- 低于34将影响搜索精度。
|
7952
|
+
- 建议设置为80。
|
7838
7953
|
:type MinFaceSize: int
|
7839
|
-
:param _MaxPersonNumPerGroup:
|
7840
|
-
|
7954
|
+
:param _MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。
|
7955
|
+
- 默认值为5,最大值为10。
|
7956
|
+
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
7841
7957
|
:type MaxPersonNumPerGroup: int
|
7842
|
-
:param _NeedPersonInfo: 是否返回人员具体信息。
|
7958
|
+
:param _NeedPersonInfo: 是否返回人员具体信息。
|
7959
|
+
- 取值范围:0 为关闭,1 为开启。
|
7960
|
+
- 默认为 0。
|
7961
|
+
- 其他非0非1值默认为0
|
7843
7962
|
:type NeedPersonInfo: int
|
7844
7963
|
:param _QualityControl: 图片质量控制。
|
7845
|
-
|
7846
|
-
|
7847
|
-
|
7848
|
-
|
7849
|
-
|
7850
|
-
|
7851
|
-
|
7964
|
+
- 取值范围:
|
7965
|
+
0: 不进行控制。
|
7966
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
7967
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
7968
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
7969
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
7970
|
+
- 默认 0。
|
7971
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
7852
7972
|
:type QualityControl: int
|
7853
7973
|
:param _FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
7854
|
-
默认为0。
|
7855
|
-
|
7974
|
+
- 默认为0。
|
7975
|
+
- 取值范围:[0.0,100.0) 。
|
7856
7976
|
:type FaceMatchThreshold: float
|
7857
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
7977
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
7978
|
+
- 取值范围:0为不开启,1为开启。
|
7979
|
+
- 默认为0。
|
7980
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
7981
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
7858
7982
|
:type NeedRotateDetection: int
|
7859
7983
|
"""
|
7860
7984
|
self._GroupIds = None
|
@@ -7870,8 +7994,9 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7870
7994
|
|
7871
7995
|
@property
|
7872
7996
|
def GroupIds(self):
|
7873
|
-
"""希望搜索的人员库列表,上限60
|
7874
|
-
|
7997
|
+
"""希望搜索的人员库列表,上限60个。
|
7998
|
+
- 数组元素取值为创建人员库接口中的GroupId。
|
7999
|
+
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
|
7875
8000
|
:rtype: list of str
|
7876
8001
|
"""
|
7877
8002
|
return self._GroupIds
|
@@ -7882,9 +8007,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7882
8007
|
|
7883
8008
|
@property
|
7884
8009
|
def Image(self):
|
7885
|
-
"""图片 base64
|
7886
|
-
|
7887
|
-
|
8010
|
+
"""图片 base64 数据。
|
8011
|
+
- base64 编码后大小不可超过5M。
|
8012
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8013
|
+
- 所有格式的图片短边像素不小于64。
|
8014
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7888
8015
|
:rtype: str
|
7889
8016
|
"""
|
7890
8017
|
return self._Image
|
@@ -7895,12 +8022,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
7895
8022
|
|
7896
8023
|
@property
|
7897
8024
|
def Url(self):
|
7898
|
-
"""图片的 Url
|
7899
|
-
|
7900
|
-
|
7901
|
-
|
7902
|
-
|
7903
|
-
|
8025
|
+
"""图片的 Url 。
|
8026
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8027
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8028
|
+
- 所有格式的图片短边像素不小于64。
|
8029
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8030
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8031
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8032
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
7904
8033
|
:rtype: str
|
7905
8034
|
"""
|
7906
8035
|
return self._Url
|
@@ -7911,9 +8040,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
7911
8040
|
|
7912
8041
|
@property
|
7913
8042
|
def MaxFaceNum(self):
|
7914
|
-
"""
|
7915
|
-
|
7916
|
-
|
8043
|
+
"""最多识别的人脸数目。
|
8044
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
8045
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
8046
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
7917
8047
|
:rtype: int
|
7918
8048
|
"""
|
7919
8049
|
return self._MaxFaceNum
|
@@ -7924,7 +8054,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7924
8054
|
|
7925
8055
|
@property
|
7926
8056
|
def MinFaceSize(self):
|
7927
|
-
"""
|
8057
|
+
"""人脸长和宽的最小尺寸,单位为像素。
|
8058
|
+
- 默认为34。
|
8059
|
+
- 低于34将影响搜索精度。
|
8060
|
+
- 建议设置为80。
|
7928
8061
|
:rtype: int
|
7929
8062
|
"""
|
7930
8063
|
return self._MinFaceSize
|
@@ -7935,8 +8068,9 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7935
8068
|
|
7936
8069
|
@property
|
7937
8070
|
def MaxPersonNumPerGroup(self):
|
7938
|
-
"""
|
7939
|
-
|
8071
|
+
"""被检测到的人脸,对应最多返回的最相似人员数目。
|
8072
|
+
- 默认值为5,最大值为10。
|
8073
|
+
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
7940
8074
|
:rtype: int
|
7941
8075
|
"""
|
7942
8076
|
return self._MaxPersonNumPerGroup
|
@@ -7947,7 +8081,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7947
8081
|
|
7948
8082
|
@property
|
7949
8083
|
def NeedPersonInfo(self):
|
7950
|
-
"""是否返回人员具体信息。
|
8084
|
+
"""是否返回人员具体信息。
|
8085
|
+
- 取值范围:0 为关闭,1 为开启。
|
8086
|
+
- 默认为 0。
|
8087
|
+
- 其他非0非1值默认为0
|
7951
8088
|
:rtype: int
|
7952
8089
|
"""
|
7953
8090
|
return self._NeedPersonInfo
|
@@ -7959,13 +8096,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7959
8096
|
@property
|
7960
8097
|
def QualityControl(self):
|
7961
8098
|
"""图片质量控制。
|
7962
|
-
|
7963
|
-
|
7964
|
-
|
7965
|
-
|
7966
|
-
|
7967
|
-
|
7968
|
-
|
8099
|
+
- 取值范围:
|
8100
|
+
0: 不进行控制。
|
8101
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8102
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8103
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8104
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8105
|
+
- 默认 0。
|
8106
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
7969
8107
|
:rtype: int
|
7970
8108
|
"""
|
7971
8109
|
return self._QualityControl
|
@@ -7977,8 +8115,8 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7977
8115
|
@property
|
7978
8116
|
def FaceMatchThreshold(self):
|
7979
8117
|
"""出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
7980
|
-
默认为0。
|
7981
|
-
|
8118
|
+
- 默认为0。
|
8119
|
+
- 取值范围:[0.0,100.0) 。
|
7982
8120
|
:rtype: float
|
7983
8121
|
"""
|
7984
8122
|
return self._FaceMatchThreshold
|
@@ -7989,7 +8127,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
7989
8127
|
|
7990
8128
|
@property
|
7991
8129
|
def NeedRotateDetection(self):
|
7992
|
-
"""是否开启图片旋转识别支持。
|
8130
|
+
"""是否开启图片旋转识别支持。
|
8131
|
+
- 取值范围:0为不开启,1为开启。
|
8132
|
+
- 默认为0。
|
8133
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8134
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
7993
8135
|
:rtype: int
|
7994
8136
|
"""
|
7995
8137
|
return self._NeedRotateDetection
|
@@ -8105,44 +8247,63 @@ class SearchPersonsRequest(AbstractModel):
|
|
8105
8247
|
|
8106
8248
|
def __init__(self):
|
8107
8249
|
r"""
|
8108
|
-
:param _GroupIds: 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId
|
8250
|
+
:param _GroupIds: 希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
|
8109
8251
|
:type GroupIds: list of str
|
8110
|
-
:param _Image: 图片 base64
|
8111
|
-
|
8112
|
-
|
8113
|
-
|
8252
|
+
:param _Image: 图片 base64 数据。
|
8253
|
+
- base64 编码后大小不可超过5M。
|
8254
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8255
|
+
- 所有格式的图片短边像素不小于64。
|
8256
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8257
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8114
8258
|
:type Image: str
|
8115
|
-
:param _Url: 图片的 Url
|
8116
|
-
|
8117
|
-
|
8118
|
-
|
8119
|
-
|
8120
|
-
|
8259
|
+
:param _Url: 图片的 Url 。
|
8260
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8261
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8262
|
+
- 所有格式的图片短边像素不小于64。
|
8263
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8264
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8265
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8266
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8121
8267
|
:type Url: str
|
8122
|
-
:param _MaxFaceNum:
|
8123
|
-
|
8124
|
-
|
8268
|
+
:param _MaxFaceNum: 最多识别的人脸数目。
|
8269
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
8270
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
8271
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
8125
8272
|
:type MaxFaceNum: int
|
8126
|
-
:param _MinFaceSize:
|
8273
|
+
:param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
8274
|
+
- 默认为34。
|
8275
|
+
- 低于34将影响搜索精度。
|
8276
|
+
- 建议设置为80。
|
8127
8277
|
:type MinFaceSize: int
|
8128
|
-
:param _MaxPersonNum:
|
8129
|
-
|
8130
|
-
|
8278
|
+
:param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
|
8279
|
+
- 默认值为5,最大值为100。
|
8280
|
+
- 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
8281
|
+
- 值越大,需要处理的时间越长。建议不要超过10。
|
8131
8282
|
:type MaxPersonNum: int
|
8132
8283
|
:param _QualityControl: 图片质量控制。
|
8133
|
-
|
8134
|
-
|
8135
|
-
|
8136
|
-
|
8137
|
-
|
8138
|
-
|
8139
|
-
|
8284
|
+
- 取值范围:
|
8285
|
+
0: 不进行控制。
|
8286
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8287
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8288
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8289
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8290
|
+
- 默认 0。
|
8291
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8140
8292
|
:type QualityControl: int
|
8141
|
-
:param _FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold
|
8293
|
+
:param _FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
8294
|
+
- 默认为0。
|
8295
|
+
- 取值范围:[0.0,100.0) 。
|
8142
8296
|
:type FaceMatchThreshold: float
|
8143
|
-
:param _NeedPersonInfo: 是否返回人员具体信息。
|
8297
|
+
:param _NeedPersonInfo: 是否返回人员具体信息。
|
8298
|
+
- 取值范围:0 为关闭,1 为开启。
|
8299
|
+
- 默认为 0。
|
8300
|
+
- 其他非0非1值默认为0
|
8144
8301
|
:type NeedPersonInfo: int
|
8145
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8302
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8303
|
+
- 取值范围:0为不开启,1为开启。
|
8304
|
+
- 默认为0。
|
8305
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8306
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8146
8307
|
:type NeedRotateDetection: int
|
8147
8308
|
"""
|
8148
8309
|
self._GroupIds = None
|
@@ -8158,7 +8319,7 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8158
8319
|
|
8159
8320
|
@property
|
8160
8321
|
def GroupIds(self):
|
8161
|
-
"""希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId
|
8322
|
+
"""希望搜索的人员库列表,上限100个。数组元素取值为创建人员库接口中的GroupId。
|
8162
8323
|
:rtype: list of str
|
8163
8324
|
"""
|
8164
8325
|
return self._GroupIds
|
@@ -8169,10 +8330,12 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8169
8330
|
|
8170
8331
|
@property
|
8171
8332
|
def Image(self):
|
8172
|
-
"""图片 base64
|
8173
|
-
|
8174
|
-
|
8175
|
-
|
8333
|
+
"""图片 base64 数据。
|
8334
|
+
- base64 编码后大小不可超过5M。
|
8335
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8336
|
+
- 所有格式的图片短边像素不小于64。
|
8337
|
+
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
|
8338
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8176
8339
|
:rtype: str
|
8177
8340
|
"""
|
8178
8341
|
return self._Image
|
@@ -8183,12 +8346,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
8183
8346
|
|
8184
8347
|
@property
|
8185
8348
|
def Url(self):
|
8186
|
-
"""图片的 Url
|
8187
|
-
|
8188
|
-
|
8189
|
-
|
8190
|
-
|
8191
|
-
|
8349
|
+
"""图片的 Url 。
|
8350
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8351
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8352
|
+
- 所有格式的图片短边像素不小于64。
|
8353
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8354
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8355
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8356
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8192
8357
|
:rtype: str
|
8193
8358
|
"""
|
8194
8359
|
return self._Url
|
@@ -8199,9 +8364,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
8199
8364
|
|
8200
8365
|
@property
|
8201
8366
|
def MaxFaceNum(self):
|
8202
|
-
"""
|
8203
|
-
|
8204
|
-
|
8367
|
+
"""最多识别的人脸数目。
|
8368
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
8369
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
8370
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
8205
8371
|
:rtype: int
|
8206
8372
|
"""
|
8207
8373
|
return self._MaxFaceNum
|
@@ -8212,7 +8378,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8212
8378
|
|
8213
8379
|
@property
|
8214
8380
|
def MinFaceSize(self):
|
8215
|
-
"""
|
8381
|
+
"""人脸长和宽的最小尺寸,单位为像素。
|
8382
|
+
- 默认为34。
|
8383
|
+
- 低于34将影响搜索精度。
|
8384
|
+
- 建议设置为80。
|
8216
8385
|
:rtype: int
|
8217
8386
|
"""
|
8218
8387
|
return self._MinFaceSize
|
@@ -8223,9 +8392,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8223
8392
|
|
8224
8393
|
@property
|
8225
8394
|
def MaxPersonNum(self):
|
8226
|
-
"""
|
8227
|
-
|
8228
|
-
|
8395
|
+
"""单张被识别的人脸返回的最相似人员数量。
|
8396
|
+
- 默认值为5,最大值为100。
|
8397
|
+
- 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
|
8398
|
+
- 值越大,需要处理的时间越长。建议不要超过10。
|
8229
8399
|
:rtype: int
|
8230
8400
|
"""
|
8231
8401
|
return self._MaxPersonNum
|
@@ -8237,13 +8407,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8237
8407
|
@property
|
8238
8408
|
def QualityControl(self):
|
8239
8409
|
"""图片质量控制。
|
8240
|
-
|
8241
|
-
|
8242
|
-
|
8243
|
-
|
8244
|
-
|
8245
|
-
|
8246
|
-
|
8410
|
+
- 取值范围:
|
8411
|
+
0: 不进行控制。
|
8412
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8413
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8414
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8415
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8416
|
+
- 默认 0。
|
8417
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8247
8418
|
:rtype: int
|
8248
8419
|
"""
|
8249
8420
|
return self._QualityControl
|
@@ -8254,7 +8425,9 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8254
8425
|
|
8255
8426
|
@property
|
8256
8427
|
def FaceMatchThreshold(self):
|
8257
|
-
"""出参Score中,只有大于等于FaceMatchThreshold
|
8428
|
+
"""出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
|
8429
|
+
- 默认为0。
|
8430
|
+
- 取值范围:[0.0,100.0) 。
|
8258
8431
|
:rtype: float
|
8259
8432
|
"""
|
8260
8433
|
return self._FaceMatchThreshold
|
@@ -8265,7 +8438,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8265
8438
|
|
8266
8439
|
@property
|
8267
8440
|
def NeedPersonInfo(self):
|
8268
|
-
"""是否返回人员具体信息。
|
8441
|
+
"""是否返回人员具体信息。
|
8442
|
+
- 取值范围:0 为关闭,1 为开启。
|
8443
|
+
- 默认为 0。
|
8444
|
+
- 其他非0非1值默认为0
|
8269
8445
|
:rtype: int
|
8270
8446
|
"""
|
8271
8447
|
return self._NeedPersonInfo
|
@@ -8276,7 +8452,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8276
8452
|
|
8277
8453
|
@property
|
8278
8454
|
def NeedRotateDetection(self):
|
8279
|
-
"""是否开启图片旋转识别支持。
|
8455
|
+
"""是否开启图片旋转识别支持。
|
8456
|
+
- 取值范围:0为不开启,1为开启。
|
8457
|
+
- 默认为0。
|
8458
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8459
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8280
8460
|
:rtype: int
|
8281
8461
|
"""
|
8282
8462
|
return self._NeedRotateDetection
|
@@ -8394,42 +8574,59 @@ class SearchPersonsReturnsByGroupRequest(AbstractModel):
|
|
8394
8574
|
|
8395
8575
|
def __init__(self):
|
8396
8576
|
r"""
|
8397
|
-
:param _GroupIds: 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId
|
8577
|
+
:param _GroupIds: 希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
|
8398
8578
|
:type GroupIds: list of str
|
8399
|
-
:param _Image: 图片 base64
|
8400
|
-
|
8401
|
-
|
8579
|
+
:param _Image: 图片 base64 数据。
|
8580
|
+
- base64 编码后大小不可超过5M。
|
8581
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8582
|
+
- 所有格式的图片短边像素不小于64。
|
8583
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8402
8584
|
:type Image: str
|
8403
|
-
:param _Url: 图片的 Url
|
8404
|
-
|
8405
|
-
|
8406
|
-
|
8407
|
-
|
8408
|
-
|
8585
|
+
:param _Url: 图片的 Url 。
|
8586
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8587
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8588
|
+
- 所有格式的图片短边像素不小于64。
|
8589
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8590
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8591
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8592
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8409
8593
|
:type Url: str
|
8410
|
-
:param _MaxFaceNum:
|
8411
|
-
|
8412
|
-
|
8594
|
+
:param _MaxFaceNum: 最多识别的人脸数目。
|
8595
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
8596
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
8597
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
8413
8598
|
:type MaxFaceNum: int
|
8414
|
-
:param _MinFaceSize:
|
8599
|
+
:param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
|
8600
|
+
- 默认为34。
|
8601
|
+
- 低于34将影响搜索精度。
|
8602
|
+
- 建议设置为80。
|
8415
8603
|
:type MinFaceSize: int
|
8416
|
-
:param _MaxPersonNumPerGroup:
|
8417
|
-
|
8604
|
+
:param _MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。
|
8605
|
+
- 默认值为5,最大值为10。
|
8606
|
+
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
8418
8607
|
:type MaxPersonNumPerGroup: int
|
8419
8608
|
:param _QualityControl: 图片质量控制。
|
8420
|
-
|
8421
|
-
|
8422
|
-
|
8423
|
-
|
8424
|
-
|
8425
|
-
|
8426
|
-
|
8609
|
+
- 取值范围:
|
8610
|
+
0: 不进行控制。
|
8611
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8612
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8613
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8614
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8615
|
+
- 默认 0。
|
8616
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8427
8617
|
:type QualityControl: int
|
8428
8618
|
:param _FaceMatchThreshold: 出参Score中,只有超过FaceMatchThreshold值的结果才会返回。默认为0。
|
8429
8619
|
:type FaceMatchThreshold: float
|
8430
|
-
:param _NeedPersonInfo: 是否返回人员具体信息。
|
8620
|
+
:param _NeedPersonInfo: 是否返回人员具体信息。
|
8621
|
+
- 取值范围:0 为关闭,1 为开启。
|
8622
|
+
- 默认为 0。
|
8623
|
+
- 其他非0非1值默认为0。
|
8431
8624
|
:type NeedPersonInfo: int
|
8432
|
-
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8625
|
+
:param _NeedRotateDetection: 是否开启图片旋转识别支持。
|
8626
|
+
- 取值范围:0为不开启,1为开启。
|
8627
|
+
- 默认为0。
|
8628
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8629
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8433
8630
|
:type NeedRotateDetection: int
|
8434
8631
|
"""
|
8435
8632
|
self._GroupIds = None
|
@@ -8445,7 +8642,7 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8445
8642
|
|
8446
8643
|
@property
|
8447
8644
|
def GroupIds(self):
|
8448
|
-
"""希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId
|
8645
|
+
"""希望搜索的人员库列表,上限60个。数组元素取值为创建人员库接口中的GroupId。
|
8449
8646
|
:rtype: list of str
|
8450
8647
|
"""
|
8451
8648
|
return self._GroupIds
|
@@ -8456,9 +8653,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8456
8653
|
|
8457
8654
|
@property
|
8458
8655
|
def Image(self):
|
8459
|
-
"""图片 base64
|
8460
|
-
|
8461
|
-
|
8656
|
+
"""图片 base64 数据。
|
8657
|
+
- base64 编码后大小不可超过5M。
|
8658
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8659
|
+
- 所有格式的图片短边像素不小于64。
|
8660
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8462
8661
|
:rtype: str
|
8463
8662
|
"""
|
8464
8663
|
return self._Image
|
@@ -8469,12 +8668,14 @@ jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2
|
|
8469
8668
|
|
8470
8669
|
@property
|
8471
8670
|
def Url(self):
|
8472
|
-
"""图片的 Url
|
8473
|
-
|
8474
|
-
|
8475
|
-
|
8476
|
-
|
8477
|
-
|
8671
|
+
"""图片的 Url 。
|
8672
|
+
- 对应图片 base64 编码后大小不可超过5M。
|
8673
|
+
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
|
8674
|
+
- 所有格式的图片短边像素不小于64。
|
8675
|
+
- Url、Image必须提供一个,如果都提供,只使用 Url。
|
8676
|
+
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
|
8677
|
+
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
|
8678
|
+
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
|
8478
8679
|
:rtype: str
|
8479
8680
|
"""
|
8480
8681
|
return self._Url
|
@@ -8485,9 +8686,10 @@ Url、Image必须提供一个,如果都提供,只使用 Url。
|
|
8485
8686
|
|
8486
8687
|
@property
|
8487
8688
|
def MaxFaceNum(self):
|
8488
|
-
"""
|
8489
|
-
|
8490
|
-
|
8689
|
+
"""最多识别的人脸数目。
|
8690
|
+
- 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
|
8691
|
+
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
|
8692
|
+
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
|
8491
8693
|
:rtype: int
|
8492
8694
|
"""
|
8493
8695
|
return self._MaxFaceNum
|
@@ -8498,7 +8700,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8498
8700
|
|
8499
8701
|
@property
|
8500
8702
|
def MinFaceSize(self):
|
8501
|
-
"""
|
8703
|
+
"""人脸长和宽的最小尺寸,单位为像素。
|
8704
|
+
- 默认为34。
|
8705
|
+
- 低于34将影响搜索精度。
|
8706
|
+
- 建议设置为80。
|
8502
8707
|
:rtype: int
|
8503
8708
|
"""
|
8504
8709
|
return self._MinFaceSize
|
@@ -8509,8 +8714,9 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8509
8714
|
|
8510
8715
|
@property
|
8511
8716
|
def MaxPersonNumPerGroup(self):
|
8512
|
-
"""
|
8513
|
-
|
8717
|
+
"""被检测到的人脸,对应最多返回的最相似人员数目。
|
8718
|
+
- 默认值为5,最大值为10。
|
8719
|
+
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
|
8514
8720
|
:rtype: int
|
8515
8721
|
"""
|
8516
8722
|
return self._MaxPersonNumPerGroup
|
@@ -8522,13 +8728,14 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8522
8728
|
@property
|
8523
8729
|
def QualityControl(self):
|
8524
8730
|
"""图片质量控制。
|
8525
|
-
|
8526
|
-
|
8527
|
-
|
8528
|
-
|
8529
|
-
|
8530
|
-
|
8531
|
-
|
8731
|
+
- 取值范围:
|
8732
|
+
0: 不进行控制。
|
8733
|
+
1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
8734
|
+
2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
8735
|
+
3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
8736
|
+
4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
8737
|
+
- 默认 0。
|
8738
|
+
- 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
8532
8739
|
:rtype: int
|
8533
8740
|
"""
|
8534
8741
|
return self._QualityControl
|
@@ -8550,7 +8757,10 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8550
8757
|
|
8551
8758
|
@property
|
8552
8759
|
def NeedPersonInfo(self):
|
8553
|
-
"""是否返回人员具体信息。
|
8760
|
+
"""是否返回人员具体信息。
|
8761
|
+
- 取值范围:0 为关闭,1 为开启。
|
8762
|
+
- 默认为 0。
|
8763
|
+
- 其他非0非1值默认为0。
|
8554
8764
|
:rtype: int
|
8555
8765
|
"""
|
8556
8766
|
return self._NeedPersonInfo
|
@@ -8561,7 +8771,11 @@ MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要
|
|
8561
8771
|
|
8562
8772
|
@property
|
8563
8773
|
def NeedRotateDetection(self):
|
8564
|
-
"""是否开启图片旋转识别支持。
|
8774
|
+
"""是否开启图片旋转识别支持。
|
8775
|
+
- 取值范围:0为不开启,1为开启。
|
8776
|
+
- 默认为0。
|
8777
|
+
- 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
|
8778
|
+
- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
|
8565
8779
|
:rtype: int
|
8566
8780
|
"""
|
8567
8781
|
return self._NeedRotateDetection
|