tencentcloud-sdk-iai 3.0.939 → 3.0.941

Sign up to get free protection for your applications and to get access to all the features.
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