tencentcloud-sdk-python-facefusion 3.0.1209__tar.gz → 3.0.1237__tar.gz

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-facefusion
-Version: 3.0.1209
+Version: 3.0.1237
 Summary: Tencent Cloud Facefusion SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-facefusion',
-    install_requires=["tencentcloud-sdk-python-common==3.0.1209"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1237"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Facefusion SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1209'
+__version__ = '3.0.1237'

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/tencentcloud/facefusion/v20181201/models.py

@@ -936,11 +936,17 @@ class MergeInfo(AbstractModel):
     def __init__(self):
         r"""
         :param _Image: 输入图片base64。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
+●支持图片格式：支持jpg或png。
         :type Image: str
         :param _Url: 输入图片url。
-Url、Image必须提供一个，如果都提供，只使用 Url。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
+●支持图片格式：支持jpg或png。
         :type Url: str
         :param _InputImageFaceRect: 输入图片人脸位置信息（人脸框）。不填默认取输入图中最大人脸。
+Width、Height >= 30。
         :type InputImageFaceRect: :class:`tencentcloud.facefusion.v20181201.models.FaceRect`
         :param _TemplateFaceID: 素材人脸ID，不填默认取素材中最大人脸。
         :type TemplateFaceID: str
@@ -1007,9 +1013,9 @@ class MetaData(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _MetaKey: MetaData的Key
+        :param _MetaKey: MetaData的Key，长度不能超过32。
         :type MetaKey: str
-        :param _MetaValue: MetaData的Value
+        :param _MetaValue: MetaData的Value，长度不能超过256。
         :type MetaValue: str
         """
         self._MetaKey = None

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/tencentcloud/facefusion/v20220927/errorcodes.py

@@ -17,42 +17,18 @@
 # 操作失败。
 FAILEDOPERATION = 'FailedOperation'
 
-# 人脸配准点出框错误码。
-FAILEDOPERATION_FACEBORDERCHECKFAILED = 'FailedOperation.FaceBorderCheckFailed'
-
-# 人脸出框，无法使用。
-FAILEDOPERATION_FACEEXCEEDBORDER = 'FailedOperation.FaceExceedBorder'
-
-# 人脸融合失败，请更换图片后重试。
-FAILEDOPERATION_FACEFUSIONERROR = 'FailedOperation.FaceFusionError'
-
-# 人脸框不合法。
-FAILEDOPERATION_FACERECTINVALID = 'FailedOperation.FaceRectInvalid'
-
-# 人脸配准失败。
-FAILEDOPERATION_FACESHAPEFAILED = 'FailedOperation.FaceShapeFailed'
+# 余额不足，开通失败，请充值后再开通。
+FAILEDOPERATION_BALANCEINSUFFICIENT = 'FailedOperation.BalanceInsufficient'
 
 # 人脸因太小被过滤，建议人脸分辨率不小于34*34。
 FAILEDOPERATION_FACESIZETOOSMALL = 'FailedOperation.FaceSizeTooSmall'
 
-# 操作太频繁，触发频控。
-FAILEDOPERATION_FUSEFREQCTRL = 'FailedOperation.FuseFreqCtrl'
-
-# 图像处理出错。
-FAILEDOPERATION_FUSEIMAGEERROR = 'FailedOperation.FuseImageError'
-
-# 服务内部错误，请重试。
-FAILEDOPERATION_FUSEINNERERROR = 'FailedOperation.FuseInnerError'
-
 # 素材未经过审核。
 FAILEDOPERATION_FUSEMATERIALNOTAUTH = 'FailedOperation.FuseMaterialNotAuth'
 
 # 素材不存在。
 FAILEDOPERATION_FUSEMATERIALNOTEXIST = 'FailedOperation.FuseMaterialNotExist'
 
-# 保存结果图片出错。
-FAILEDOPERATION_FUSESAVEPHOTOFAIL = 'FailedOperation.FuseSavePhotoFail'
-
 # 人脸检测-图片解码失败。
 FAILEDOPERATION_IMAGEDECODEFAILED = 'FailedOperation.ImageDecodeFailed'
 
@@ -62,21 +38,12 @@ FAILEDOPERATION_IMAGEDOWNLOADERROR = 'FailedOperation.ImageDownloadError'
 # 素材尺寸超过1080*1080像素。
 FAILEDOPERATION_IMAGEPIXELEXCEED = 'FailedOperation.ImagePixelExceed'
 
-# 素材尺寸超过8000*8000像素。
-FAILEDOPERATION_IMAGEPIXELEXCEED8000 = 'FailedOperation.ImagePixelExceed8000'
-
-# 图片分辨率过大。建议您resize压缩到3k*3k以内。
-FAILEDOPERATION_IMAGERESOLUTIONEXCEED = 'FailedOperation.ImageResolutionExceed'
-
 # 图片短边分辨率小于64。
 FAILEDOPERATION_IMAGERESOLUTIONTOOSMALL = 'FailedOperation.ImageResolutionTooSmall'
 
 # 输入图片base64数据大小超过5M。
 FAILEDOPERATION_IMAGESIZEEXCEED = 'FailedOperation.ImageSizeExceed'
 
-# 输入图片base64数据大小超过10M。
-FAILEDOPERATION_IMAGESIZEEXCEED10M = 'FailedOperation.ImageSizeExceed10M'
-
 # 图片尺寸过大或者过小；不满足算法要求。
 FAILEDOPERATION_IMAGESIZEINVALID = 'FailedOperation.ImageSizeInvalid'
 
@@ -89,12 +56,6 @@ FAILEDOPERATION_NOFACEDETECTED = 'FailedOperation.NoFaceDetected'
 # 参数字段或者值有误。
 FAILEDOPERATION_PARAMETERVALUEERROR = 'FailedOperation.ParameterValueError'
 
-# 活动未支付授权费或已停用。
-FAILEDOPERATION_PROJECTNOTAUTH = 'FailedOperation.ProjectNotAuth'
-
-# 请求实体太大。
-FAILEDOPERATION_REQUESTENTITYTOOLARGE = 'FailedOperation.RequestEntityTooLarge'
-
 # 后端服务超时。
 FAILEDOPERATION_REQUESTTIMEOUT = 'FailedOperation.RequestTimeout'
 
@@ -119,53 +80,38 @@ INVALIDPARAMETERVALUE_ACTIVITYIDNOTFOUND = 'InvalidParameterValue.ActivityIdNotF
 # 人脸框参数有误或者人脸框太小。
 INVALIDPARAMETERVALUE_FACERECTPARAMETERVALUEERROR = 'InvalidParameterValue.FaceRectParameterValueError'
 
-# 人脸检测-图片为空。
-INVALIDPARAMETERVALUE_IMAGEEMPTY = 'InvalidParameterValue.ImageEmpty'
-
-# 图片包含违法违规信息，审核不通过。
-INVALIDPARAMETERVALUE_IMAGEILLEGALDETECTED = 'InvalidParameterValue.ImageIllegalDetected'
-
 # 未查找到素材Id。
 INVALIDPARAMETERVALUE_MATERIALIDNOTFOUND = 'InvalidParameterValue.MaterialIdNotFound'
 
-# 人脸检测-图片没有人脸。
-INVALIDPARAMETERVALUE_NOFACEINPHOTO = 'InvalidParameterValue.NoFaceInPhoto'
-
 # 参数字段或者值有误。
 INVALIDPARAMETERVALUE_PARAMETERVALUEERROR = 'InvalidParameterValue.ParameterValueError'
 
+# URL格式不合法。
+INVALIDPARAMETERVALUE_URLILLEGAL = 'InvalidParameterValue.UrlIllegal'
+
+# 请求的次数超过了频率限制。
+REQUESTLIMITEXCEEDED = 'RequestLimitExceeded'
+
+# 资源不足。
+RESOURCEINSUFFICIENT = 'ResourceInsufficient'
+
 # 资源不存在。
 RESOURCENOTFOUND = 'ResourceNotFound'
 
-# 资源正在发货中。
-RESOURCEUNAVAILABLE_DELIVERING = 'ResourceUnavailable.Delivering'
-
 # 账号已被冻结。
 RESOURCEUNAVAILABLE_FREEZE = 'ResourceUnavailable.Freeze'
 
-# 获取认证信息失败。
-RESOURCEUNAVAILABLE_GETAUTHINFOERROR = 'ResourceUnavailable.GetAuthInfoError'
-
 # 账号已欠费。
 RESOURCEUNAVAILABLE_INARREARS = 'ResourceUnavailable.InArrears'
 
-# 余额不足。
-RESOURCEUNAVAILABLE_LOWBALANCE = 'ResourceUnavailable.LowBalance'
+# 服务正在开通中，请稍等。
+RESOURCEUNAVAILABLE_ISOPENING = 'ResourceUnavailable.IsOpening'
 
 # 计费状态未知，请确认是否已在控制台开通服务。
 RESOURCEUNAVAILABLE_NOTEXIST = 'ResourceUnavailable.NotExist'
 
-# 服务未开通。
-RESOURCEUNAVAILABLE_NOTREADY = 'ResourceUnavailable.NotReady'
-
 # 资源已被回收。
 RESOURCEUNAVAILABLE_RECOVER = 'ResourceUnavailable.Recover'
 
 # 账号已停服。
 RESOURCEUNAVAILABLE_STOPUSING = 'ResourceUnavailable.StopUsing'
-
-# 计费状态未知。
-RESOURCEUNAVAILABLE_UNKNOWNSTATUS = 'ResourceUnavailable.UnknownStatus'
-
-# 账号已欠费。
-RESOURCESSOLDOUT_CHARGESTATUSEXCEPTION = 'ResourcesSoldOut.ChargeStatusException'

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/tencentcloud/facefusion/v20220927/models.py

@@ -292,7 +292,7 @@ class FuseFaceRequest(AbstractModel):
         :type ModelId: str
         :param _RspImgType: 返回图像方式（url 或 base64) ，二选一。url有效期为7天。
         :type RspImgType: str
