tencentcloud-sdk-facefusion 3.0.837 → 3.0.838

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 2c2676d9f6b89d86c65fd839442ea05b07616599
4
- data.tar.gz: e9a9946ca9b6eaccbb4c94952d11b64f6d91037a
3
+ metadata.gz: accf26482257e7d0451661f4d148dd05ca9ebdbe
4
+ data.tar.gz: ea800c9c1436af10c2717c4ce3f74b211d75013e
5
5
  SHA512:
6
- metadata.gz: 9ae3ac16dabc9e5527a3b03d26ab5b755ddc8799ecb1d60fa5c7236b6e31edfaf864e24dfb4b576964356a9d2a41fbaa97293c1347ba9a1faa0d2835d7965746
7
- data.tar.gz: 1ed18080e5bff185c2d833e9ab7400ea9022e74a53251b2e923f9b24f84af397c73ba205dc35b7ea6cf9898b142fdc29a0d85158467919481ea578230b188293
6
+ metadata.gz: 0121a7b157c14cc03b96fa9571f7e5a4e93439f17d5596c0af7ee58ab84b152e0a7aed8269e0d3a9f211c26c2b879e38332d502ba9a40317a06f183ee07bda6e
7
+ data.tar.gz: 51810a43e82c4a101684b2a97297a7850e5ea6c17861ba33b409a8b006541e1f5f2e3c250fb490586b92da686d99fad9616c534cc281b6f8b840cc885772b6af
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.837
1
+ 3.0.838
@@ -81,6 +81,31 @@ module TencentCloud
81
81
  raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
82
82
  end
83
83
 
84
+ # 图片人脸融合(专业版)为同步接口,支持自定义美颜、人脸增强、牙齿增强、拉脸等参数,最高支持8K分辨率,有多个模型类型供选择。查看 <a href="https://cloud.tencent.com/document/product/670/38247" target="_blank">融合接入指引</a>。
85
+ # 请求频率限制为2次/秒。
86
+
87
+ # @param request: Request instance for FuseFaceUltra.
88
+ # @type request: :class:`Tencentcloud::facefusion::V20220927::FuseFaceUltraRequest`
89
+ # @rtype: :class:`Tencentcloud::facefusion::V20220927::FuseFaceUltraResponse`
90
+ def FuseFaceUltra(request)
91
+ body = send_request('FuseFaceUltra', request.serialize)
92
+ response = JSON.parse(body)
93
+ if response['Response'].key?('Error') == false
94
+ model = FuseFaceUltraResponse.new
95
+ model.deserialize(response['Response'])
96
+ model
97
+ else
98
+ code = response['Response']['Error']['Code']
99
+ message = response['Response']['Error']['Message']
100
+ reqid = response['Response']['RequestId']
101
+ raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
102
+ end
103
+ rescue TencentCloud::Common::TencentCloudSDKException => e
104
+ raise e
105
+ rescue StandardError => e
106
+ raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
107
+ end
108
+
84
109
 
85
110
  end
86
111
  end
@@ -220,6 +220,102 @@ module TencentCloud
220
220
  end
221
221
  end
222
222
 
