tencentcloud-sdk-iai 3.0.939 → 3.0.941

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 30a3af4d579230b7412940939b4c879a690e21b0
4
- data.tar.gz: 6ecbe8df43529691747e10d26a7bd748d24f4738
3
+ metadata.gz: ede02ebcdbb5b8e85386c72ff3bc8057805f5403
4
+ data.tar.gz: 18ca7507c6021fa9cd04810eb144444b0dae7a1f
5
5
  SHA512:
6
- metadata.gz: 36cb325e1404c86a11aa2529866670c127e99945c16dc6cbba1b1003dcd84c0c24cd7572496c0e0093fdd42c43ce66547b80d5e95b85cfe3bbfa21f760bc77fc
7
- data.tar.gz: 079506748629cd8d55c349bd339fa3272075271d4891f39524b3b3751b3e26f1737a2034d5d0f79b715d7463661aa4811565ce43be739aa0075f4bde0b0447df
6
+ metadata.gz: d800cdaf1baeb97a5bfc5ade9ca4165e53ac2b52a2bc053edd11094870a30e821796bc90adf39cfb97d985b5515cf54a6aa361c9c8bc492a2d6f8fbcd11422b4
7
+ data.tar.gz: ce622d32bdaa744a4f51bb4aa03817ef5e6d186fd7d2796536a8a76ab669a62e2a94e7ff9fe2168062c111114ceebe2973be05a150eb1ddf53bf4f8f5a967707
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.939
1
+ 3.0.941
@@ -2749,9 +2749,9 @@ module TencentCloud
2749
2749
 
2750
2750
  # 坐标
2751
2751
  class Point < TencentCloud::Common::AbstractModel
2752
- # @param X: x坐标
2752
+ # @param X: x坐标。
2753
2753
  # @type X: Integer
2754
- # @param Y: Y坐标
2754
+ # @param Y: Y坐标。
2755
2755
  # @type Y: Integer
2756
2756
 
2757
2757
  attr_accessor :X, :Y
@@ -19,24 +19,31 @@ module TencentCloud
19
19
  module V20200303
20
20
  # AnalyzeDenseLandmarks请求参数结构体
21
21
  class AnalyzeDenseLandmarksRequest < TencentCloud::Common::AbstractModel
22
- # @param Mode: 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
23
- # 默认为 0
24
- # 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
22
+ # @param Mode: 检测模式。
23
+ # - 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
24
+ # - 默认为 0。
25
+ # - 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
25
26
  # @type Mode: Integer
26
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
27
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
28
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
27
+ # @param Image: 图片 base64 数据。
28
+ # - base64 编码后大小不可超过5M
29
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
30
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
29
31
  # @type Image: String
30
- # @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M
31
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
32
- # Url、Image必须提供一个,如果都提供,只使用 Url
33
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
34
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
35
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
32
+ # @param Url: 图片的 Url 。
33
+ # - 对应图片 base64 编码后大小不可超过5M
34
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
35
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
36
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
37
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
38
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
36
39
  # @type Url: String
37
40
  # @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持 “3.0“ 输入。
38
41
  # @type FaceModelVersion: String
39
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
42
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
43
+ # - 取值范围:0为不开启,1为开启。
44
+ # - 默认为0。
45
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
46
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
40
47
  # @type NeedRotateDetection: Integer
41
48
 
42
49
  attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
@@ -99,30 +106,37 @@ module TencentCloud
99
106
 
100
107
  # AnalyzeFace请求参数结构体
101
108
  class AnalyzeFaceRequest < TencentCloud::Common::AbstractModel
102
- # @param Mode: 检测模式。0 为检测所有出现的人脸, 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
109
+ # @param Mode: 检测模式。
110
+ # - 取值范围:
111
+ # 0 为检测所有出现的人脸。
112
+ # 1 为检测面积最大的人脸。
113
+ # - 默认为 0。
114
+ # - 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
103
115
  # @type Mode: Integer
104
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
105
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
106
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
116
+ # @param Image: 图片 base64 数据。
117
+ # - base64 编码后大小不可超过5M
118
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
119
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
107
120
  # @type Image: String
108
- # @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M
109
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
110
- # Url、Image必须提供一个,如果都提供,只使用 Url
111
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
112
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
113
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
121
+ # @param Url: 图片的 Url 。
122
+ # - 对应图片 base64 编码后大小不可超过5M
123
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
124
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
125
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
126
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
127
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
114
128
  # @type Url: String
115
129
  # @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
116
-
117
- # 目前入参支持 2.0”和“3.0“ 两个输入。
118
-
119
- # 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
120
-
121
- # 2020年11月26日后开通服务的账号仅支持输入“3.0”。
122
-
123
- # 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
130
+ # - 目前入参支持 “2.0”和“3.0“ 两个输入。
131
+ # - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
132
+ # - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
133
+ # - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
124
134
  # @type FaceModelVersion: String
125
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
135
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
136
+ # - 0为不开启,1为开启。
137
+ # - 默认为0。
138
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
139
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
126
140
  # @type NeedRotateDetection: Integer
127
141
 
128
142
  attr_accessor :Mode, :Image, :Url, :FaceModelVersion, :NeedRotateDetection
@@ -185,9 +199,10 @@ module TencentCloud
185
199
 
186
200
  # 人脸属性信息
187
201
  class AttributeItem < TencentCloud::Common::AbstractModel
188
- # @param Type: 属性值
202
+ # @param Type: 属性值。
189
203
  # @type Type: Integer
190
- # @param Probability: Type识别概率值,[0,1],代表判断正确的概率。
204
+ # @param Probability: Type识别概率值。
205
+ # - 取值范围:[0,1],代表判断正确的概率。
191
206
  # @type Probability: Float
192
207
 
193
208
  attr_accessor :Type, :Probability
@@ -205,25 +220,25 @@ module TencentCloud
205
220
 
206
221
  # 识别出的最相似候选人
207
222
  class Candidate < TencentCloud::Common::AbstractModel
208
- # @param PersonId: 人员ID
223
+ # @param PersonId: 人员ID
209
224
  # @type PersonId: String
210
- # @param FaceId: 人脸ID,仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。人员搜索类接口采用融合特征方式检索,该字段无意义
225
+ # @param FaceId: 人脸ID
226
+ # - 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
227
+ # - 人员搜索类接口采用融合特征方式检索,该字段无意义。
211
228
  # @type FaceId: String
212
229
  # @param Score: 候选者的匹配得分。
213
-
214
- # 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分;
215
- # 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分;
216
- # 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
217
-
218
- # 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
230
+ # - 1万大小人脸底库下,误识率百分之一对应分数为70分,误识率千分之一对应分数为80分,误识率万分之一对应分数为90分。
231
+ # - 10万大小人脸底库下,误识率百分之一对应分数为80分,误识率千分之一对应分数为90分,误识率万分之一对应分数为100分。
232
+ # - 30万大小人脸底库下,误识率百分之一对应分数为85分,误识率千分之一对应分数为95分。
233
+ # - 一般80分左右可适用大部分场景,建议分数不要超过90分。您可以根据实际情况选择合适的分数。
219
234
  # @type Score: Float
