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 +4 -4
- data/lib/VERSION +1 -1
- data/lib/v20180301/models.rb +2 -2
- data/lib/v20200303/models.rb +364 -263
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: ede02ebcdbb5b8e85386c72ff3bc8057805f5403
|
4
|
+
data.tar.gz: 18ca7507c6021fa9cd04810eb144444b0dae7a1f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: d800cdaf1baeb97a5bfc5ade9ca4165e53ac2b52a2bc053edd11094870a30e821796bc90adf39cfb97d985b5515cf54a6aa361c9c8bc492a2d6f8fbcd11422b4
|
7
|
+
data.tar.gz: ce622d32bdaa744a4f51bb4aa03817ef5e6d186fd7d2796536a8a76ab669a62e2a94e7ff9fe2168062c111114ceebe2973be05a150eb1ddf53bf4f8f5a967707
|
data/lib/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
3.0.
|
1
|
+
3.0.941
|
data/lib/v20180301/models.rb
CHANGED
@@ -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
|
data/lib/v20200303/models.rb
CHANGED
@@ -19,24 +19,31 @@ module TencentCloud
|
|
19
19
|
module V20200303
|
20
20
|
# AnalyzeDenseLandmarks请求参数结构体
|
21
21
|
class AnalyzeDenseLandmarksRequest < TencentCloud::Common::AbstractModel
|
22
|
-
# @param Mode: 检测模式。
|
23
|
-
#
|
24
|
-
#
|
22
|
+
# @param Mode: 检测模式。
|
23
|
+
# - 取值范围:0 为检测所有出现的人脸, 1 为检测面积最大的人脸。
|
24
|
+
# - 默认为 0。
|
25
|
+
# - 最多返回 5 张人脸的五官定位(人脸关键点)具体信息。
|
25
26
|
# @type Mode: Integer
|
26
|
-
# @param Image: 图片 base64
|
27
|
-
#
|
28
|
-
#
|
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
|
31
|
-
#
|
32
|
-
#
|
33
|
-
#
|
34
|
-
#
|
35
|
-
#
|
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: 是否开启图片旋转识别支持。
|
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: 检测模式。
|
109
|
+
# @param Mode: 检测模式。
|
110
|
+
# - 取值范围:
|
111
|
+
# 0 为检测所有出现的人脸。
|
112
|
+
# 1 为检测面积最大的人脸。
|
113
|
+
# - 默认为 0。
|
114
|
+
# - 最多返回 10 张人脸的五官定位(人脸关键点)具体信息。
|
103
115
|
# @type Mode: Integer
|
104
|
-
# @param Image: 图片 base64
|
105
|
-
#
|
106
|
-
#
|
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
|
109
|
-
#
|
110
|
-
#
|
111
|
-
#
|
112
|
-
#
|
113
|
-
#
|
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
|
-
#
|
118
|
-
|
119
|
-
#
|
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: 是否开启图片旋转识别支持。
|
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
|
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
|
225
|
+
# @param FaceId: 人脸ID。
|
226
|
+
# - 仅在SearchFaces/SearchFacesReturnsByGroup接口返回时有效。
|
227
|
+
# - 人员搜索类接口采用融合特征方式检索,该字段无意义。
|
211
228
|
# @type FaceId: String
|
212
229
|
# @param Score: 候选者的匹配得分。
|
213
|
-
|
214
|
-
#
|
215
|
-
#
|
216
|
-
#
|
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
|
1112
|
-
#
|
1113
|
-
#
|
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
|
-
#
|
1126
|
-
#
|
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: 是否开启图片旋转识别支持。
|
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:
|
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
|
1205
|
-
#
|
1206
|
-
#
|
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
|
1209
|
-
#
|
1210
|
-
#
|
1211
|
-
#
|
1212
|
-
#
|
1213
|
-
#
|
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)。
|
1216
|
-
#
|
1217
|
-
#
|
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: 是否开启质量检测。
|
1221
|
-
#
|
1222
|
-
#
|
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: 是否开启图片旋转识别支持。
|
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
|
1301
|
-
#
|
1302
|
-
#
|
1303
|
-
#
|
1304
|
-
#
|
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
|
1307
|
-
#
|
1308
|
-
#
|
1309
|
-
#
|
1310
|
-
#
|
1311
|
-
#
|
1312
|
-
#
|
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:
|
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:
|
1549
|
+
# @param Gender: 性别。
|
1550
|
+
# - 取值说明:[0~49]为女性,[50,100]为男性,越接近0和100表示置信度越高。
|
1551
|
+
# - NeedFaceAttributes 不为 1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1510
1552
|
# @type Gender: Integer
|
1511
|
-
# @param Age: 年龄
|
1553
|
+
# @param Age: 年龄 。
|
1554
|
+
# - 取值范围:[0~100]。
|
1555
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1512
1556
|
# @type Age: Integer
|
1513
|
-
# @param Expression:
|
1557
|
+
# @param Expression: 微笑。
|
1558
|
+
# - 取值说明:[0(normal,正常)~100(laugh,大笑)]。
|
1559
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1514
1560
|
# @type Expression: Integer
|
1515
|
-
# @param Glass:
|
1561
|
+
# @param Glass: 是否有眼镜。
|
1562
|
+
# - 取值范围: [true,false]。
|
1563
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1516
1564
|
# @type Glass: Boolean
|
1517
|
-
# @param Pitch:
|
1518
|
-
#
|
1565
|
+
# @param Pitch: 上下偏移。
|
1566
|
+
# - 取值范围:[-30,30],单位角度。
|
1567
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1568
|
+
# - 建议:人脸入库选择[-10,10]的图片。
|
1519
1569
|
# @type Pitch: Integer
|
1520
|
-
# @param Yaw:
|
1521
|
-
#
|
1570
|
+
# @param Yaw: 左右偏移。
|
1571
|
+
# - 取值范围:[-30,30],单位角度。
|
1572
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1573
|
+
# - 建议:人脸入库选择[-10,10]的图片。
|
1522
1574
|
# @type Yaw: Integer
|
1523
|
-
# @param Roll:
|
1524
|
-
#
|
1575
|
+
# @param Roll: 平面旋转。
|
1576
|
+
# - 取值范围:[-180,180],单位角度。
|
1577
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1578
|
+
# - 建议:人脸入库选择[-20,20]的图片。
|
1525
1579
|
# @type Roll: Integer
|
1526
|
-
# @param Beauty:
|
1580
|
+
# @param Beauty: 魅力。
|
1581
|
+
# - 取值范围:[0~100]。
|
1582
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1527
1583
|
# @type Beauty: Integer
|
1528
|
-
# @param Hat:
|
1584
|
+
# @param Hat: 是否有帽子。
|
1585
|
+
# - 取值范围: [true,false]。
|
1586
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1529
1587
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1530
1588
|
# @type Hat: Boolean
|
1531
|
-
# @param Mask:
|
1589
|
+
# @param Mask: 是否有口罩。
|
1590
|
+
# - 取值范围: [true,false]。
|
1591
|
+
# - NeedFaceAttributes 不为1 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1532
1592
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1533
1593
|
# @type Mask: Boolean
|
1534
|
-
# @param Hair: 头发信息,包含头发长度(length)、有无刘海(bang)、头发颜色(color)。
|
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:
|
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:
|
1584
|
-
#
|
1647
|
+
# @param Age: 年龄。
|
1648
|
+
# - 取值范围: [0,65],其中65代表“65岁及以上”。
|
1649
|
+
# - FaceAttributesType 不含Age 或检测超过 5 张人脸时,此参数仍返回,但不具备参考意义。
|
1585
1650
|
# @type Age: Integer
|
1586
|
-
# @param Beauty:
|
1587
|
-
#
|
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:
|
1636
|
-
#
|
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:
|
1724
|
-
#
|
1725
|
-
#
|
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:
|
1791
|
-
#
|
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:
|
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:
|
1827
|
-
#
|
1894
|
+
# @param Eyebrow: 眉毛的遮挡分数。
|
1895
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1896
|
+
# - 参考范围:[0,80]表示发生遮挡。
|
1828
1897
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1829
1898
|
# @type Eyebrow: Integer
|
1830
|
-
# @param Eye:
|
1831
|
-
#
|
1899
|
+
# @param Eye: 眼睛的遮挡分数。
|
1900
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1901
|
+
# - 参考范围:[0,80]表示发生遮挡。
|
1832
1902
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1833
1903
|
# @type Eye: Integer
|
1834
|
-
# @param Nose:
|
1835
|
-
#
|
1904
|
+
# @param Nose: 鼻子的遮挡分数。
|
1905
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1906
|
+
# - 参考范围:[0,60]表示发生遮挡。
|
1836
1907
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1837
1908
|
# @type Nose: Integer
|
1838
|
-
# @param Cheek:
|
1839
|
-
#
|
1909
|
+
# @param Cheek: 脸颊的遮挡分数。
|
1910
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1911
|
+
# - 参考范围:[0,70]表示发生遮挡。
|
1840
1912
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1841
1913
|
# @type Cheek: Integer
|
1842
|
-
# @param Mouth:
|
1843
|
-
#
|
1914
|
+
# @param Mouth: 嘴巴的遮挡分数。
|
1915
|
+
# - 取值范围:[0,100],分数越高遮挡越少。
|
1916
|
+
# - 参考范围:[0,50]表示发生遮挡。
|
1844
1917
|
# 注意:此字段可能返回 null,表示取不到有效值。
|
1845
1918
|
# @type Mouth: Integer
|
1846
|
-
# @param Chin:
|
1847
|
-
#
|
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:
|
1875
|
-
#
|
1876
|
-
#
|
1877
|
-
#
|
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:
|
1881
|
-
#
|
1882
|
-
#
|
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:
|
1886
|
-
#
|
1887
|
-
#
|
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。
|
2559
|
-
#
|
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。
|
2883
|
-
#
|
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: 检测出的人脸图片状态返回码。
|
2934
|
-
# -
|
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: 检测出的人脸图片状态返回码。
|
2969
|
-
# -
|
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
|
3537
|
-
#
|
3538
|
-
#
|
3539
|
-
#
|
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
|
3542
|
-
#
|
3543
|
-
#
|
3544
|
-
#
|
3545
|
-
#
|
3546
|
-
#
|
3547
|
-
#
|
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
|
-
#
|
3551
|
-
#
|
3552
|
-
#
|
3553
|
-
#
|
3554
|
-
#
|
3555
|
-
#
|
3556
|
-
#
|
3637
|
+
# - 取值范围:
|
3638
|
+
# 0: 不进行控制。
|
3639
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
3640
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
3641
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
3642
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
3643
|
+
# - 默认 0。
|
3644
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
3557
3645
|
# @type QualityControl: Integer
|
3558
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
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
|
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
|
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
|
-
#
|
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
|
-
#
|
3624
|
-
#
|
3625
|
-
#
|
3626
|
-
#
|
3627
|
-
#
|
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
|
-
#
|
3631
|
-
#
|
3632
|
-
#
|
3633
|
-
#
|
3634
|
-
#
|
3635
|
-
#
|
3636
|
-
#
|
3725
|
+
# - 取值范围:
|
3726
|
+
# 0: 不进行控制。
|
3727
|
+
# 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况。
|
3728
|
+
# 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况。
|
3729
|
+
# 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况。
|
3730
|
+
# 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题。
|
3731
|
+
# - 默认 0。
|
3732
|
+
# - 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
|
3637
3733
|
# @type QualityControl: Integer
|
3638
|
-
# @param NeedRotateDetection: 是否开启图片旋转识别支持。
|
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
|
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.
|
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-
|
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
|