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.
Files changed (78) hide show
  1. tencentcloud/__init__.py +1 -1
  2. tencentcloud/apm/v20210622/models.py +128 -0
  3. tencentcloud/asr/v20190614/models.py +2 -2
  4. tencentcloud/autoscaling/v20180419/models.py +65 -6
  5. tencentcloud/batch/v20170312/models.py +20 -2
  6. tencentcloud/cat/v20180409/models.py +20 -0
  7. tencentcloud/cbs/v20170312/models.py +124 -70
  8. tencentcloud/ccc/v20200210/models.py +125 -0
  9. tencentcloud/cdb/v20170320/cdb_client.py +2 -2
  10. tencentcloud/cdb/v20170320/errorcodes.py +1 -1
  11. tencentcloud/cdb/v20170320/models.py +17 -6
  12. tencentcloud/cdc/v20201214/models.py +2 -54
  13. tencentcloud/cdz/v20221123/models.py +75 -1
  14. tencentcloud/ckafka/v20190819/models.py +67 -22
  15. tencentcloud/clb/v20180317/clb_client.py +1 -1
  16. tencentcloud/clb/v20180317/models.py +54 -20
  17. tencentcloud/cloudstudio/v20230508/models.py +0 -18
  18. tencentcloud/cls/v20201016/models.py +91 -0
  19. tencentcloud/cvm/v20170312/models.py +99 -22
  20. tencentcloud/cwp/v20180228/cwp_client.py +0 -25
  21. tencentcloud/cwp/v20180228/models.py +0 -197
  22. tencentcloud/dasb/v20191018/models.py +150 -0
  23. tencentcloud/emr/v20190103/emr_client.py +9 -9
  24. tencentcloud/emr/v20190103/models.py +325 -1
  25. tencentcloud/es/v20180416/errorcodes.py +3 -0
  26. tencentcloud/es/v20180416/models.py +30 -0
  27. tencentcloud/ess/v20201111/ess_client.py +22 -30
  28. tencentcloud/ess/v20201111/models.py +59 -14
  29. tencentcloud/essbasic/v20210526/essbasic_client.py +34 -8
  30. tencentcloud/essbasic/v20210526/models.py +77 -28
  31. tencentcloud/faceid/v20180301/models.py +983 -539
  32. tencentcloud/gme/v20180711/errorcodes.py +9 -0
  33. tencentcloud/gme/v20180711/models.py +17 -2
  34. tencentcloud/hai/v20230812/models.py +2 -2
  35. tencentcloud/hunyuan/v20230901/models.py +30 -0
  36. tencentcloud/iai/v20180301/models.py +40 -26
  37. tencentcloud/iai/v20200303/models.py +760 -546
  38. tencentcloud/iotexplorer/v20190423/errorcodes.py +1 -1
  39. tencentcloud/iotexplorer/v20190423/models.py +8 -8
  40. tencentcloud/iotvideo/v20191126/models.py +4 -4
  41. tencentcloud/lke/v20231130/models.py +12 -12
  42. tencentcloud/monitor/v20180724/models.py +17 -0
  43. tencentcloud/mrs/v20200910/models.py +27 -8
  44. tencentcloud/ms/v20180408/ms_client.py +3 -1
  45. tencentcloud/ocr/v20181119/models.py +519 -14
  46. tencentcloud/ocr/v20181119/ocr_client.py +49 -2
  47. tencentcloud/omics/v20221128/models.py +100 -232
  48. tencentcloud/partners/v20180321/models.py +2 -92
  49. tencentcloud/rce/v20201103/errorcodes.py +132 -0
  50. tencentcloud/rce/v20201103/models.py +261 -0
  51. tencentcloud/rce/v20201103/rce_client.py +23 -0
  52. tencentcloud/redis/v20180412/models.py +2 -6
  53. tencentcloud/rum/v20210622/models.py +15 -0
  54. tencentcloud/scf/v20180416/models.py +2 -2
  55. tencentcloud/ssl/v20191205/models.py +2 -2
  56. tencentcloud/tdmq/v20200217/models.py +40 -10
  57. tencentcloud/tds/v20220801/models.py +4 -4
  58. tencentcloud/thpc/v20230321/models.py +2 -2
  59. tencentcloud/tke/v20180525/models.py +2 -4
  60. tencentcloud/tmt/v20180321/models.py +60 -5
  61. tencentcloud/trro/v20220325/models.py +0 -30
  62. tencentcloud/trtc/v20190722/models.py +97 -2
  63. tencentcloud/vclm/v20240523/models.py +170 -100
  64. tencentcloud/vclm/v20240523/vclm_client.py +52 -52
  65. tencentcloud/vod/v20180717/models.py +114 -2
  66. tencentcloud/vod/v20180717/vod_client.py +1 -1
  67. tencentcloud/vod/v20240718/models.py +15 -15
  68. tencentcloud/vpc/v20170312/errorcodes.py +3 -0
  69. tencentcloud/vpc/v20170312/models.py +167 -10
  70. tencentcloud/vpc/v20170312/vpc_client.py +7 -2
  71. tencentcloud/waf/v20180125/models.py +618 -0
  72. tencentcloud/waf/v20180125/waf_client.py +69 -0
  73. tencentcloud/wedata/v20210820/models.py +18 -18
  74. {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/METADATA +1 -1
  75. {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/RECORD +78 -78
  76. {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/LICENSE +0 -0
  77. {tencentcloud_sdk_python-3.0.1265.dist-info → tencentcloud_sdk_python-3.0.1267.dist-info}/WHEEL +0 -0
  78. {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 数据,base64 编码后大小不可超过5M。
670
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
671
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
672
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
675
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
676
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
677
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
680
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
681
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
682
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
683
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
684
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
685
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
688
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
689
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
690
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
691
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
692
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
693
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- 目前入参支持 2.0”和“3.0“ 两个输入。
698
-
699
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
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: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
728
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
729
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
730
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
742
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
743
- 若图片中包含多张人脸,只选取其中置信度最高的人脸。
744
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
756
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
757
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
758
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
759
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
760
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
761
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
773
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
774
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
775
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
776
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
777
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
778
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- 目前入参支持 2.0”和“3.0“ 两个输入。
792
-
793
- 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
928
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
929
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
930
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
933
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
934
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
935
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
938
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
939
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
940
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
941
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
942
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
943
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
946
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
947
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
948
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
949
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
950
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
951
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
975
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
976
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
977
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
989
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
990
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
991
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
1003
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1004
- A 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
1005
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1006
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1007
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1008
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 ,对应图片 base64 编码后大小不可超过5M
1020
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1021
- B 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
1022
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1023
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1024
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1025
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 数据,base64 编码后大小不可超过5M。
1266
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1267
- 人员人脸总数量不可超过5张。
1268
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1269
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
1272
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1273
- Url、Image必须提供一个,如果都提供,只使用 Url
1274
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1275
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1276
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1277
- 人员人脸总数量不可超过5张。
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分。取值范围[0,100] 。
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: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
1316
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1317
- 人员人脸总数量不可超过5张。
1318
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
1319
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
1331
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1332
- Url、Image必须提供一个,如果都提供,只使用 Url
1333
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1334
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1335
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1336
- 人员人脸总数量不可超过5张。
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分。取值范围[0,100] 。
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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: 每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,-1109 代表图片尺寸过大或者过小,
1417
- -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
1418
- 其他非 0 值代表算法服务异常。
1419
- RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
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: 加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
1422
- 例如, Urls 3 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
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
- """每张人脸图片添加结果,-1101 代表未检测到人脸,-1102 代表图片解码失败,-1109 代表图片尺寸过大或者过小,
1464
- -1601代表不符合图片质量控制要求, -1604 代表人脸相似度没有超过FaceMatchThreshold。
1465
- 其他非 0 值代表算法服务异常。
1466
- RetCode的顺序和入参中 Images 或 Urls 的顺序一致。
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
- """加入成功的人脸索引。索引顺序和入参中 Images 或 Urls 的顺序一致。
1478
- 例如, Urls 3 url,第二个 url 失败,则 SucIndexes 值为 [0,2] 。
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,单个腾讯云账号下不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B
1750
+ :param _PersonId: 人员ID。
1751
+ - 单个腾讯云账号下不可修改,不可重复。
1752
+ - 支持英文、数字、-%@#&_,长度限制64B。
1707
1753
  :type PersonId: str
1708
- :param _Gender: 0代表未填写,1代表男性,2代表女性。
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 数据,base64 编码后大小不可超过5M。
1713
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1714
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
1717
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1718
- Url、Image必须提供一个,如果都提供,只使用 Url
1719
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1720
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1721
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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,单个腾讯云账号下不可修改,不可重复。支持英文、数字、-%@#&_,长度限制64B
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
- """0代表未填写,1代表男性,2代表女性。
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 数据,base64 编码后大小不可超过5M。
1815
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1816
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
1828
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1829
- Url、Image必须提供一个,如果都提供,只使用 Url
1830
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1831
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
1832
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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: 人员性别,0代表未填写,1代表男性,2代表女性
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
- """人员性别,0代表未填写,1代表男性,2代表女性
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个。数组元素取值为创建人员库接口中的GroupId。
7533
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
7600
+ :param _GroupIds: 希望搜索的人员库列表,上限100个。
7601
+ - 数组元素取值为创建人员库接口中的GroupId。
7602
+ - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
7534
7603
  :type GroupIds: list of str
7535
- :param _Image: 图片 base64 数据,base64 编码后大小不可超过5M。
7536
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7537
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
7540
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7541
- Url、Image必须提供一个,如果都提供,只使用 Url
7542
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
7543
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
7544
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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: 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7547
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7548
- 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
7619
+ :param _MaxFaceNum: 最多识别的人脸数目。
7620
+ - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7621
+ - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7622
+ - 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
7549
7623
  :type MaxFaceNum: int
7550
- :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
7624
+ :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
7625
+ - 默认为34。
7626
+ - 低于34的人脸图片无法被识别。
7627
+ - 建议设置为80。
7551
7628
  :type MinFaceSize: int
7552
- :param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
7553
- 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
7554
- 值越大,需要处理的时间越长。建议不要超过10。
7629
+ :param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
7630
+ - 默认值为5,最大值为100。
7631
+ - 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
7632
+ - 值越大,需要处理的时间越长。
7633
+ - 建议不要超过10。
7555
7634
  :type MaxPersonNum: int
7556
- :param _NeedPersonInfo: 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
7635
+ :param _NeedPersonInfo: 是否返回人员具体信息。
7636
+ - 取值范围:0 为关闭,1 为开启。
7637
+ - 默认为 0。
7638
+ - 其他非0非1值默认为0。
7557
7639
  :type NeedPersonInfo: int
7558
7640
  :param _QualityControl: 图片质量控制。
7559
- 0: 不进行控制;
7560
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
7561
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
7562
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
7563
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
7564
- 默认 0。
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: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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个。数组元素取值为创建人员库接口中的GroupId。
7586
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
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 数据,base64 编码后大小不可超过5M。
7598
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7599
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
7611
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7612
- Url、Image必须提供一个,如果都提供,只使用 Url
7613
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
7614
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
7615
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- """最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7627
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7628
- 例如:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
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
- """人脸长和宽的最小尺寸,单位为像素。默认为34。低于34的人脸图片无法被识别。建议设置为80。
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
- """单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
7651
- 例如,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
7652
- 值越大,需要处理的时间越长。建议不要超过10。
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
- """是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
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
- 0: 不进行控制;
7676
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
7677
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
7678
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
7679
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
7680
- 默认 0。
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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个。数组元素取值为创建人员库接口中的GroupId。
7820
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
7925
+ :param _GroupIds: 希望搜索的人员库列表,上限60个。
7926
+ - 数组元素取值为创建人员库接口中的GroupId。
7927
+ - 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
7821
7928
  :type GroupIds: list of str
7822
- :param _Image: 图片 base64 数据,base64 编码后大小不可超过5M。
7823
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7824
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
7827
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7828
- Url、Image必须提供一个,如果都提供,只使用 Url
7829
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
7830
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
7831
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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: 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7834
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7835
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
7944
+ :param _MaxFaceNum: 最多识别的人脸数目。
7945
+ - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7946
+ - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7947
+ - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
7836
7948
  :type MaxFaceNum: int
7837
- :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
7949
+ :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
7950
+ - 默认为34。
7951
+ - 低于34将影响搜索精度。
7952
+ - 建议设置为80。
7838
7953
  :type MinFaceSize: int
7839
- :param _MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
7840
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
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: 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
7958
+ :param _NeedPersonInfo: 是否返回人员具体信息。
7959
+ - 取值范围:0 为关闭,1 为开启。
7960
+ - 默认为 0。
7961
+ - 其他非0非1值默认为0
7843
7962
  :type NeedPersonInfo: int
7844
7963
  :param _QualityControl: 图片质量控制。
7845
- 0: 不进行控制;
7846
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
7847
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
7848
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
7849
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
7850
- 默认 0。
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
- 取值范围[0.0,100.0) 。
7974
+ - 默认为0。
7975
+ - 取值范围:[0.0,100.0) 。
7856
7976
  :type FaceMatchThreshold: float
7857
- :param _NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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个。数组元素取值为创建人员库接口中的GroupId。
7874
- 不可同时搜索不同算法模型版本(FaceModelVersion)的人员库。
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 数据,base64 编码后大小不可超过5M。
7886
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7887
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
7899
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
7900
- Url、Image必须提供一个,如果都提供,只使用 Url
7901
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
7902
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
7903
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- """最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
7915
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
7916
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
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
- """人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
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
- """被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
7939
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
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
- """是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
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
- 0: 不进行控制;
7963
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
7964
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
7965
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
7966
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
7967
- 默认 0。
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
- 取值范围[0.0,100.0) 。
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
8111
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8112
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
8113
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
8116
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8117
- Url、Image必须提供一个,如果都提供,只使用 Url
8118
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
8119
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
8120
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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: 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8123
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8124
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
8268
+ :param _MaxFaceNum: 最多识别的人脸数目。
8269
+ - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8270
+ - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8271
+ - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
8125
8272
  :type MaxFaceNum: int
8126
- :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
8273
+ :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
8274
+ - 默认为34。
8275
+ - 低于34将影响搜索精度。
8276
+ - 建议设置为80。
8127
8277
  :type MinFaceSize: int
8128
- :param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
8129
- 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
8130
- 值越大,需要处理的时间越长。建议不要超过10。
8278
+ :param _MaxPersonNum: 单张被识别的人脸返回的最相似人员数量。
8279
+ - 默认值为5,最大值为100。
8280
+ - 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
8281
+ - 值越大,需要处理的时间越长。建议不要超过10。
8131
8282
  :type MaxPersonNum: int
8132
8283
  :param _QualityControl: 图片质量控制。
8133
- 0: 不进行控制;
8134
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
8135
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
8136
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
8137
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
8138
- 默认 0。
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值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
8293
+ :param _FaceMatchThreshold: 出参Score中,只有大于等于FaceMatchThreshold值的结果才会返回。
8294
+ - 默认为0。
8295
+ - 取值范围:[0.0,100.0) 。
8142
8296
  :type FaceMatchThreshold: float
8143
- :param _NeedPersonInfo: 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
8297
+ :param _NeedPersonInfo: 是否返回人员具体信息。
8298
+ - 取值范围:0 为关闭,1 为开启。
8299
+ - 默认为 0。
8300
+ - 其他非0非1值默认为0
8144
8301
  :type NeedPersonInfo: int
8145
- :param _NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
8173
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8174
- 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
8175
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
8187
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8188
- Url、Image必须提供一个,如果都提供,只使用 Url
8189
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
8190
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
8191
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- """最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8203
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8204
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
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
- """人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
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
- """单张被识别的人脸返回的最相似人员数量。默认值为5,最大值为100。
8227
- 例,设MaxFaceNum为1,MaxPersonNum为8,则返回Top8相似的人员信息。
8228
- 值越大,需要处理的时间越长。建议不要超过10。
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
- 0: 不进行控制;
8241
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
8242
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
8243
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
8244
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
8245
- 默认 0。
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值的结果才会返回。默认为0。取值范围[0.0,100.0) 。
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
- """是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
8400
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8401
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
8404
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8405
- Url、Image必须提供一个,如果都提供,只使用 Url
8406
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
8407
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
8408
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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: 最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8411
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8412
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
8594
+ :param _MaxFaceNum: 最多识别的人脸数目。
8595
+ - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8596
+ - MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8597
+ - 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
8413
8598
  :type MaxFaceNum: int
8414
- :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
8599
+ :param _MinFaceSize: 人脸长和宽的最小尺寸,单位为像素。
8600
+ - 默认为34。
8601
+ - 低于34将影响搜索精度。
8602
+ - 建议设置为80。
8415
8603
  :type MinFaceSize: int
8416
- :param _MaxPersonNumPerGroup: 被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
8417
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
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
- 0: 不进行控制;
8421
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
8422
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
8423
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
8424
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
8425
- 默认 0。
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: 是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
8620
+ :param _NeedPersonInfo: 是否返回人员具体信息。
8621
+ - 取值范围:0 为关闭,1 为开启。
8622
+ - 默认为 0。
8623
+ - 其他非0非1值默认为0。
8431
8624
  :type NeedPersonInfo: int
8432
- :param _NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
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 数据,base64 编码后大小不可超过5M。
8460
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8461
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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 。对应图片 base64 编码后大小不可超过5M
8473
- jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
8474
- Url、Image必须提供一个,如果都提供,只使用 Url
8475
- 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
8476
- 非腾讯云存储的Url速度和稳定性可能受一定影响。
8477
- 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
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
- """最多识别的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为10。
8489
- MaxFaceNum用于,当输入的待识别图片包含多张人脸时,设定要搜索的人脸的数量。
8490
- 例:输入的Image或Url中的图片包含多张人脸,设MaxFaceNum=5,则会识别图片中面积最大的5张人脸。
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
- """人脸长和宽的最小尺寸,单位为像素。默认为34。低于34将影响搜索精度。建议设置为80。
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
- """被检测到的人脸,对应最多返回的最相似人员数目。默认值为5,最大值为10。
8513
- 例,设MaxFaceNum为3,MaxPersonNumPerGroup为5,GroupIds长度为3,则最多可能返回3*5*3=45个人员。
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
- 0: 不进行控制;
8526
- 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
8527
- 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
8528
- 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
8529
- 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
8530
- 默认 0。
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
- """是否返回人员具体信息。0 为关闭,1 为开启。默认为 0。其他非0非1值默认为0
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
- """是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
8774
+ """是否开启图片旋转识别支持。
8775
+ - 取值范围:0为不开启,1为开启。
8776
+ - 默认为0。
8777
+ - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
8778
+ - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
8565
8779
  :rtype: int
8566
8780
  """
8567
8781
  return self._NeedRotateDetection