220
- # @param PersonName: 人员名称
235
+ # @param PersonName: 人员名称。
221
236
  # 注意:此字段可能返回 null,表示取不到有效值。
222
237
  # @type PersonName: String
223
- # @param Gender: 人员性别
238
+ # @param Gender: 人员性别。
224
239
  # 注意:此字段可能返回 null,表示取不到有效值。
225
240
  # @type Gender: Integer
226
- # @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表
241
+ # @param PersonGroupInfos: 包含此人员的人员库及描述字段内容列表。
227
242
  # 注意:此字段可能返回 null,表示取不到有效值。
228
243
  # @type PersonGroupInfos: Array
229
244
 
@@ -1105,30 +1120,36 @@ module TencentCloud
1105
1120
  # DetectFaceAttributes请求参数结构体
1106
1121
  class DetectFaceAttributesRequest < TencentCloud::Common::AbstractModel
1107
1122
  # @param MaxFaceNum: 最多处理的人脸数目。
1108
- # 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
1109
- # 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
1123
+ # - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
1124
+ # - 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
1110
1125
  # @type MaxFaceNum: Integer
1111
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
1112
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。 所有格式的图片短边像素不小于64
1113
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1126
+ # @param Image: 图片 base64 数据。
1127
+ # - base64 编码后大小不可超过5M
1128
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1129
+ # - 所有格式的图片短边像素不小于64。
1130
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1114
1131
  # @type Image: String
1115
1132
  # @param Url: 图片的 Url 。
1116
- # 对应图片 base64 编码后大小不可超过5M。
1117
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
1118
- # Url、Image必须提供一个,如果都提供,只使用 Url。
1119
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1120
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
1121
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1133
+ # - 对应图片 base64 编码后大小不可超过5M。
1134
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
1135
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
1136
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1137
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
1138
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1122
1139
  # @type Url: String
1123
1140
  # @param FaceAttributesType: 是否返回年龄、性别、情绪等属性。
1124
- # 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、
1125
- # Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
1126
- # None为不需要返回。默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
1127
- # 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
1128
- # 关于各属性的详细描述,参见下文出参。
1129
- # 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
1141
+ # - 合法值为(大小写不敏感):None、Age、Beauty、Emotion、Eye、Eyebrow、Gender、Hair、Hat、Headpose、Mask、Mouth、Moustache、Nose、Shape、Skin、Smile。
1142
+ # - None为不需要返回。
1143
+ # - 默认为 None。即FaceAttributesType属性为空时,各属性返回值为0。
1144
+ # - 需要将属性组成一个用逗号分隔的字符串,属性之间的顺序没有要求。
1145
+ # - 关于各属性的详细描述,参见下文出参。
1146
+ # - 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 AttributesInfo 不具备参考意义。
1130
1147
  # @type FaceAttributesType: String
1131
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1148
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
1149
+ # - 0为不开启,1为开启。
1150
+ # - 默认为0。
1151
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
1152
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1132
1153
  # @type NeedRotateDetection: Integer
1133
1154
  # @param FaceModelVersion: 人脸识别服务所用的算法模型版本。本接口仅支持“3.0”输入
1134
1155
  # @type FaceModelVersion: String
@@ -1195,40 +1216,53 @@ module TencentCloud
1195
1216
 
1196
1217
  # DetectFace请求参数结构体
1197
1218
  class DetectFaceRequest < TencentCloud::Common::AbstractModel
1198
- # @param MaxFaceNum: 最多处理的人脸数目。默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
1199
- # 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
1219
+ # @param MaxFaceNum: 最多处理的人脸数目。
1220
+ # - 默认值为1(仅检测图片中面积最大的那张人脸),最大值为120。
1221
+ # - 此参数用于控制处理待检测图片中的人脸个数,值越小,处理速度越快。
1200
1222
  # @type MaxFaceNum: Integer
1201
1223
  # @param MinFaceSize: 人脸长和宽的最小尺寸,单位为像素,低于MinFaceSize值的人脸不会被检测。
1202
- # 只支持设置34和20,建议使用34。
1224
+ # - 只支持设置34和20,建议使用34。
1203
1225
  # @type MinFaceSize: Integer
1204
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
1205
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1206
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1226
+ # @param Image: 图片 base64 数据。
1227
+ # - base64 编码后大小不可超过5M
1228
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1229
+ # - 所有格式的图片短边像素不小于64。
1230
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1207
1231
  # @type Image: String
1208
- # @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M
1209
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64
1210
- # Url、Image必须提供一个,如果都提供,只使用 Url
1211
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1212
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
1213
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1232
+ # @param Url: 图片的 Url 。
1233
+ # - 对应图片 base64 编码后大小不可超过5M
1234
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
1235
+ # - 所有格式的图片短边像素不小于64。
1236
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
1237
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
1238
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
1239
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1214
1240
  # @type Url: String
1215
- # @param NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。0 为不需要返回,1 为需要返回。默认为 0。
1216
- # 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
1217
- # 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
1218
- # 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
1241
+ # @param NeedFaceAttributes: 是否需要返回人脸属性信息(FaceAttributesInfo)。
1242
+ # - 0 为不需要返回,1 为需要返回。
1243
+ # - 默认为 0。
1244
+ # - 非 1 值均视为不需要返回,此时 FaceAttributesInfo 不具备参考意义。
1245
+ # - 最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
1246
+ # - 提取人脸属性信息较为耗时,如不需要人脸属性信息,建议关闭此项功能,加快人脸检测速度。
1219
1247
  # @type NeedFaceAttributes: Integer
1220
- # @param NeedQualityDetection: 是否开启质量检测。0 为关闭,1 为开启。默认为 0。
1221
- # 1 值均视为不进行质量检测。
1222
- # 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
1223
- # 建议:人脸入库操作建议开启此功能。
1248
+ # @param NeedQualityDetection: 是否开启质量检测。
1249
+ # - 0 为关闭,1 为开启。
1250
+ # - 默认为 0。
1251
+ # - 非 1 值均视为不进行质量检测。
1252
+ # - 最多返回面积最大的 30 张人脸质量分信息,超过 30 张人脸(第 31 张及以后的人脸)的 FaceQualityInfo不具备参考意义。
1253
+ # - 建议:人脸入库操作建议开启此功能。
1224
1254
  # @type NeedQualityDetection: Integer
1225
1255
  # @param FaceModelVersion: 人脸识别服务所用的算法模型版本。