-        :param _MergeInfos: 用户人脸图片、素材模板图的人脸位置信息。
+        :param _MergeInfos: 用户人脸图片、素材模板图的人脸位置信息。不能超过6个。
         :type MergeInfos: list of MergeInfo
         :param _FuseProfileDegree: 脸型融合比例，数值越高，融合后的脸型越像素材人物。取值范围[0,100] 
 若此参数不填写，则使用人脸融合控制台中脸型参数数值。（换脸版算法暂不支持此参数调整）
@@ -431,7 +431,7 @@ class FuseFaceResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _FusedImage: RspImgType 为 url 时，返回结果的 url， RspImgType 为 base64 时返回 base64 数据。
+        :param _FusedImage: RspImgType 为 url 时，返回结果的 url（有效期7天）， RspImgType 为 base64 时返回 base64 数据。
         :type FusedImage: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -474,12 +474,12 @@ class FuseFaceUltraRequest(AbstractModel):
 目前最多支持融合模板图片中的6张人脸。
         :type MergeInfos: list of MergeInfo
         :param _ModelUrl: 素材模版图片的url地址。
-●base64 和 url 必须提供一个，如果都提供以 base64 为准。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
 ●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000 * 8000（单边限制）。图片url或者图片 base64 数据，base64 编码后大小不可超过10M（图片编码之后可能会大30%左右，建议合理控制图片大小）
 ●图片格式：支持jpg或png
         :type ModelUrl: str
         :param _ModelImage: 素材模版图片base64数据。
