tencentcloud-sdk-iai 3.0.970 → 3.0.972

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cfb417e9121c262345aeabc8b2304772617b5966
-  data.tar.gz: d22fb28a08d4b294b1cba04c8cbc303d435e3b1f
+  metadata.gz: 54e234a986604fc0134cf6d593d3c62dc4f15e56
+  data.tar.gz: c1d835d671a997aa2a76a27f52cb201100a6059e
 SHA512:
-  metadata.gz: 2dba4665fce40e4606ef03ea0c4f689fd55a00205dac692f3e86faedd1a23f297628cee054b8aebb772612a957d27021bcbc4a91c1dbe5e8172160924f8a2402
-  data.tar.gz: 692f332e0d98dd7a129570664ccde87273121fd199102305078a0370002ee421a1352e8489e1320066f46855530ea872c5ccbeb6ef3d7feae30146f8d26effd9
+  metadata.gz: eee41416accf9912cb22e401e5ae3e8e5205e8574d6fc44dfe01304659cd4057c0e0766454fa019a081dc4f6d6a410db5294b525410c7271d6cb0528f9edcc19
+  data.tar.gz: 151cee8f2538eab1a9a6d615eb85bed1422d9818040069dd983ff8493ed36a839a8c3a2c35598ca7703510780247a00617653fe92101a1ccda2062686b94544d

data/lib/VERSION

@@ -1 +1 @@
-3.0.970
+3.0.972

data/lib/v20200303/client.rb

@@ -424,6 +424,35 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 对两张图片中的人脸进行相似度比对，返回人脸相似度分数。
+
+        # 若您需要判断 “此人是否是某人”，即验证某张图片中的人是否是已知身份的某人，如常见的人脸登录场景，建议使用[人脸验证](https://www.tencentcloud.com/document/product/1059/36972)或[人员验证](https://www.tencentcloud.com/document/product/1059/36971)接口。
+
+        # >
+        # - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
+
+        # @param request: Request instance for DetectFaceSimilarity.
+        # @type request: :class:`Tencentcloud::iai::V20200303::DetectFaceSimilarityRequest`
+        # @rtype: :class:`Tencentcloud::iai::V20200303::DetectFaceSimilarityResponse`
+        def DetectFaceSimilarity(request)
+          body = send_request('DetectFaceSimilarity', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DetectFaceSimilarityResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 用于对用户上传的静态图片进行人脸活体检测。与动态活体检测的区别是：静态活体检测中，用户不需要通过唇语或摇头眨眼等动作来识别。
 
         # 静态活体检测适用于手机自拍的场景，或对防攻击要求不高的场景。如果对活体检测有更高安全性要求，请使用[人脸核身·云智慧眼](https://cloud.tencent.com/product/faceid)产品。

data/lib/v20200303/models.rb

@@ -1363,6 +1363,90 @@ module TencentCloud
         end
       end
 
+      # DetectFaceSimilarity请求参数结构体
+      class DetectFaceSimilarityRequest < TencentCloud::Common::AbstractModel
+        # @param ImageA: A 图片 base64 数据。
+        # - base64 编码后大小不可超过5M。
+        # - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+        # - 若图片中包含多张人脸，只选取其中置信度最高的人脸。
+        # - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # @type ImageA: String
+        # @param ImageB: B 图片 base64 数据。
+        # - base64 编码后大小不可超过5M。
+        # - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+        # - 若图片中包含多张人脸，只选取其中置信度最高的人脸。
+        # - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # @type ImageB: String
+        # @param UrlA: A 图片的 Url。
+        # - 对应图片 base64 编码后大小不可超过5M。
+        # - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+        # - A 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
+        # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
+        # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
+        # - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+        # - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # @type UrlA: String
+        # @param UrlB: B 图片的 Url 。
+        # - 对应图片 base64 编码后大小不可超过5M。
+        # - jpg格式长边像素不可超过4000，其他格式图片长边像素不可超2000。所有格式的图片短边像素不小于64。
+        # - B 图片的 Url、Image必须提供一个，如果都提供，只使用 Url。
+        # - 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
+        # - 非腾讯云存储的Url速度和稳定性可能受一定影响。
+        # - 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。
+        # - 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        # @type UrlB: String
+        # @param QualityControl: 图片质量控制。
+        # - 取值范围：
+        # 0: 不进行控制；
+        # 1: 较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
+        # 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
+        # 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
+        # 4: 很高的质量要求，各个维度均为最好或最多，在某一维度上存在轻微问题；
+        # 默认 0。
+
+        # - 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
+        # @type QualityControl: Integer
+
+        attr_accessor :ImageA, :ImageB, :UrlA, :UrlB, :QualityControl
+
+        def initialize(imagea=nil, imageb=nil, urla=nil, urlb=nil, qualitycontrol=nil)
+          @ImageA = imagea
+          @ImageB = imageb
+          @UrlA = urla
+          @UrlB = urlb
+          @QualityControl = qualitycontrol
+        end
+
+        def deserialize(params)
+          @ImageA = params['ImageA']
+          @ImageB = params['ImageB']
+          @UrlA = params['UrlA']
+          @UrlB = params['UrlB']
+          @QualityControl = params['QualityControl']
+        end
+      end
+
+      # DetectFaceSimilarity返回参数结构体
+      class DetectFaceSimilarityResponse < TencentCloud::Common::AbstractModel
+        # @param Score: 取值范围 [0.00, 100.00]。
+        # 推荐相似度大于等于70时可判断为同一人，可根据具体场景自行调整阈值（阈值70的误通过率为千分之一，阈值80的误通过率是万分之一）。
+        # @type Score: Float
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :Score, :RequestId
+
+        def initialize(score=nil, requestid=nil)
+          @Score = score
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @Score = params['Score']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DetectLiveFaceAccurate请求参数结构体
       class DetectLiveFaceAccurateRequest < TencentCloud::Common::AbstractModel
         # @param Image: 图片 base64 数据。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-iai
 version: !ruby/object:Gem::Version
-  version: 3.0.970
+  version: 3.0.972
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-26 00:00:00.000000000 Z
+date: 2024-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common