1226
- # 目前入参支持 “2.0”和“3.0“ 两个输入。
1227
- # 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
1228
- # 2020年11月26日后开通服务的账号仅支持输入“3.0”。
1229
- # 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
1256
+ # - 目前入参支持 “2.0”和“3.0“ 两个输入。
1257
+ # - 2020年4月2日开始,默认为“3.0”,之前使用过本接口的账号若未填写本参数默认为“2.0”。
1258
+ # - 2020年11月26日后开通服务的账号仅支持输入“3.0”。
1259
+ # - 不同算法模型版本对应的人脸识别算法不同,新版本的整体效果会优于旧版本,建议使用“3.0”版本。
1230
1260
  # @type FaceModelVersion: String
1231
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1261
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
1262
+ # - 0为不开启,1为开启。
1263
+ # - 默认为0。
1264
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
1265
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
1232
1266
  # @type NeedRotateDetection: Integer
1233
1267
 
1234
1268
  attr_accessor :MaxFaceNum, :MinFaceSize, :Image, :Url, :NeedFaceAttributes, :NeedQualityDetection, :FaceModelVersion, :NeedRotateDetection
@@ -1262,7 +1296,8 @@ module TencentCloud
1262
1296
  # @type ImageWidth: Integer
1263
1297
  # @param ImageHeight: 请求的图片高度。
1264
1298
  # @type ImageHeight: Integer
1265
- # @param FaceInfos: 人脸信息列表。包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
1299
+ # @param FaceInfos: 人脸信息列表。
1300
+ # - 包含人脸坐标信息、属性信息(若需要)、质量分信息(若需要)。
1266
1301
  # @type FaceInfos: Array
1267
1302
  # @param FaceModelVersion: 人脸识别所用的算法模型版本。
1268
1303
  # @type FaceModelVersion: String
@@ -1297,19 +1332,21 @@ module TencentCloud
1297
1332
 
1298
1333
  # DetectLiveFaceAccurate请求参数结构体
1299
1334
  class DetectLiveFaceAccurateRequest < TencentCloud::Common::AbstractModel
1300
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
1301
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
1302
- # 图片的宽高比请接近 3:4,手机拍摄比例最佳。
1303
- # 人脸尺寸大于100X100像素。
1304
- # 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1335
+ # @param Image: 图片 base64 数据。
1336
+ # - base64 编码后大小不可超过5M
1337
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
1338
+ # - 图片的宽高比请接近 3:4,手机拍摄比例最佳。
1339
+ # - 人脸尺寸大于100X100像素。
1340
+ # - 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1305
1341
  # @type Image: String
1306
- # @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M
1307
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
1308
- # Url、Image必须提供一个,如果都提供,只使用 Url
1309
- # 图片的宽高比请接近 3:4,手机拍摄比例最佳。
1310
- # 人脸尺寸大于100X100像素。
1311
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
1312
- # 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1342
+ # @param Url: 图片的 Url 。
1343
+ # - 对应图片 base64 编码后大小不可超过5M
1344
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
1345
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
1346
+ # - 图片的宽高比请接近 3:4,手机拍摄比例最佳。
1347
+ # - 人脸尺寸大于100X100像素。
1348
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。非腾讯云存储的Url速度和稳定性可能受一定影响。
1349
+ # - 图片格式支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
1313
1350
  # @type Url: String
1314
1351
  # @param FaceModelVersion: 人脸识别服务所用的算法模型版本。目前入参支持“3.0“。
1315
1352
  # @type FaceModelVersion: String
@@ -1331,7 +1368,10 @@ module TencentCloud
1331
1368
 
1332
1369
  # DetectLiveFaceAccurate返回参数结构体
1333
1370
  class DetectLiveFaceAccurateResponse < TencentCloud::Common::AbstractModel
1334
- # @param Score: 活体打分,取值范围 [0,100],根据活体分数对应的阈值区间来判断是否为翻拍。目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
1371
+ # @param Score: 活体打分。
1372
+ # - 取值范围 [0,100]。
1373
+ # - 根据活体分数对应的阈值区间来判断是否为翻拍。
1374
+ # - 目前阈值可分为[5,10,40,70,90],其中推荐阈值为40。
1335
1375
  # @type Score: Float
1336
1376
  # @param FaceModelVersion: 人脸识别所用的算法模型版本。
1337
1377
  # @type FaceModelVersion: String
@@ -1426,16 +1466,16 @@ module TencentCloud
1426
1466
  # 眼睛信息
1427
1467
  class Eye < TencentCloud::Common::AbstractModel
1428
1468
  # @param Glass: 识别是否佩戴眼镜。
1429
- # AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
1469
+ # - AttributeItem对应的Type为 —— 0:无眼镜,1:普通眼镜,2:墨镜
1430
1470
  # @type Glass: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1431
1471
  # @param EyeOpen: 识别眼睛的睁开、闭合状态。
1432
- # AttributeItem对应的Type为 —— 0:睁开,1:闭眼
1472
+ # - AttributeItem对应的Type为 —— 0:睁开,1:闭眼
1433
1473
  # @type EyeOpen: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1434
1474
  # @param EyelidType: 识别是否双眼皮。
1435
- # AttributeItem对应的Type为 —— 0:无,1:有。
1475
+ # - AttributeItem对应的Type为 —— 0:无,1:有。
1436
1476
  # @type EyelidType: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1437
1477
  # @param EyeSize: 眼睛大小。
1438
- # AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
1478
+ # - AttributeItem对应的Type为 —— 0:小眼睛,1:普通眼睛,2:大眼睛。
1439
1479
  # @type EyeSize: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1440
1480
 
1441
1481
  attr_accessor :Glass, :EyeOpen, :EyelidType, :EyeSize
@@ -1470,13 +1510,13 @@ module TencentCloud
1470
1510
  # 眉毛信息
1471
1511
  class Eyebrow < TencentCloud::Common::AbstractModel
1472
1512
  # @param EyebrowDensity: 眉毛浓密。
1473
- # AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
1513
+ # - AttributeItem对应的Type为 —— 0:淡眉,1:浓眉。
1474
1514
  # @type EyebrowDensity: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1475
1515
  # @param EyebrowCurve: 眉毛弯曲。
1476
- # AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
1516
+ # - AttributeItem对应的Type为 —— 0:不弯,1:弯眉。
1477
1517
  # @type EyebrowCurve: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1478
1518
  # @param EyebrowLength: 眉毛长短。
1479
- # AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
1519
+ # - AttributeItem对应的Type为 —— 0:短眉毛,1:长眉毛。
1480
1520
  # @type EyebrowLength: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1481
1521
 
1482
1522
  attr_accessor :EyebrowDensity, :EyebrowCurve, :EyebrowLength
@@ -1506,35 +1546,59 @@ module TencentCloud
1506
1546
  # 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
1507
1547
  # 魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息,最多返回面积最大的 5 张人脸属性信息,超过 5 张人脸(第 6 张及以后的人脸)的 FaceAttributesInfo 不具备参考意义。
1508
1548
  class FaceAttributesInfo < TencentCloud::Common::AbstractModel
