tencentcloud-sdk-facefusion 3.0.489 → 3.0.491

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2f9ba21cc7b3549a6a449a4ab5514b517bd6b689
-  data.tar.gz: 3394243a3869e2b9fc0e3b65f06b26d869c58b2f
+  metadata.gz: 2fdad5ec12d59585c5b075ffec7ee9a8495a17f0
+  data.tar.gz: ae1d90e1c65239deac46a9a7322fcf5a68672416
 SHA512:
-  metadata.gz: f63e920cd78b3020efde0a1edf9278471c42c8890e7983acb3c83744f6b772456e3702233b2b025ecbad599567aff95b88083ed6c3945094c1a72eade01a87d9
-  data.tar.gz: 2ff9bd6817fd428e259d2fbdfc03ebf8f68fe9692b7779b8451908c41f011c6169ac302b984fb4970ad830a6b480fef323bf0aaa7132ffa32a4becc4477a875a
+  metadata.gz: 5c34a9962394cc36ef5ab68a407e22cf7542b4fb2102bfa85cee73d9dd2916252c83cb33bbbecff46dc4a046c17f979e579e8897e95b180bd1e0ce18e61faded
+  data.tar.gz: b35531f4e333e01808473226ab387df7b267c0527a09fd92bb194b4c303dd79a50a2be6bd45639fe947475c78d34a4ec60fef561a12786ad1a22e51265b4303c

data/lib/VERSION

@@ -1 +1 @@
-3.0.489
+3.0.491

data/lib/tencentcloud-sdk-facefusion.rb

@@ -5,6 +5,9 @@ require 'tencentcloud-sdk-common'
 require_relative 'v20181201/client'
 require_relative 'v20181201/models'
 
+require_relative 'v20220927/client'
+require_relative 'v20220927/models'
+
 module TencentCloud
   module Facefusion
   end