223
+ # FuseFaceUltra请求参数结构体
224
+ class FuseFaceUltraRequest < TencentCloud::Common::AbstractModel
225
+ # @param RspImgType: 返回融合结果图片方式(url 或 base64) ,二选一。url有效期为1天。
226
+ # @type RspImgType: String
227
+ # @param MergeInfos: 用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息,两种人脸都需要提供人脸图片,可选择提供人脸框位置,具体见MergeInfo说明
228
+ # 目前最多支持融合模板图片中的6张人脸。
229
+ # @type MergeInfos: Array
230
+ # @param ModelUrl: 素材模版图片的url地址。
231
+ # ●base64 和 url 必须提供一个,如果都提供以 base64 为准。
232
+ # ●素材图片限制:图片中面部尺寸大于34 * 34;图片尺寸大于64 * 64,小于8000 * 8000(单边限制)。图片url或者图片 base64 数据,base64 编码后大小不可超过10M(图片编码之后可能会大30%左右,建议合理控制图片大小)
233
+ # ●图片格式:支持jpg或png
234
+ # @type ModelUrl: String
235
+ # @param ModelImage: 素材模版图片base64数据。
236
+ # ●base64 和 url 必须提供一个,如果都提供以 base64 为准。
237
+ # ●素材图片限制:图片中面部尺寸大于34 * 34;图片尺寸大于64 * 64,小于8000*8000(单边限制)。图片url或者图片 base64 数据,base64 编码后大小不可超过10M(图片编码之后可能会大30%左右,建议合理控制图片大小)
238
+ # ●支持图片格式:支持jpg或png
239
+ # @type ModelImage: String
240
+ # @param FusionUltraParam: 图片人脸融合(专业版)效果参数。
241
+ # 可用于设置拉脸、人脸增强、磨皮、牙齿增强等融合效果参数,生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明
242
+ # @type FusionUltraParam: :class:`Tencentcloud::Facefusion.v20220927.models.FusionUltraParam`
243
+ # @param LogoAdd: 为融合结果图添加合成标识的开关,默认为1。
244
+ # 1:添加标识。
245
+ # 0:不添加标识。
246
+ # 其他数值:默认按1处理。
247
+ # 建议您使用显著标识来提示结果图使用了人脸融合技术,是AI合成的图片。
248
+ # @type LogoAdd: Integer
249
+ # @param LogoParam: 标识内容设置。
250
+ # 默认在融合结果图右下角添加“本图片为AI合成图片”字样,您可根据自身需要替换为其他的Logo图片。
251
+ # @type LogoParam: :class:`Tencentcloud::Facefusion.v20220927.models.LogoParam`
252
+ # @param SwapModelType: 融合模型类型参数:默认为1。
253
+ # 图片人脸融合(专业版)针对不同场景,提供多种模型供选择。如您的产品是泛娱乐场景,推荐使用1;如您主要用于影像场景,推荐使用5。其他模型类型也可以结合您的产品使用场景进行选择,也许会有意想不到的效果
254
+ # 1:默认泛娱乐场景,画面偏锐。
255
+ # 2:影视级场景,画面偏自然。
256
+ # 3:影视级场景,高分辨率,画面偏自然。
257
+ # 4:影视级场景,高分辨率,画面偏自然。
258
+ # 5:影视级场景,高分辨率,对闭眼和遮挡更友好。
259
+ # @type SwapModelType: Integer
260
+
261
+ attr_accessor :RspImgType, :MergeInfos, :ModelUrl, :ModelImage, :FusionUltraParam, :LogoAdd, :LogoParam, :SwapModelType
262
+
263
+ def initialize(rspimgtype=nil, mergeinfos=nil, modelurl=nil, modelimage=nil, fusionultraparam=nil, logoadd=nil, logoparam=nil, swapmodeltype=nil)
264
+ @RspImgType = rspimgtype
265
+ @MergeInfos = mergeinfos
266
+ @ModelUrl = modelurl
267
+ @ModelImage = modelimage
268
+ @FusionUltraParam = fusionultraparam
269
+ @LogoAdd = logoadd
270
+ @LogoParam = logoparam
271
+ @SwapModelType = swapmodeltype
272
+ end
273
+
274
+ def deserialize(params)
275
+ @RspImgType = params['RspImgType']
276
+ unless params['MergeInfos'].nil?
277
+ @MergeInfos = []
278
+ params['MergeInfos'].each do |i|
279
+ mergeinfo_tmp = MergeInfo.new
280
+ mergeinfo_tmp.deserialize(i)
281
+ @MergeInfos << mergeinfo_tmp
282
+ end
283
+ end
284
+ @ModelUrl = params['ModelUrl']
285
+ @ModelImage = params['ModelImage']
286
+ unless params['FusionUltraParam'].nil?
287
+ @FusionUltraParam = FusionUltraParam.new
288
+ @FusionUltraParam.deserialize(params['FusionUltraParam'])
289
+ end
290
+ @LogoAdd = params['LogoAdd']
291
+ unless params['LogoParam'].nil?
292
+ @LogoParam = LogoParam.new
293
+ @LogoParam.deserialize(params['LogoParam'])
294
+ end
295
+ @SwapModelType = params['SwapModelType']
296
+ end
297
+ end
298
+
299
+ # FuseFaceUltra返回参数结构体
300
+ class FuseFaceUltraResponse < TencentCloud::Common::AbstractModel
301
+ # @param FusedImage: RspImgType 为 url 时,返回结果的 url, RspImgType 为 base64 时返回 base64 数据。url有效期为1天。
302
+ # @type FusedImage: String
303
+ # @param RequestId: 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。
304
+ # @type RequestId: String
305
+
306
+ attr_accessor :FusedImage, :RequestId
307
+
308
+ def initialize(fusedimage=nil, requestid=nil)
309
+ @FusedImage = fusedimage
310
+ @RequestId = requestid
311
+ end
312
+
313
+ def deserialize(params)
314
+ @FusedImage = params['FusedImage']
315
+ @RequestId = params['RequestId']
316
+ end
317
+ end
318
+
223
319
  # 融合参数