1509
- # @param Gender: 性别[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1549
+ # @param Gender: 性别。
1550
+ # - 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
1551
+ # - NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1510
1552
  # @type Gender: Integer
1511
- # @param Age: 年龄 [0~100]NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1553
+ # @param Age: 年龄 。
1554
+ # - 取值范围:[0~100]。
1555
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1512
1556
  # @type Age: Integer
1513
- # @param Expression: 微笑[0(normal,正常)~100(laugh,大笑)]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1557
+ # @param Expression: 微笑。
1558
+ # - 取值说明:[0(normal,正常)~100(laugh,大笑)]。
1559
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1514
1560
  # @type Expression: Integer
1515
- # @param Glass: 是否有眼镜 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1561
+ # @param Glass: 是否有眼镜。
1562
+ # - 取值范围: [true,false]。
1563
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1516
1564
  # @type Glass: Boolean
1517
- # @param Pitch: 上下偏移[-30,30],单位角度。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1518
- # 建议:人脸入库选择[-10,10]的图片。
1565
+ # @param Pitch: 上下偏移。
1566
+ # - 取值范围:[-30,30],单位角度。
1567
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1568
+ # - 建议:人脸入库选择[-10,10]的图片。
1519
1569
  # @type Pitch: Integer
1520
- # @param Yaw: 左右偏移[-30,30],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1521
- # 建议:人脸入库选择[-10,10]的图片。
1570
+ # @param Yaw: 左右偏移。
1571
+ # - 取值范围:[-30,30],单位角度。
1572
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1573
+ # - 建议:人脸入库选择[-10,10]的图片。
1522
1574
  # @type Yaw: Integer
1523
- # @param Roll: 平面旋转[-180,180],单位角度。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1524
- # 建议:人脸入库选择[-20,20]的图片。
1575
+ # @param Roll: 平面旋转。
1576
+ # - 取值范围:[-180,180],单位角度。
1577
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1578
+ # - 建议:人脸入库选择[-20,20]的图片。
1525
1579
  # @type Roll: Integer
1526
- # @param Beauty: 魅力[0~100]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1580
+ # @param Beauty: 魅力。
1581
+ # - 取值范围:[0~100]。
1582
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1527
1583
  # @type Beauty: Integer
1528
- # @param Hat: 是否有帽子 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1584
+ # @param Hat: 是否有帽子。
1585
+ # - 取值范围: [true,false]。
1586
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1529
1587
  # 注意:此字段可能返回 null,表示取不到有效值。
1530
1588
  # @type Hat: Boolean
1531
- # @param Mask: 是否有口罩 [true,false]。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1589
+ # @param Mask: 是否有口罩。
1590
+ # - 取值范围: [true,false]。
1591
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1532
1592
  # 注意:此字段可能返回 null,表示取不到有效值。
1533
1593
  # @type Mask: Boolean
1534
- # @param Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1594
+ # @param Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
1595
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1535
1596
  # 注意:此字段可能返回 null,表示取不到有效值。
1536
1597
  # @type Hair: :class:`Tencentcloud::Iai.v20200303.models.FaceHairAttributesInfo`
1537
- # @param EyeOpen: 双眼是否睁开 [true,false]。只要有超过一只眼睛闭眼,就返回false。 NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1598
+ # @param EyeOpen: 双眼是否睁开。
1599
+ # - 取值范围: [true,false]。
1600
+ # - 只要有超过一只眼睛闭眼,就返回false。
1601
+ # - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1538
1602
  # 注意:此字段可能返回 null,表示取不到有效值。
1539
1603
  # @type EyeOpen: Boolean
1540
1604
 
@@ -1580,60 +1644,63 @@ module TencentCloud
1580
1644
  # 鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
1581
1645
  # 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
1582
1646
  class FaceDetailAttributesInfo < TencentCloud::Common::AbstractModel
1583
- # @param Age: 年龄 [0,65],其中65代表“65岁及以上”。
1584
- # FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1647
+ # @param Age: 年龄。
1648
+ # - 取值范围: [0,65],其中65代表“65岁及以上”。
1649
+ # - FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1585
1650
  # @type Age: Integer
1586
- # @param Beauty: 美丑打分[0,100]。
1587
- # FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1651
+ # @param Beauty: 美丑打分。
1652
+ # - 取值范围:[0,100]。
1653
+ # - FaceAttributesType 不含 Beauty 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1588
1654
  # @type Beauty: Integer
1589
1655
  # @param Emotion: 情绪,可识别自然、高兴、惊讶、生气、悲伤、厌恶、害怕。
1590
- # AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕
1591
- # FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1656
+ # - AttributeItem对应的Type为 —— 0:自然,1:高兴,2:惊讶,3:生气,4:悲伤,5:厌恶,6:害怕。
1657
+ # - FaceAttributesType 不含Emotion 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1592
1658
  # @type Emotion: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1593
1659
  # @param Eye: 眼睛相关信息,可识别是否戴眼镜、是否闭眼、是否双眼皮和眼睛大小。
1594
- # FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1660
+ # - FaceAttributesType 不含Eye 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1595
1661
  # @type Eye: :class:`Tencentcloud::Iai.v20200303.models.Eye`
1596
1662
  # @param Eyebrow: 眉毛相关信息,可识别眉毛浓密、弯曲、长短信息。
1597
1663
  # FaceAttributesType 不含Eyebrow 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1598
1664
  # @type Eyebrow: :class:`Tencentcloud::Iai.v20200303.models.Eyebrow`
1599
1665
  # @param Gender: 性别信息。
1600
- # AttributeItem对应的Type为 —— 0:男性,1:女性。
1601
- # FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1666
+ # - AttributeItem对应的Type为 —— 0:男性,1:女性。
1667
+ # - FaceAttributesType 不含Gender 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1602
1668
  # @type Gender: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1603
1669
  # @param Hair: 头发信息,包含头发长度、有无刘海、头发颜色。
1604
- # FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1670
+ # - FaceAttributesType 不含Hair 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1605
1671
  # @type Hair: :class:`Tencentcloud::Iai.v20200303.models.Hair`
1606
1672
  # @param Hat: 帽子信息,可识别是否佩戴帽子、帽子款式、帽子颜色。
1607
- # FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1673
+ # - FaceAttributesType 不含Hat 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1608
1674
  # @type Hat: :class:`Tencentcloud::Iai.v20200303.models.Hat`
1609
1675
  # @param HeadPose: 姿态信息,包含人脸的上下偏移、左右偏移、平面旋转信息。
1610
- # FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1676
+ # - FaceAttributesType 不含Headpose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1611
1677
  # @type HeadPose: :class:`Tencentcloud::Iai.v20200303.models.HeadPose`
1612
1678
  # @param Mask: 口罩佩戴信息。