-●base64 和 url 必须提供一个，如果都提供以 base64 为准。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
 ●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64，小于8000*8000（单边限制）。图片url或者图片 base64 数据，base64 编码后大小不可超过10M（图片编码之后可能会大30%左右，建议合理控制图片大小）
 ●支持图片格式：支持jpg或png
         :type ModelImage: str
@@ -497,11 +497,11 @@ class FuseFaceUltraRequest(AbstractModel):
 默认在融合结果图右下角添加“本图片为AI合成图片”字样，您可根据自身需要替换为其他的Logo图片。
         :type LogoParam: :class:`tencentcloud.facefusion.v20220927.models.LogoParam`
         :param _SwapModelType: 融合模型类型参数：默认为1。
-图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果
+图片人脸融合（专业版）针对不同场景，提供多种模型供选择。如您的产品是泛娱乐场景，推荐使用1；如您主要用于影像场景，推荐使用4、5。其他模型类型也可以结合您的产品使用场景进行选择，也许会有意想不到的效果
 1：默认泛娱乐场景，画面偏锐。
 2：影视级场景，画面偏自然。
 3：影视级场景，高分辨率，画面偏自然。
-4：影视级场景，高分辨率，画面偏自然。
+4：影视级场景，高分辦率，高人脸相似度，画面偏自然，可用于证件照等场景。
 5：影视级场景，高分辨率，对闭眼和遮挡更友好。
         :type SwapModelType: int
         """
@@ -688,24 +688,33 @@ class FusionUltraParam(AbstractModel):
         r"""
         :param _WarpRadio: 拉脸强度。主要用于调整生成结果人脸脸型更像素材模板还是用户人脸。取值越大越像用户人脸。
 取值范围：0-1之间。默认取值0.7。
+
+该参数仅对SwapModelType（模型类型）取值1-5生效
 注意：此字段可能返回 null，表示取不到有效值。
         :type WarpRadio: float
         :param _EnhanceRadio: 人脸增强强度。对整个人脸进行增强，增加清晰度，改善质量。当生成的人脸不够清晰，质感不够好的时候可以设置。取值越大增强强度越大。
 取值范围：0-1之间。默认取值1。
+
+该参数仅对SwapModelType（模型类型）取值1-5生效
 注意：此字段可能返回 null，表示取不到有效值。
         :type EnhanceRadio: float
         :param _MpRadio: 磨皮强度。当生成脸的图像面部显脏时，可进行设置。
 取值范围：0-1之间。默认取值1。
+
+该参数仅对SwapModelType（模型类型）取值1-5生效
 注意：此字段可能返回 null，表示取不到有效值。
         :type MpRadio: float
         :param _BlurRadio: 人脸模糊开关（暂不支持）
 当生成人脸比较清晰时，将人脸模糊到接近模板的清晰度的程度
+
+该参数仅对SwapModelType（模型类型）取值1-5生效
 注意：此字段可能返回 null，表示取不到有效值。
         :type BlurRadio: float
         :param _TeethEnhanceRadio: 牙齿增强开关，默认取值为1
 牙齿增强，修复牙齿。当生成牙齿不好（如牙齿裂开）可以打开此开关
 0：牙齿增强关闭
 1：牙齿增强打开
+该参数仅对SwapModelType（模型类型）取值1-5生效
 注意：此字段可能返回 null，表示取不到有效值。
         :type TeethEnhanceRadio: float
         """
@@ -779,7 +788,8 @@ class ImageCodecParam(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _MetaData: 元数据
+        :param _MetaData: 元数据是描述媒体文件的附加信息。通过添加自定义的元数据，可以将一些附加信息嵌入到文件中。这些信息可以用于版权、描述、标识等目的，并在后续的媒体处理或管理过程中使用。
+个数不能大于1。
         :type MetaData: list of MetaData
         """
         self._MetaData = None
@@ -817,11 +827,21 @@ class LogoParam(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _LogoRect: 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配
+        :param _LogoRect: 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配。
+Width、Height <= 2160。
         :type LogoRect: :class:`tencentcloud.facefusion.v20220927.models.FaceRect`
         :param _LogoUrl: 标识图片Url地址
+
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●支持图片格式：支持jpg或png
+专业版：base64 编码后大小不超过10M。
+非专业版：base64 编码后大小不超过5M。
         :type LogoUrl: str
-        :param _LogoImage: 标识图片base64
+        :param _LogoImage: 输入图片base64。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●支持图片格式：支持jpg或png
+专业版：base64 编码后大小不超过10M。
+非专业版：base64 编码后大小不超过5M。
         :type LogoImage: str
         """
         self._LogoRect = None
@@ -923,15 +943,23 @@ class MergeInfo(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Image: 输入图片base64
+        :param _Image: 输入图片base64。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
+●支持图片格式：支持jpg或png
         :type Image: str
-        :param _Url: 输入图片url
+        :param _Url: 输入图片url。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●素材图片限制：图片中面部尺寸大于34 * 34；图片尺寸大于64 * 64。（图片编码之后可能会大30%左右，建议合理控制图片大小）。
+●支持图片格式：支持jpg或png
         :type Url: str
         :param _InputImageFaceRect: 上传的图片人脸位置信息（人脸框）
+Width、Height >= 30。
         :type InputImageFaceRect: :class:`tencentcloud.facefusion.v20220927.models.FaceRect`
         :param _TemplateFaceID: 素材人脸ID，不填默认取最大人脸。
         :type TemplateFaceID: str
         :param _TemplateFaceRect: 模板中人脸位置信息(人脸框)，不填默认取最大人脸。此字段仅适用于图片融合自定义模板素材场景。
+Width、Height >= 30。
         :type TemplateFaceRect: :class:`tencentcloud.facefusion.v20220927.models.FaceRect`
         """
         self._Image = None
@@ -1008,9 +1036,9 @@ class MetaData(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _MetaKey: MetaData的Key
+        :param _MetaKey: MetaData的Key，字符长度不能超过32
         :type MetaKey: str
-        :param _MetaValue: MetaData的Value
+        :param _MetaValue: MetaData的Value，字符长度不能超过256
         :type MetaValue: str
         """
         self._MetaKey = None

{tencentcloud-sdk-python-facefusion-3.0.1209 → tencentcloud-sdk-python-facefusion-3.0.1237}/tencentcloud_sdk_python_facefusion.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-facefusion
-Version: 3.0.1209
+Version: 3.0.1237
 Summary: Tencent Cloud Facefusion SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

tencentcloud-sdk-python-facefusion-3.0.1237/tencentcloud_sdk_python_facefusion.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common==3.0.1237

tencentcloud-sdk-python-facefusion-3.0.1209/tencentcloud_sdk_python_facefusion.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common==3.0.1209