224
320
  class FuseParam < TencentCloud::Common::AbstractModel
225
321
  # @param ImageCodecParam: 图片编码参数
@@ -239,6 +335,50 @@ module TencentCloud
239
335
  end
240
336
  end
241
337
 
338
+ # 高精度融合参数
339
+ class FusionUltraParam < TencentCloud::Common::AbstractModel
340
+ # @param WarpRadio: 拉脸强度。主要用于调整生成结果人脸脸型更像素材模板还是用户人脸。取值越大越像用户人脸。
341
+ # 取值范围:0-1之间。默认取值0.7。
342
+ # 注意:此字段可能返回 null,表示取不到有效值。
343
+ # @type WarpRadio: Float
344
+ # @param EnhanceRadio: 人脸增强强度。对整个人脸进行增强,增加清晰度,改善质量。当生成的人脸不够清晰,质感不够好的时候可以设置。取值越大增强强度越大。
345
+ # 取值范围:0-1之间。默认取值1。
346
+ # 注意:此字段可能返回 null,表示取不到有效值。
347
+ # @type EnhanceRadio: Float
348
+ # @param MpRadio: 磨皮强度。当生成脸的图像面部显脏时,可进行设置。
349
+ # 取值范围:0-1之间。默认取值1。
350
+ # 注意:此字段可能返回 null,表示取不到有效值。
351
+ # @type MpRadio: Float
352
+ # @param BlurRadio: 人脸模糊开关(暂不支持)
353
+ # 当生成人脸比较清晰时,将人脸模糊到接近模板的清晰度的程度
354
+ # 注意:此字段可能返回 null,表示取不到有效值。
355
+ # @type BlurRadio: Float
356
+ # @param TeethEnhanceRadio: 牙齿增强开关,默认取值为1
357
+ # 牙齿增强,修复牙齿。当生成牙齿不好(如牙齿裂开)可以打开此开关
358
+ # 0:牙齿增强关闭
359
+ # 1:牙齿增强打开
360
+ # 注意:此字段可能返回 null,表示取不到有效值。
361
+ # @type TeethEnhanceRadio: Float
362
+
363
+ attr_accessor :WarpRadio, :EnhanceRadio, :MpRadio, :BlurRadio, :TeethEnhanceRadio
364
+
365
+ def initialize(warpradio=nil, enhanceradio=nil, mpradio=nil, blurradio=nil, teethenhanceradio=nil)
366
+ @WarpRadio = warpradio
367
+ @EnhanceRadio = enhanceradio
368
+ @MpRadio = mpradio
369
+ @BlurRadio = blurradio
370
+ @TeethEnhanceRadio = teethenhanceradio
371
+ end
372
+
373
+ def deserialize(params)
374
+ @WarpRadio = params['WarpRadio']
375
+ @EnhanceRadio = params['EnhanceRadio']
376
+ @MpRadio = params['MpRadio']
377
+ @BlurRadio = params['BlurRadio']
378
+ @TeethEnhanceRadio = params['TeethEnhanceRadio']
379
+ end
380
+ end
381
+
242
382
  # 图片编码参数
243
383
  class ImageCodecParam < TencentCloud::Common::AbstractModel
244
384
  # @param MetaData: 元数据
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-facefusion
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.837
4
+ version: 3.0.838
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-06-04 00:00:00.000000000 Z
11
+ date: 2024-06-05 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common