1613
- # AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
1614
- # FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1679
+ # - AttributeItem对应的Type为 —— 0: 无口罩, 1: 有口罩不遮脸,2: 有口罩遮下巴,3: 有口罩遮嘴,4: 正确佩戴口罩。
1680
+ # - FaceAttributesType 不含Mask 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1615
1681
  # @type Mask: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1616
1682
  # @param Mouth: 嘴巴信息,可识别是否张嘴、嘴唇厚度。
1617
- # FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1683
+ # - FaceAttributesType 不含 Mouth 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1618
1684
  # @type Mouth: :class:`Tencentcloud::Iai.v20200303.models.Mouth`
1619
1685
  # @param Moustache: 胡子信息。
1620
- # AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
1621
- # FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1686
+ # - AttributeItem对应的Type为 —— 0:无胡子,1:有胡子。
1687
+ # - FaceAttributesType 不含 Moustache 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1622
1688
  # @type Moustache: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1623
1689
  # @param Nose: 鼻子信息。
1624
- # AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
1625
- # FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1690
+ # - AttributeItem对应的Type为 —— 0:朝天鼻,1:鹰钩鼻,2:普通,3:圆鼻头
1691
+ # - FaceAttributesType 不含 Nose 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1626
1692
  # @type Nose: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1627
1693
  # @param Shape: 脸型信息。
1628
- # AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
1629
- # FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1694
+ # - AttributeItem对应的Type为 —— 0:方脸,1:三角脸,2:鹅蛋脸,3:心形脸,4:圆脸。
1695
+ # - FaceAttributesType 不含 Shape 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1630
1696
  # @type Shape: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1631
1697
  # @param Skin: 肤色信息。
1632
- # AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
1633
- # FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1698
+ # - AttributeItem对应的Type为 —— 0:黄色皮肤,1:棕色皮肤,2:黑色皮肤,3:白色皮肤。
1699
+ # - FaceAttributesType 不含 Skin 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1634
1700
  # @type Skin: :class:`Tencentcloud::Iai.v20200303.models.AttributeItem`
1635
- # @param Smile: 微笑程度,[0,100]。
1636
- # FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1701
+ # @param Smile: 微笑程度
1702
+ # - 取值范围:[0,100]。
1703
+ # - FaceAttributesType 不含 Smile 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
1637
1704
  # @type Smile: Integer
1638
1705
 
1639
1706
  attr_accessor :Age, :Beauty, :Emotion, :Eye, :Eyebrow, :Gender, :Hair, :Hat, :HeadPose, :Mask, :Mouth, :Moustache, :Nose, :Shape, :Skin, :Smile
@@ -1720,11 +1787,9 @@ module TencentCloud
1720
1787
  class FaceDetailInfo < TencentCloud::Common::AbstractModel
1721
1788
  # @param FaceRect: 检测出的人脸框位置。
1722
1789
  # @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
1723
- # @param FaceDetailAttributesInfo: 人脸属性信息,根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)
1724
- # 情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)
1725
- # 头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache)
1726
- # 鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
1727
- # 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
1790
+ # @param FaceDetailAttributesInfo: 人脸属性信息。
1791
+ # - 根据 FaceAttributesType 输入的类型,返回年龄(Age)、颜值(Beauty)、情绪(Emotion)、眼睛信息(Eye)、眉毛(Eyebrow)、性别(Gender)、头发(Hair)、帽子(Hat)、姿态(Headpose)、口罩(Mask)、嘴巴(Mouth)、胡子(Moustache 、鼻子(Nose)、脸型(Shape)、肤色(Skin)、微笑(Smile)等人脸属性信息。
1792
+ # - 若 FaceAttributesType 没有输入相关类型,则FaceDetaiAttributesInfo返回的细项不具备参考意义。
1728
1793
  # @type FaceDetailAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceDetailAttributesInfo`
1729
1794
 
1730
1795
  attr_accessor :FaceRect, :FaceDetailAttributesInfo
@@ -1748,13 +1813,13 @@ module TencentCloud
1748
1813
 
1749
1814
  # 人脸属性中的发型信息。
1750
1815
  class FaceHairAttributesInfo < TencentCloud::Common::AbstractModel
1751
- # @param Length: 0:光头,1:短发,2:中发,3:长发,4:绑发
1816
+ # @param Length: 取值范围:0:光头,1:短发,2:中发,3:长发,4:绑发。
1752
1817
  # 注意:此字段可能返回 null,表示取不到有效值。
1753
1818
  # @type Length: Integer
1754
- # @param Bang: 0:有刘海,1:无刘海
1819
+ # @param Bang: 取值范围:0:有刘海,1:无刘海。
1755
1820
  # 注意:此字段可能返回 null,表示取不到有效值。
1756
1821
  # @type Bang: Integer
1757
- # @param Color: 0:黑色,1:金色,2:棕色,3:灰白色
1822
+ # @param Color: 取值范围:0:黑色,1:金色,2:棕色,3:灰白色。
1758
1823
  # 注意:此字段可能返回 null,表示取不到有效值。
1759
1824
  # @type Color: Integer
1760
1825
 
@@ -1776,21 +1841,24 @@ module TencentCloud
1776
1841
  # 人脸信息列表。
1777
1842
  class FaceInfo < TencentCloud::Common::AbstractModel
1778
1843
  # @param X: 人脸框左上角横坐标。
1779
- # 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1780
- # 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
1844
+ # - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1845
+ # - 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
1781
1846
  # @type X: Integer
1782
1847
  # @param Y: 人脸框左上角纵坐标。
1783
- # 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1784
- # 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
1848
+ # - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1849
+ # - 若需截取完整人脸,可以在完整分completeness满足需求的情况下,将负值坐标取0。
1785
1850
  # @type Y: Integer
1786
1851
  # @param Width: 人脸框宽度。
1787
1852
  # @type Width: Integer
1788
1853
  # @param Height: 人脸框高度。
1789
1854
  # @type Height: Integer
1790
- # @param FaceAttributesInfo: 人脸属性信息,包含性别( gender )、年龄( age )、表情( expression )、
1791
- # 魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )。只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
1855
+ # @param FaceAttributesInfo: 人脸属性信息。
1856
+ # - 包含性别( gender )、年龄( age )、表情( expression )、魅力( beauty )、眼镜( glass )、口罩(mask)、头发(hair)和姿态 (pitch,roll,yaw )
1857
+ # - 只有当 NeedFaceAttributes 设为 1 时才返回有效信息。
1792
1858
  # @type FaceAttributesInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceAttributesInfo`
1793
- # @param FaceQualityInfo: 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
1859
+ # @param FaceQualityInfo: 人脸质量信息。
1860
+ # - 包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。
1861
+ # - 只有当NeedFaceDetection设为1时才返回有效信息。
1794
1862
  # 注意:此字段可能返回 null,表示取不到有效值。
1795
1863
  # @type FaceQualityInfo: :class:`Tencentcloud::Iai.v20200303.models.FaceQualityInfo`
1796
1864
 
@@ -1823,28 +1891,34 @@ module TencentCloud
1823
1891
 