data/lib/v20220927/client.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'json'
+
+module TencentCloud
+  module Facefusion
+    module V20220927
+      class Client < TencentCloud::Common::AbstractClient
+
+        def initialize(credential, region, profile = nil)
+            api_version = '2022-09-27'
+            api_endpoint = 'facefusion.tencentcloudapi.com'
+            sdk_version = 'FACEFUSION_' + File.read(File.expand_path('../VERSION', __dir__)).strip
+            super(credential, region, api_version, api_endpoint, sdk_version, profile)
+        end
+
+
+        # 通常通过腾讯云人脸融合的控制台可以查看到素材相关的参数数据，可以满足使用。本接口返回活动的素材数据，包括素材状态等。用于用户通过Api查看素材相关数据，方便使用。
+
+        # @param request: Request instance for DescribeMaterialList.
+        # @type request: :class:`Tencentcloud::facefusion::V20220927::DescribeMaterialListRequest`
+        # @rtype: :class:`Tencentcloud::facefusion::V20220927::DescribeMaterialListResponse`
+        def DescribeMaterialList(request)
+          body = send_request('DescribeMaterialList', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeMaterialListResponse.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
+
+        # 本接口用于单脸、多脸、选脸融合，上传人脸图片，得到与素材模板融合后的人脸图片。支持为融合结果图添加标识。查看 <a href="https://cloud.tencent.com/document/product/670/38247" target="_blank">融合接入指引</a>。
+
+        # 请求频率限制为20次/秒。
+        # >
+        # - 公共参数中的签名方式必须指定为V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
+
+        # @param request: Request instance for FuseFace.
+        # @type request: :class:`Tencentcloud::facefusion::V20220927::FuseFaceRequest`
+        # @rtype: :class:`Tencentcloud::facefusion::V20220927::FuseFaceResponse`
+        def FuseFace(request)
+          body = send_request('FuseFace', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = FuseFaceResponse.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
+
+
+      end
+    end
+  end
+end

data/lib/v20220927/models.rb

@@ -0,0 +1,343 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module TencentCloud
+  module Facefusion
+    module V20220927
+      # DescribeMaterialList请求参数结构体
+      class DescribeMaterialListRequest < TencentCloud::Common::AbstractModel
+        # @param ActivityId: 活动Id
+        # @type ActivityId: String
+        # @param MaterialId: 素材Id
+        # @type MaterialId: String
+        # @param Limit: 每次拉取条数
+        # @type Limit: Integer
+        # @param Offset: 偏移量
+        # @type Offset: Integer
+
+        attr_accessor :ActivityId, :MaterialId, :Limit, :Offset
+        
+        def initialize(activityid=nil, materialid=nil, limit=nil, offset=nil)
+          @ActivityId = activityid
+          @MaterialId = materialid
+          @Limit = limit
+          @Offset = offset
+        end
+
+        def deserialize(params)
+          @ActivityId = params['ActivityId']
+          @MaterialId = params['MaterialId']
+          @Limit = params['Limit']
+          @Offset = params['Offset']
+        end
+      end
+
+      # DescribeMaterialList返回参数结构体
+      class DescribeMaterialListResponse < TencentCloud::Common::AbstractModel
+        # @param MaterialInfos: 素材列表数据
+        # @type MaterialInfos: Array
+        # @param Count: 素材条数
+        # @type Count: Integer
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :MaterialInfos, :Count, :RequestId
+        
+        def initialize(materialinfos=nil, count=nil, requestid=nil)
+          @MaterialInfos = materialinfos
+          @Count = count
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['MaterialInfos'].nil?
+            @MaterialInfos = []
+            params['MaterialInfos'].each do |i|
+              publicmaterialinfos_tmp = PublicMaterialInfos.new
+              publicmaterialinfos_tmp.deserialize(i)
+              @MaterialInfos << publicmaterialinfos_tmp
+            end
+          end
+          @Count = params['Count']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # 人脸信息
+      class FaceInfo < TencentCloud::Common::AbstractModel
+        # @param X: 人脸框的横坐标
+        # @type X: Integer
+        # @param Y: 人脸框的纵坐标
+        # @type Y: Integer
+        # @param Width: 人脸框的宽度
+        # @type Width: Integer
+        # @param Height: 人脸框的高度
+        # @type Height: Integer
+
+        attr_accessor :X, :Y, :Width, :Height
+        
+        def initialize(x=nil, y=nil, width=nil, height=nil)
+          @X = x
+          @Y = y
+          @Width = width
+          @Height = height
+        end
+
+        def deserialize(params)
+          @X = params['X']
+          @Y = params['Y']
+          @Width = params['Width']
+          @Height = params['Height']
+        end
+      end
+
+      # 人脸框信息
+      class FaceRect < TencentCloud::Common::AbstractModel
+        # @param X: 人脸框左上角横坐标。
+        # @type X: Integer
+        # @param Y: 人脸框左上角纵坐标。
+        # @type Y: Integer
+        # @param Width: 人脸框宽度。
+        # @type Width: Integer
+        # @param Height: 人脸框高度。
+        # @type Height: Integer
+
+        attr_accessor :X, :Y, :Width, :Height
+        
+        def initialize(x=nil, y=nil, width=nil, height=nil)
+          @X = x
+          @Y = y
+          @Width = width
+          @Height = height
+        end
+
+        def deserialize(params)
+          @X = params['X']
+          @Y = params['Y']
+          @Width = params['Width']
+          @Height = params['Height']
+        end
+      end
+
+      # FuseFace请求参数结构体
+      class FuseFaceRequest < TencentCloud::Common::AbstractModel
+        # @param ProjectId: 活动 ID，请在人脸融合控制台查看。
+        # @type ProjectId: String
+        # @param ModelId: 素材 ID，请在人脸融合控制台查看。
+        # @type ModelId: String
+        # @param RspImgType: 返回图像方式（url 或 base64) ，二选一。url有效期为7天。
+        # @type RspImgType: String
+        # @param MergeInfos: 用户人脸图片、素材模板图的人脸位置信息。
+        # @type MergeInfos: Array
+        # @param FuseProfileDegree: 脸型融合比例，数值越高，融合后的脸型越像素材人物。取值范围[0,100]
+        # 若此参数不填写，则使用人脸融合控制台中脸型参数数值。（换脸版算法暂不支持此参数调整）
+        # @type FuseProfileDegree: Integer
+        # @param FuseFaceDegree: 五官融合比例，数值越高，融合后的五官越像素材人物。取值范围[0,100]
+        # 若此参数不填写，则使用人脸融合控制台中五官参数数值。（换脸版算法暂不支持此参数调整）
+        # @type FuseFaceDegree: Integer
+        # @param LogoAdd: 为融合结果图添加合成标识的开关，默认为1。
+        # 1：添加标识。
+        # 0：不添加标识。
+        # 其他数值：默认按1处理。
+        # 建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。
+        # @type LogoAdd: Integer
+        # @param LogoParam: 标识内容设置。
+        # 默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。
+        # @type LogoParam: :class:`Tencentcloud::Facefusion.v20220927.models.LogoParam`
+
+        attr_accessor :ProjectId, :ModelId, :RspImgType, :MergeInfos, :FuseProfileDegree, :FuseFaceDegree, :LogoAdd, :LogoParam
+        
+        def initialize(projectid=nil, modelid=nil, rspimgtype=nil, mergeinfos=nil, fuseprofiledegree=nil, fusefacedegree=nil, logoadd=nil, logoparam=nil)
+          @ProjectId = projectid
+          @ModelId = modelid
+          @RspImgType = rspimgtype
+          @MergeInfos = mergeinfos
+          @FuseProfileDegree = fuseprofiledegree
+          @FuseFaceDegree = fusefacedegree
+          @LogoAdd = logoadd
+          @LogoParam = logoparam
+        end
+
+        def deserialize(params)
+          @ProjectId = params['ProjectId']
+          @ModelId = params['ModelId']
+          @RspImgType = params['RspImgType']
+          unless params['MergeInfos'].nil?
+            @MergeInfos = []
+            params['MergeInfos'].each do |i|
+              mergeinfo_tmp = MergeInfo.new
+              mergeinfo_tmp.deserialize(i)
+              @MergeInfos << mergeinfo_tmp
+            end
+          end
+          @FuseProfileDegree = params['FuseProfileDegree']
+          @FuseFaceDegree = params['FuseFaceDegree']
+          @LogoAdd = params['LogoAdd']
+          unless params['LogoParam'].nil?
+            @LogoParam = LogoParam.new
+            @LogoParam.deserialize(params['LogoParam'])
+          end
+        end
+      end
+
+      # FuseFace返回参数结构体
+      class FuseFaceResponse < TencentCloud::Common::AbstractModel
+        # @param FusedImage: RspImgType 为 url 时，返回结果的 url， RspImgType 为 base64 时返回 base64 数据。
+        # @type FusedImage: String
+        # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :FusedImage, :RequestId
+        
+        def initialize(fusedimage=nil, requestid=nil)
+          @FusedImage = fusedimage
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @FusedImage = params['FusedImage']
+          @RequestId = params['RequestId']
+        end
+      end
+
+      # logo参数
+      class LogoParam < TencentCloud::Common::AbstractModel
+        # @param LogoRect: 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配
+        # @type LogoRect: :class:`Tencentcloud::Facefusion.v20220927.models.FaceRect`
+        # @param LogoUrl: 标识图片Url地址
+        # @type LogoUrl: String
+        # @param LogoImage: 标识图片base64
+        # @type LogoImage: String
+
+        attr_accessor :LogoRect, :LogoUrl, :LogoImage
+        
+        def initialize(logorect=nil, logourl=nil, logoimage=nil)
+          @LogoRect = logorect
+          @LogoUrl = logourl
+          @LogoImage = logoimage
+        end
+
+        def deserialize(params)
+          unless params['LogoRect'].nil?
+            @LogoRect = FaceRect.new
+            @LogoRect.deserialize(params['LogoRect'])
+          end
+          @LogoUrl = params['LogoUrl']
+          @LogoImage = params['LogoImage']
+        end
+      end
+
+      # 人脸信息
+      class MaterialFaces < TencentCloud::Common::AbstractModel
+        # @param FaceId: 人脸序号
+        # @type FaceId: String
+        # @param FaceInfo: 人脸框信息
+        # @type FaceInfo: :class:`Tencentcloud::Facefusion.v20220927.models.FaceInfo`
+
+        attr_accessor :FaceId, :FaceInfo
+        
+        def initialize(faceid=nil, faceinfo=nil)
+          @FaceId = faceid
+          @FaceInfo = faceinfo
+        end
+
+        def deserialize(params)
+          @FaceId = params['FaceId']
+          unless params['FaceInfo'].nil?
+            @FaceInfo = FaceInfo.new
+            @FaceInfo.deserialize(params['FaceInfo'])
+          end
+        end
+      end
+
+      # 人脸图片和待被融合的素材模板图的人脸位置信息。
+      class MergeInfo < TencentCloud::Common::AbstractModel
+        # @param Image: 输入图片base64
+        # @type Image: String
+        # @param Url: 输入图片url
+        # @type Url: String
+        # @param InputImageFaceRect: 上传的图片人脸位置信息（人脸框）
+        # @type InputImageFaceRect: :class:`Tencentcloud::Facefusion.v20220927.models.FaceRect`
+        # @param TemplateFaceID: 控制台上传的素材人脸ID，不填默认取最大人脸
+        # @type TemplateFaceID: String
+
+        attr_accessor :Image, :Url, :InputImageFaceRect, :TemplateFaceID
+        
+        def initialize(image=nil, url=nil, inputimagefacerect=nil, templatefaceid=nil)
+          @Image = image
+          @Url = url
+          @InputImageFaceRect = inputimagefacerect
+          @TemplateFaceID = templatefaceid
+        end
+
+        def deserialize(params)
+          @Image = params['Image']
+          @Url = params['Url']
+          unless params['InputImageFaceRect'].nil?
+            @InputImageFaceRect = FaceRect.new
+            @InputImageFaceRect.deserialize(params['InputImageFaceRect'])
+          end
+          @TemplateFaceID = params['TemplateFaceID']
+        end
+      end
+
+      # 素材信息
+      class PublicMaterialInfos < TencentCloud::Common::AbstractModel
+        # @param MaterialId: 素材Id
+        # @type MaterialId: String
+        # @param MaterialStatus: 素材状态
+        # @type MaterialStatus: Integer
+        # @param CreateTime: 创建时间
+        # @type CreateTime: String
+        # @param UpdateTime: 修改时间
+        # @type UpdateTime: String
+        # @param MaterialFaceList: 人脸信息
+        # @type MaterialFaceList: Array
+        # @param MaterialName: 素材名
+        # @type MaterialName: String
+
+        attr_accessor :MaterialId, :MaterialStatus, :CreateTime, :UpdateTime, :MaterialFaceList, :MaterialName
+        
+        def initialize(materialid=nil, materialstatus=nil, createtime=nil, updatetime=nil, materialfacelist=nil, materialname=nil)
+          @MaterialId = materialid
+          @MaterialStatus = materialstatus
+          @CreateTime = createtime
+          @UpdateTime = updatetime
+          @MaterialFaceList = materialfacelist
+          @MaterialName = materialname
+        end
+
+        def deserialize(params)
+          @MaterialId = params['MaterialId']
+          @MaterialStatus = params['MaterialStatus']
+          @CreateTime = params['CreateTime']
+          @UpdateTime = params['UpdateTime']
+          unless params['MaterialFaceList'].nil?
+            @MaterialFaceList = []
+            params['MaterialFaceList'].each do |i|
+              materialfaces_tmp = MaterialFaces.new
+              materialfaces_tmp.deserialize(i)
+              @MaterialFaceList << materialfaces_tmp
+            end
+          end
+          @MaterialName = params['MaterialName']
+        end
+      end
+
+    end
+  end
+end
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-facefusion
 version: !ruby/object:Gem::Version
-  version: 3.0.489
+  version: 3.0.491
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-09 00:00:00.000000000 Z
+date: 2023-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -35,6 +35,8 @@ extra_rdoc_files: []
 files:
 - lib/v20181201/client.rb
 - lib/v20181201/models.rb
+- lib/v20220927/client.rb
+- lib/v20220927/models.rb
 - lib/tencentcloud-sdk-facefusion.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby