Class: TencentCloud::Facefusion::V20220927::FuseFaceUltraRequest

Inherits:
Common::AbstractModel
  • Object
show all
Defined in:
lib/v20220927/models.rb

Overview

FuseFaceUltra请求参数结构体

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(rspimgtype = nil, mergeinfos = nil, modelurl = nil, modelimage = nil, fusionultraparam = nil, logoadd = nil, logoparam = nil, swapmodeltype = nil) ⇒ FuseFaceUltraRequest

Returns a new instance of FuseFaceUltraRequest.



269
270
271
272
273
274
275
276
277
278
 
# File 'lib/v20220927/models.rb', line 269

def initialize(rspimgtype=nil, mergeinfos=nil, modelurl=nil, modelimage=nil, fusionultraparam=nil, logoadd=nil, logoparam=nil, swapmodeltype=nil)
  @RspImgType = rspimgtype
  @MergeInfos = mergeinfos
  @ModelUrl = modelurl
  @ModelImage = modelimage
  @FusionUltraParam = fusionultraparam
  @LogoAdd = logoadd
  @LogoParam = logoparam
  @SwapModelType = swapmodeltype
end

Instance Attribute Details

#FusionUltraParam ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def FusionUltraParam
  @FusionUltraParam
end

#LogoAdd ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def LogoAdd
  @LogoAdd
end

#LogoParam ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def LogoParam
  @LogoParam
end

#MergeInfos ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def MergeInfos
  @MergeInfos
end

#ModelImage ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def ModelImage
  @ModelImage
end

#ModelUrl ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def ModelUrl
  @ModelUrl
end

#RspImgType ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def RspImgType
  @RspImgType
end

#SwapModelType ⇒ Object

目前最多支持融合模板图片中的6张人脸。●base64 和 url 必须提供一个，如果都提供以 url 为准。●图片分辨率限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●图片格式：支持jpg或png ●base64 和 url 必须提供一个，如果都提供以 url 为准。●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。●图片大小限制：base64 编码后大小不可超过10M， url不超过20M。●支持图片格式：支持jpg或png 1：添加标识。0：不添加标识。其他数值：默认按1处理。建议您使用显著标识来提示结果图使用了人脸融合技术，是AI合成的图片。默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果1：默认泛娱乐场景，画面偏锐。2：影视级场景，画面偏自然。3：影视级场景，高分辨率，画面偏自然。4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。5：影视级场景，高分辨率，对闭眼和遮挡更友好。6：影视级场景，高分辨率，极高人脸相似度，可用于电商照片、证件照、文旅照片等场景。

Parameters:

  • RspImgType: —

    返回融合结果图片方式（url 或 base64) ，二选一。url有效期为1天。

  • MergeInfos: —

    用户人脸图片、素材模板图的人脸位置信息。主要用于素材模版中人脸以及用作融合的用户人脸相关信息，两种人脸都需要提供人脸图片，可选择提供人脸框位置，具体见MergeInfo说明

  • ModelUrl: —

    素材模版图片的url地址。

  • ModelImage: —

    素材模版图片base64数据。

  • FusionUltraParam: —

    图片人脸融合（专业版）效果参数。可用于设置拉脸、人脸增强、磨皮、牙齿增强、妆容迁移等融合效果参数，生成理想的融合效果。不传默认使用接口推荐值。具体见FusionUltraParam说明

  • LogoAdd: —

    为融合结果图添加合成标识的开关，默认为1。

  • LogoParam: —

    标识内容设置。

  • SwapModelType: —

    融合模型类型参数：默认为1。



267
268
269
 
# File 'lib/v20220927/models.rb', line 267

def SwapModelType
  @SwapModelType
end

Instance Method Details

#deserialize(params) ⇒ Object 



280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
 
# File 'lib/v20220927/models.rb', line 280

def deserialize(params)
  @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
  @ModelUrl = params['ModelUrl']
  @ModelImage = params['ModelImage']
  unless params['FusionUltraParam'].nil?
    @FusionUltraParam = FusionUltraParam.new
    @FusionUltraParam.deserialize(params['FusionUltraParam'])
  end
  @LogoAdd = params['LogoAdd']
  unless params['LogoParam'].nil?
    @LogoParam = LogoParam.new
    @LogoParam.deserialize(params['LogoParam'])
  end
  @SwapModelType = params['SwapModelType']
end