1824
1892
  # 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
1825
1893
  class FaceQualityCompleteness < TencentCloud::Common::AbstractModel
1826
- # @param Eyebrow: 眉毛的遮挡分数[0,100],分数越高遮挡越少。
1827
- # 参考范围:[0,80]表示发生遮挡。
1894
+ # @param Eyebrow: 眉毛的遮挡分数。
1895
+ # - 取值范围:[0,100],分数越高遮挡越少。
1896
+ # - 参考范围:[0,80]表示发生遮挡。
1828
1897
  # 注意:此字段可能返回 null,表示取不到有效值。
1829
1898
  # @type Eyebrow: Integer
1830
- # @param Eye: 眼睛的遮挡分数[0,100],分数越高遮挡越少。
1831
- # 参考范围:[0,80]表示发生遮挡。
1899
+ # @param Eye: 眼睛的遮挡分数。
1900
+ # - 取值范围:[0,100],分数越高遮挡越少。
1901
+ # - 参考范围:[0,80]表示发生遮挡。
1832
1902
  # 注意:此字段可能返回 null,表示取不到有效值。
1833
1903
  # @type Eye: Integer
1834
- # @param Nose: 鼻子的遮挡分数[0,100],分数越高遮挡越少。
1835
- # 参考范围:[0,60]表示发生遮挡。
1904
+ # @param Nose: 鼻子的遮挡分数。
1905
+ # - 取值范围:[0,100],分数越高遮挡越少。
1906
+ # - 参考范围:[0,60]表示发生遮挡。
1836
1907
  # 注意:此字段可能返回 null,表示取不到有效值。
1837
1908
  # @type Nose: Integer
1838
- # @param Cheek: 脸颊的遮挡分数[0,100],分数越高遮挡越少。
1839
- # 参考范围:[0,70]表示发生遮挡。
1909
+ # @param Cheek: 脸颊的遮挡分数。
1910
+ # - 取值范围:[0,100],分数越高遮挡越少。
1911
+ # - 参考范围:[0,70]表示发生遮挡。
1840
1912
  # 注意:此字段可能返回 null,表示取不到有效值。
1841
1913
  # @type Cheek: Integer
1842
- # @param Mouth: 嘴巴的遮挡分数[0,100],分数越高遮挡越少。
1843
- # 参考范围:[0,50]表示发生遮挡。
1914
+ # @param Mouth: 嘴巴的遮挡分数。
1915
+ # - 取值范围:[0,100],分数越高遮挡越少。
1916
+ # - 参考范围:[0,50]表示发生遮挡。
1844
1917
  # 注意:此字段可能返回 null,表示取不到有效值。
1845
1918
  # @type Mouth: Integer
1846
- # @param Chin: 下巴的遮挡分数[0,100],分数越高遮挡越少。
1847
- # 参考范围:[0,70]表示发生遮挡。
1919
+ # @param Chin: 下巴的遮挡分数。
1920
+ # - 取值范围:[0,100],分数越高遮挡越少。
1921
+ # - 参考范围:[0,70]表示发生遮挡。
1848
1922
  # 注意:此字段可能返回 null,表示取不到有效值。
1849
1923
  # @type Chin: Integer
1850
1924
 
@@ -1871,20 +1945,23 @@ module TencentCloud
1871
1945
 
1872
1946
  # 人脸质量信息,包含质量分(score)、模糊分(sharpness)、光照分(brightness)、遮挡分(completeness)。只有当NeedFaceDetection设为1时才返回有效信息。
1873
1947
  class FaceQualityInfo < TencentCloud::Common::AbstractModel
1874
- # @param Score: 质量分: [0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
1875
- # 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
1876
- # 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
1877
- # 建议:人脸入库选取70以上的图片。
1948
+ # @param Score: 质量分。
1949
+ # - 取值范围:[0,100],综合评价图像质量是否适合人脸识别,分数越高质量越好。
1950
+ # - 正常情况,只需要使用Score作为质量分总体的判断标准即可。Sharpness、Brightness、Completeness等细项分仅供参考。
1951
+ # - 参考范围:[0,40]较差,[40,60] 一般,[60,80]较好,[80,100]很好。
1952
+ # - 建议:人脸入库选取70以上的图片。
1878
1953
  # 注意:此字段可能返回 null,表示取不到有效值。
1879
1954
  # @type Score: Integer
1880
- # @param Sharpness: 清晰分:[0,100],评价图片清晰程度,分数越高越清晰。
1881
- # 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
1882
- # 建议:人脸入库选取80以上的图片。
1955
+ # @param Sharpness: 清晰分。
1956
+ # - 取值范围:[0,100],评价图片清晰程度,分数越高越清晰。
1957
+ # - 参考范围:[0,40]特别模糊,[40,60]模糊,[60,80]一般,[80,100]清晰。
1958
+ # - 建议:人脸入库选取80以上的图片。
1883
1959
  # 注意:此字段可能返回 null,表示取不到有效值。
1884
1960
  # @type Sharpness: Integer
1885
- # @param Brightness: 光照分:[0,100],评价图片光照程度,分数越高越亮。
1886
- # 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
1887
- # 建议:人脸入库选取[30,70]的图片。
1961
+ # @param Brightness: 光照分。
1962
+ # - 取值范围:[0,100],评价图片光照程度,分数越高越亮。
1963
+ # - 参考范围: [0,30]偏暗,[30,70]光照正常,[70,100]偏亮。
1964
+ # - 建议:人脸入库选取[30,70]的图片。
1888
1965
  # 注意:此字段可能返回 null,表示取不到有效值。
1889
1966
  # @type Brightness: Integer
1890
1967
  # @param Completeness: 五官遮挡分,评价眉毛(Eyebrow)、眼睛(Eye)、鼻子(Nose)、脸颊(Cheek)、嘴巴(Mouth)、下巴(Chin)的被遮挡程度。
@@ -1914,16 +1991,16 @@ module TencentCloud
1914
1991
  # 检测出的人脸框的位置
1915
1992
  class FaceRect < TencentCloud::Common::AbstractModel
1916
1993
  # @param X: 人脸框左上角横坐标。
1917
- # 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1918
- # 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
1994
+ # - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1995
+ # - 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
1919
1996
  # @type X: Integer
1920
1997
  # @param Y: 人脸框左上角纵坐标。
1921
- # 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1922
- # 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
1998
+ # - 人脸框包含人脸五官位置并在此基础上进行一定的扩展,若人脸框超出图片范围,会导致坐标负值。
1999
+ # - 若需截取完整人脸,可以在完整分completess满足需求的情况下,将负值坐标取0。
1923
2000
  # @type Y: Integer
1924
- # @param Width: 人脸宽度
2001
+ # @param Width: 人脸宽度。
1925
2002
  # @type Width: Integer
1926
- # @param Height: 人脸高度
2003
+ # @param Height: 人脸高度。
1927
2004
  # @type Height: Integer
1928
2005
 
1929
2006
  attr_accessor :X, :Y, :Width, :Height
@@ -2522,9 +2599,9 @@ module TencentCloud
2522
2599
 
2523
2600
  # 需要修改的人员库自定义描述字段key-value
2524
2601
  class GroupExDescriptionInfo < TencentCloud::Common::AbstractModel
2525
- # @param GroupExDescriptionIndex: 人员库自定义描述字段Index,从0开始
2602
+ # @param GroupExDescriptionIndex: 人员库自定义描述字段Index,从0开始。
2526
2603
  # @type GroupExDescriptionIndex: Integer
2527
- # @param GroupExDescription: 需要更新的人员库自定义描述字段内容
2604
+ # @param GroupExDescription: 需要更新的人员库自定义描述字段内容。
2528
2605
  # @type GroupExDescription: String
2529
2606
 
2530
2607
  attr_accessor :GroupExDescriptionIndex, :GroupExDescription
@@ -2542,21 +2619,23 @@ module TencentCloud
2542
2619
 
2543
2620
  # 返回的人员库信息
2544
2621
  class GroupInfo < TencentCloud::Common::AbstractModel
2545
- # @param GroupName: 人员库名称
2622
+ # @param GroupName: 人员库名称。
2546
2623
  # @type GroupName: String
2547
- # @param GroupId: 人员库ID
2624
+ # @param GroupId: 人员库ID
2548
2625
  # @type GroupId: String
2549
- # @param GroupExDescriptions: 人员库自定义描述字段
2626
+ # @param GroupExDescriptions: 人员库自定义描述字段。
2550
2627
  # 注意:此字段可能返回 null,表示取不到有效值。
2551
2628
  # @type GroupExDescriptions: Array
2552
- # @param Tag: 人员库信息备注
2629
+ # @param Tag: 人员库信息备注。
2553
2630
  # 注意:此字段可能返回 null,表示取不到有效值。
2554
2631
  # @type Tag: String
2555
2632
  # @param FaceModelVersion: 人脸识别所用的算法模型版本。
2556
2633
  # 注意:此字段可能返回 null,表示取不到有效值。
2557
2634
  # @type FaceModelVersion: String
2558
- # @param CreationTimestamp: Group的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2559
- # Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
2635
+ # @param CreationTimestamp: Group的创建时间和日期 CreationTimestamp。
2636
+ # - CreationTimestamp 的值是自 Unix 纪元时间到Group创建时间的毫秒数。
2637
+ # - Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
2638
+ # - 有关更多信息,请参阅 Unix 时间。
2560
2639
  # 注意:此字段可能返回 null,表示取不到有效值。
2561
2640
  # @type CreationTimestamp: Integer
2562
2641
 
@@ -2829,9 +2908,9 @@ module TencentCloud
2829
2908
 
2830
2909
  # 需要修改的人员描述字段内容,key-value
2831
2910
  class PersonExDescriptionInfo < TencentCloud::Common::AbstractModel
2832
- # @param PersonExDescriptionIndex: 人员描述字段Index,从0开始
2911
+ # @param PersonExDescriptionIndex: 人员描述字段Index,从0开始。
2833
2912
  # @type PersonExDescriptionIndex: Integer
2834
- # @param PersonExDescription: 需要更新的人员描述字段内容
2913
+ # @param PersonExDescription: 需要更新的人员描述字段内容。
2835
2914
  # @type PersonExDescription: String
2836
2915
 
2837
2916
  attr_accessor :PersonExDescriptionIndex, :PersonExDescription
@@ -2849,9 +2928,9 @@ module TencentCloud
2849
2928
 
2850
2929
  # 包含此人员的人员库及描述字段内容列表
2851
2930
  class PersonGroupInfo < TencentCloud::Common::AbstractModel
2852
- # @param GroupId: 包含此人员的人员库ID
2931
+ # @param GroupId: 包含此人员的人员库ID
2853
2932
  # @type GroupId: String
2854
- # @param PersonExDescriptions: 人员描述字段内容
2933
+ # @param PersonExDescriptions: 人员描述字段内容。
2855
2934
  # @type PersonExDescriptions: Array
2856
2935
 
2857
2936
  attr_accessor :GroupId, :PersonExDescriptions
@@ -2869,18 +2948,20 @@ module TencentCloud
2869
2948
 
2870
2949
  # 返回的人员信息
2871
2950
  class PersonInfo < TencentCloud::Common::AbstractModel
2872
- # @param PersonName: 人员名称
2951
+ # @param PersonName: 人员名称。
2873
2952
  # @type PersonName: String
2874
- # @param PersonId: 人员Id
2953
+ # @param PersonId: 人员Id
2875
2954
  # @type PersonId: String
2876
- # @param Gender: 人员性别
2955
+ # @param Gender: 人员性别。
2877
2956
  # @type Gender: Integer
2878
- # @param PersonExDescriptions: 人员描述字段内容
2957
+ # @param PersonExDescriptions: 人员描述字段内容。
2879
2958
  # @type PersonExDescriptions: Array
2880
- # @param FaceIds: 包含的人脸照片列表
2959
+ # @param FaceIds: 包含的人脸照片列表。
2881
2960
  # @type FaceIds: Array
2882
- # @param CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
2883
- # Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。有关更多信息,请参阅 Unix 时间。
2961
+ # @param CreationTimestamp: 人员的创建时间和日期 CreationTimestamp。
2962
+ # - CreationTimestamp 的值是自 Unix 纪元时间到Person创建时间的毫秒数。
2963
+ # - Unix 纪元时间是 1970 年 1 月 1 日星期四,协调世界时 (UTC) 00:00:00。
2964
+ # - 有关更多信息,请参阅 Unix 时间。
2884
2965
  # @type CreationTimestamp: Integer
2885
2966
 
2886
2967
  attr_accessor :PersonName, :PersonId, :Gender, :PersonExDescriptions, :FaceIds, :CreationTimestamp
@@ -2906,9 +2987,9 @@ module TencentCloud
2906
2987
 
2907
2988
  # 坐标
2908
2989
  class Point < TencentCloud::Common::AbstractModel
2909
- # @param X: x坐标
2990
+ # @param X: x坐标。
2910
2991
  # @type X: Integer
2911
- # @param Y: Y坐标
2992
+ # @param Y: Y坐标。
2912
2993
  # @type Y: Integer
2913
2994
 
2914
2995
  attr_accessor :X, :Y
@@ -2926,12 +3007,13 @@ module TencentCloud
2926
3007
 
2927
3008
  # 人脸的识别结果
2928
3009
  class Result < TencentCloud::Common::AbstractModel
2929
- # @param Candidates: 识别出的最相似候选人
3010
+ # @param Candidates: 识别出的最相似候选人。
2930
3011
  # @type Candidates: Array
2931
- # @param FaceRect: 检测出的人脸框位置
3012
+ # @param FaceRect: 检测出的人脸框位置。
2932
3013
  # @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
2933
- # @param RetCode: 检测出的人脸图片状态返回码。0 表示正常。
2934
- # -1601代表不符合图片质量控制要求,此时Candidate内容为空。
3014
+ # @param RetCode: 检测出的人脸图片状态返回码。
3015
+ # - 0 表示正常。
3016
+ # - -1601代表不符合图片质量控制要求,此时Candidate内容为空。
2935
3017
  # @type RetCode: Integer
2936
3018
 
2937
3019
  attr_accessor :Candidates, :FaceRect, :RetCode
@@ -2965,8 +3047,9 @@ module TencentCloud
2965
3047
  # @type FaceRect: :class:`Tencentcloud::Iai.v20200303.models.FaceRect`
2966
3048
  # @param GroupCandidates: 识别结果。
2967
3049
  # @type GroupCandidates: Array
2968
- # @param RetCode: 检测出的人脸图片状态返回码。0 表示正常。
2969
- # -1601代表不符合图片质量控制要求,此时Candidate内容为空。
3050
+ # @param RetCode: 检测出的人脸图片状态返回码。
3051
+ # - 0 表示正常。
3052
+ # - -1601代表不符合图片质量控制要求,此时Candidate内容为空。
2970
3053
  # @type RetCode: Integer
2971
3054
 
2972
3055
  attr_accessor :FaceRect, :GroupCandidates, :RetCode
@@ -3533,29 +3616,38 @@ module TencentCloud
3533
3616
  class VerifyFaceRequest < TencentCloud::Common::AbstractModel
3534
3617
  # @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
3535
3618
  # @type PersonId: String
3536
- # @param Image: 图片 base64 数据,base64 编码后大小不可超过5M。
3537
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
3538
- # 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3539
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3619
+ # @param Image: 图片 base64 数据。
3620
+ # - base64 编码后大小不可超过5M
3621
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
3622
+ # - 所有格式的图片短边像素不小于64。
3623
+ # - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3624
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3540
3625
  # @type Image: String
3541
- # @param Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M
3542
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
3543
- # Url、Image必须提供一个,如果都提供,只使用 Url
3544
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
3545
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
3546
- # 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3547
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3626
+ # @param Url: 图片的 Url 。
3627
+ # - 对应图片 base64 编码后大小不可超过5M
3628
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
3629
+ # - 所有格式的图片短边像素不小于64。
3630
+ # - Url、Image必须提供一个,如果都提供,只使用 Url。
3631
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
3632
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
3633
+ # - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3634
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3548
3635
  # @type Url: String
3549
3636
  # @param QualityControl: 图片质量控制。
3550
- # 0: 不进行控制;
3551
- # 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
3552
- # 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
3553
- # 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
3554
- # 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
3555
- # 默认 0。
3556
- # 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
3637
+ # - 取值范围:
3638
+ # 0: 不进行控制。
3639
+ # 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
3640
+ # 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
3641
+ # 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
3642
+ # 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
3643
+ # - 默认 0。
3644
+ # - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
3557
3645
  # @type QualityControl: Integer
3558
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
3646
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
3647
+ # - 取值范围:0为不开启,1为开启。
3648
+ # - 默认为0。
3649
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
3650
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
3559
3651
  # @type NeedRotateDetection: Integer
3560
3652
 
3561
3653
  attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
@@ -3579,15 +3671,16 @@ module TencentCloud
3579
3671
 
3580
3672
  # VerifyFace返回参数结构体
3581
3673
  class VerifyFaceResponse < TencentCloud::Common::AbstractModel
3582
- # @param Score: 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
3583
-
3584
- # 不同算法版本返回的相似度分数不同。
3585
- # 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
3586
- # 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
3674
+ # @param Score: 给定的人脸图片与 PersonId 对应人脸的相似度。
3675
+ # - 若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
3676
+ # - 不同算法版本返回的相似度分数不同。
3677
+ # - 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
3678
+ # - 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
3587
3679
  # @type Score: Float
3588
- # @param IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
3680
+ # @param IsMatch: 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断。
3589
3681
  # @type IsMatch: Boolean
3590
- # @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
3682
+ # @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
3683
+ # - 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
3591
3684
  # @type FaceModelVersion: String
3592
3685
  # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
3593
3686
  # @type RequestId: String
@@ -3614,28 +3707,35 @@ module TencentCloud
3614
3707
  # @param PersonId: 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
3615
3708
  # @type PersonId: String
3616
3709
  # @param Image: 图片 base64 数据。
3617
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
3618
- # 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3619
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3710
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
3711
+ # - 所有格式的图片短边像素不小于64。
3712
+ # - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3713
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3620
3714
  # @type Image: String
3621
3715
  # @param Url: 图片的 Url
3622
- # jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
3623
- # 图片的 Url、Image必须提供一个,如果都提供,只使用 Url
3624
- # 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
3625
- # 非腾讯云存储的Url速度和稳定性可能受一定影响。
3626
- # 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3627
- # 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3716
+ # - jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000
3717
+ # - 所有格式的图片短边像素不小于64
3718
+ # - 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
3719
+ # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
3720
+ # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
3721
+ # - 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
3722
+ # - 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
3628
3723
  # @type Url: String
3629
3724
  # @param QualityControl: 图片质量控制。
3630
- # 0: 不进行控制;
3631
- # 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
3632
- # 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
3633
- # 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
3634
- # 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
3635
- # 默认 0。
3636
- # 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
3725
+ # - 取值范围:
3726
+ # 0: 不进行控制。
3727
+ # 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
3728
+ # 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
3729
+ # 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
3730
+ # 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
3731
+ # - 默认 0。
3732
+ # - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
3637
3733
  # @type QualityControl: Integer
3638
- # @param NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
3734
+ # @param NeedRotateDetection: 是否开启图片旋转识别支持。
3735
+ # - 取值范围:0为不开启,1为开启。
3736
+ # - 默认为0。
3737
+ # - 本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
3738
+ # - 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
3639
3739
  # @type NeedRotateDetection: Integer
3640
3740
 
3641
3741
  attr_accessor :PersonId, :Image, :Url, :QualityControl, :NeedRotateDetection
@@ -3663,7 +3763,8 @@ module TencentCloud
3663
3763
  # @type Score: Float
3664
3764
  # @param IsMatch: 是否为同一人的判断。
3665
3765
  # @type IsMatch: Boolean
3666
- # @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
3766
+ # @param FaceModelVersion: 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。
3767
+ # - 在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
3667
3768
  # @type FaceModelVersion: String
3668
3769
  # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
3669
3770
  # @type RequestId: String
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-iai
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.939
4
+ version: 3.0.941
5
5
  platform: ruby
6
6
  authors:
7
7
  - Tencent Cloud
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-11-08 00:00:00.000000000 Z
11
+ date: 2024-11-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common