tencentcloud-sdk-python 3.0.1210__py2.py3-none-any.whl → 3.0.1225__py2.py3-none-any.whl

tencentcloud/essbasic/v20210526/models.py

@@ -599,7 +599,7 @@ class AutoSignConfig(AbstractModel):
 <ul><li>**false**: 不需要(默认)</li>
 <li>**true**: 需要</li></ul>
         :type SealImgCallback: bool
-        :param _CallbackUrl: 回调链接，如果渠道已经配置了，可以不传
+        :param _CallbackUrl: 该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息
         :type CallbackUrl: str
         :param _VerifyChannels: 开通时候的身份验证方式, 取值为：
 <ul><li>**WEIXINAPP** : 微信人脸识别</li>
@@ -669,10 +669,14 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def CallbackUrl(self):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         return self._CallbackUrl
 
     @CallbackUrl.setter
     def CallbackUrl(self, CallbackUrl):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         self._CallbackUrl = CallbackUrl
 
     @property
@@ -2997,12 +3001,7 @@ class ChannelCreateFlowByFilesRequest(AbstractModel):
         :param _Deadline: 合同流程的签署截止时间，格式为Unix标准时间戳（秒），如果未设置签署截止时间，则默认为合同流程创建后的365天时截止。
 如果在签署截止时间前未完成签署，则合同状态会变为已过期，导致合同作废。
         :type Deadline: int
-        :param _CallbackUrl: 执行结果的回调URL，长度不超过255个字符，该URL仅支持HTTP或HTTPS协议，建议采用HTTPS协议以保证数据传输的安全性。
-腾讯电子签服务器将通过POST方式，application/json格式通知执行结果，请确保外网可以正常访问该URL。
-回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_data_types" target="_blank">回调通知</a>模块。
-
-注:
-`如果不传递回调地址， 则默认是配置应用号时候使用的回调地址`
+        :param _CallbackUrl: 该字段已废弃，请使用【应用号配置】中的回调地址
         :type CallbackUrl: str
         :param _Unordered: 合同流程的签署顺序类型：
 <ul><li> **false**：(默认)有序签署, 本合同多个参与人需要依次签署 </li>
@@ -3140,10 +3139,14 @@ MobileCheck：手机号验证，用户手机号和参与方手机号（ApproverM
 
     @property
     def CallbackUrl(self):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         return self._CallbackUrl
 
     @CallbackUrl.setter
     def CallbackUrl(self, CallbackUrl):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         self._CallbackUrl = CallbackUrl
 
     @property
@@ -3960,7 +3963,9 @@ class ChannelCreateFlowSignUrlRequest(AbstractModel):
 建议开发者妥善保存此流程ID，以便于顺利进行后续操作。
 可登录腾讯电子签控制台，在 "合同"->"合同中心" 中查看某个合同的FlowId(在页面中展示为合同ID)。
         :type FlowId: str
-        :param _FlowApproverInfos: 流程签署人列表，其中结构体的Name，Mobile和ApproverType必传，企业签署人则还需传OrganizationName、OpenId、OrganizationOpenId，其他可不传。
+        :param _FlowApproverInfos: 流程签署人列表，其中结构体的ApproverType必传。
+若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。
+若为子客企业签署方则需传OpenId、OrganizationOpenId，其他可不传。
 
 注:
 `1. 签署人只能有手写签名、时间类型、印章类型的签署控件和内容填写控件，其他类型的签署控件暂时未支持。`
@@ -7592,10 +7597,10 @@ class ChannelDescribeUserAutoSignStatusResponse(AbstractModel):
 
 值为unix时间戳,单位为秒。
         :type LicenseTo: int
-        :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
-
-<ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li></ul>
+        :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。<ul><li>**0**: 使用个人自动签账号许可进行开通，个人自动签账号许可有效期1年，注: `不可解绑释放更换他人`</li><li>**1**: 不绑定自动签账号许可开通，后续使用合同份额进行合同发起</li></ul>
         :type LicenseType: int
+        :param _SealId: 用户开通自动签指定使用的印章，为空则未设置印章，需重新进入开通链接设置印章。
+        :type SealId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
@@ -7603,6 +7608,7 @@ class ChannelDescribeUserAutoSignStatusResponse(AbstractModel):
         self._LicenseFrom = None
         self._LicenseTo = None
         self._LicenseType = None
+        self._SealId = None
         self._RequestId = None
 
     @property
@@ -7637,6 +7643,14 @@ class ChannelDescribeUserAutoSignStatusResponse(AbstractModel):
     def LicenseType(self, LicenseType):
         self._LicenseType = LicenseType
 
+    @property
+    def SealId(self):
+        return self._SealId
+
+    @SealId.setter
+    def SealId(self, SealId):
+        self._SealId = SealId
+
     @property
     def RequestId(self):
         return self._RequestId
@@ -7651,6 +7665,7 @@ class ChannelDescribeUserAutoSignStatusResponse(AbstractModel):
         self._LicenseFrom = params.get("LicenseFrom")
         self._LicenseTo = params.get("LicenseTo")
         self._LicenseType = params.get("LicenseType")
+        self._SealId = params.get("SealId")
         self._RequestId = params.get("RequestId")
 
 
@@ -9618,6 +9633,140 @@ class ComponentLimit(AbstractModel):
         
 
 
+class CreateBatchInitOrganizationUrlRequest(AbstractModel):
+    """CreateBatchInitOrganizationUrl请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Agent: 应用相关信息。 此接口Agent.AppId 必填。
+        :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
+        :param _OperateTypes: 初始化操作类型
+<ul><li>CREATE_SEAL : 创建印章</li>
+<li>OPEN_AUTO_SIGN :开通企业自动签署</li></ul>
+        :type OperateTypes: list of str
+        :param _ProxyOrganizationOpenIds: 批量操作的企业列表在第三方平台的企业Id列表，即ProxyOrganizationOpenId列表,最大支持50个
+        :type ProxyOrganizationOpenIds: list of str
+        """
+        self._Agent = None
+        self._OperateTypes = None
+        self._ProxyOrganizationOpenIds = None
+
+    @property
+    def Agent(self):
+        return self._Agent
+
+    @Agent.setter
+    def Agent(self, Agent):
+        self._Agent = Agent
+
+    @property
+    def OperateTypes(self):
+        return self._OperateTypes
+
+    @OperateTypes.setter
+    def OperateTypes(self, OperateTypes):
+        self._OperateTypes = OperateTypes
+
+    @property
+    def ProxyOrganizationOpenIds(self):
+        return self._ProxyOrganizationOpenIds
+
+    @ProxyOrganizationOpenIds.setter
+    def ProxyOrganizationOpenIds(self, ProxyOrganizationOpenIds):
+        self._ProxyOrganizationOpenIds = ProxyOrganizationOpenIds
+
+
+    def _deserialize(self, params):
+        if params.get("Agent") is not None:
+            self._Agent = Agent()
+            self._Agent._deserialize(params.get("Agent"))
+        self._OperateTypes = params.get("OperateTypes")
+        self._ProxyOrganizationOpenIds = params.get("ProxyOrganizationOpenIds")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class CreateBatchInitOrganizationUrlResponse(AbstractModel):
+    """CreateBatchInitOrganizationUrl返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _MiniAppPath: 小程序路径
+        :type MiniAppPath: str
+        :param _OperateLongUrl: 操作长链
+        :type OperateLongUrl: str
+        :param _OperateShortUrl: 操作短链
+        :type OperateShortUrl: str
+        :param _QRCodeUrl: 操作二维码
+        :type QRCodeUrl: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._MiniAppPath = None
+        self._OperateLongUrl = None
+        self._OperateShortUrl = None
+        self._QRCodeUrl = None
+        self._RequestId = None
+
+    @property
+    def MiniAppPath(self):
+        return self._MiniAppPath
+
+    @MiniAppPath.setter
+    def MiniAppPath(self, MiniAppPath):
+        self._MiniAppPath = MiniAppPath
+
+    @property
+    def OperateLongUrl(self):
+        return self._OperateLongUrl
+
+    @OperateLongUrl.setter
+    def OperateLongUrl(self, OperateLongUrl):
+        self._OperateLongUrl = OperateLongUrl
+
+    @property
+    def OperateShortUrl(self):
+        return self._OperateShortUrl
+
+    @OperateShortUrl.setter
+    def OperateShortUrl(self, OperateShortUrl):
+        self._OperateShortUrl = OperateShortUrl
+
+    @property
+    def QRCodeUrl(self):
+        return self._QRCodeUrl
+
+    @QRCodeUrl.setter
+    def QRCodeUrl(self, QRCodeUrl):
+        self._QRCodeUrl = QRCodeUrl
+
+    @property
+    def RequestId(self):
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._MiniAppPath = params.get("MiniAppPath")
+        self._OperateLongUrl = params.get("OperateLongUrl")
+        self._OperateShortUrl = params.get("OperateShortUrl")
+        self._QRCodeUrl = params.get("QRCodeUrl")
+        self._RequestId = params.get("RequestId")
+
+
 class CreateBatchOrganizationRegistrationTasksRequest(AbstractModel):
     """CreateBatchOrganizationRegistrationTasks请求参数结构体
 
@@ -15358,7 +15507,7 @@ class FlowFileInfo(AbstractModel):
         :type FlowDescription: str
         :param _FlowType: 签署流程的类型，长度不超过255个字符
         :type FlowType: str
-        :param _CallbackUrl: 签署流程回调地址，长度不超过255个字符
+        :param _CallbackUrl: 已废弃，请使用【应用号配置】中的回调地址统一接收消息
         :type CallbackUrl: str
         :param _CustomerData: 第三方应用的业务信息，最大长度1000个字符。发起自动签署时，需设置对应自动签署场景，目前仅支持场景：处方单-E_PRESCRIPTION_AUTO_SIGN
         :type CustomerData: str
@@ -15434,10 +15583,14 @@ class FlowFileInfo(AbstractModel):
 
     @property
     def CallbackUrl(self):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         return self._CallbackUrl
 
     @CallbackUrl.setter
     def CallbackUrl(self, CallbackUrl):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         self._CallbackUrl = CallbackUrl
 
     @property
@@ -15733,10 +15886,7 @@ class FlowInfo(AbstractModel):
 注：只有在控制台编辑模板时，<font color="red">归属给发起方</font>的填写控件（如下图）才能在创建文档的时候进行内容填充。(<font color="red">白名单功能需要联系对接经理开通，否则模板编辑时无法将填写控件分配给发起方</font>)。
 ![image](https://qcloudimg.tencent-cloud.cn/raw/b1d3978140ee2b44e2c9fdc96e467a5d.png)
         :type FormFields: list of FormField
-        :param _CallbackUrl: 合同状态变动结的通知回调URL，该URL仅支持HTTP或HTTPS协议，建议采用HTTPS协议以保证数据传输的安全性，最大长度1000个字符。
-
-腾讯电子签服务器将通过POST方式，application/json格式通知执行结果，请确保外网可以正常访问该URL。
-回调的相关说明可参考开发者中心的<a href="https://qian.tencent.com/developers/partner/callback_data_types" target="_blank">回调通知</a>模块
+        :param _CallbackUrl: 该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息
         :type CallbackUrl: str
         :param _FlowType: 合同流程的类别分类（可自定义名称，如销售合同/入职合同等），最大长度为200个字符，仅限中文、字母、数字和下划线组成。
         :type FlowType: str
@@ -15839,10 +15989,14 @@ class FlowInfo(AbstractModel):
 
     @property
     def CallbackUrl(self):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         return self._CallbackUrl
 
     @CallbackUrl.setter
     def CallbackUrl(self, CallbackUrl):
+        warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
+
         self._CallbackUrl = CallbackUrl
 
     @property
@@ -18478,6 +18632,11 @@ false-否
 <li> 5 :设备指纹识别</li>
 <li> 6 :设备面容识别</li></ul>
         :type ApproverSignTypes: list of int
+        :param _NoTransfer: 签署方是否可以转他人处理
+
+<ul><li> **false** : ( 默认)可以转他人处理</li>
+<li> **true** :不可以转他人处理</li></ul>
+        :type NoTransfer: bool
         """
         self._RecipientId = None
         self._RecipientType = None
@@ -18490,6 +18649,7 @@ false-否
         self._IsPromoter = None
         self._ApproverVerifyTypes = None
         self._ApproverSignTypes = None
+        self._NoTransfer = None
 
     @property
     def RecipientId(self):
@@ -18579,6 +18739,14 @@ false-否
     def ApproverSignTypes(self, ApproverSignTypes):
         self._ApproverSignTypes = ApproverSignTypes
 
+    @property
+    def NoTransfer(self):
+        return self._NoTransfer
+
+    @NoTransfer.setter
+    def NoTransfer(self, NoTransfer):
+        self._NoTransfer = NoTransfer
+
 
     def _deserialize(self, params):
         self._RecipientId = params.get("RecipientId")
@@ -18592,6 +18760,7 @@ false-否
         self._IsPromoter = params.get("IsPromoter")
         self._ApproverVerifyTypes = params.get("ApproverVerifyTypes")
         self._ApproverSignTypes = params.get("ApproverSignTypes")
+        self._NoTransfer = params.get("NoTransfer")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

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/facefusion/v20220927/errorcodes.py

@@ -17,6 +17,9 @@
 # 操作失败。
 FAILEDOPERATION = 'FailedOperation'
 
+# 余额不足，开通失败，请充值后再开通。
+FAILEDOPERATION_BALANCEINSUFFICIENT = 'FailedOperation.BalanceInsufficient'
+
 # 人脸配准点出框错误码。
 FAILEDOPERATION_FACEBORDERCHECKFAILED = 'FailedOperation.FaceBorderCheckFailed'
 
@@ -59,15 +62,9 @@ FAILEDOPERATION_IMAGEDECODEFAILED = 'FailedOperation.ImageDecodeFailed'
 # 图片下载失败。
 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'
 
@@ -134,6 +131,15 @@ INVALIDPARAMETERVALUE_NOFACEINPHOTO = 'InvalidParameterValue.NoFaceInPhoto'
 # 参数字段或者值有误。
 INVALIDPARAMETERVALUE_PARAMETERVALUEERROR = 'InvalidParameterValue.ParameterValueError'
 
+# URL格式不合法。
+INVALIDPARAMETERVALUE_URLILLEGAL = 'InvalidParameterValue.UrlIllegal'
+
+# 请求的次数超过了频率限制。
+REQUESTLIMITEXCEEDED = 'RequestLimitExceeded'
+
+# 资源不足。
+RESOURCEINSUFFICIENT = 'ResourceInsufficient'
+
 # 资源不存在。
 RESOURCENOTFOUND = 'ResourceNotFound'
 
@@ -149,6 +155,9 @@ RESOURCEUNAVAILABLE_GETAUTHINFOERROR = 'ResourceUnavailable.GetAuthInfoError'
 # 账号已欠费。
 RESOURCEUNAVAILABLE_INARREARS = 'ResourceUnavailable.InArrears'
 
+# 服务正在开通中，请稍等。
+RESOURCEUNAVAILABLE_ISOPENING = 'ResourceUnavailable.IsOpening'
+
 # 余额不足。
 RESOURCEUNAVAILABLE_LOWBALANCE = 'ResourceUnavailable.LowBalance'
 

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,7 @@ class ImageCodecParam(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _MetaData: 元数据
+        :param _MetaData: 元数据，个数不能大于1。
         :type MetaData: list of MetaData
         """
         self._MetaData = None
@@ -817,11 +826,15 @@ class LogoParam(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _LogoRect: 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配
+        :param _LogoRect: 标识图片位于融合结果图中的坐标，将按照坐标对标识图片进行位置和大小的拉伸匹配。
         :type LogoRect: :class:`tencentcloud.facefusion.v20220927.models.FaceRect`
-        :param _LogoUrl: 标识图片Url地址
+        :param _LogoUrl: 标识图片Url地址。
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●支持图片格式：支持jpg或png。
         :type LogoUrl: str
         :param _LogoImage: 标识图片base64
+●base64 和 url 必须提供一个，如果都提供以 url 为准。
+●支持图片格式：支持jpg或png。
         :type LogoImage: str
         """
         self._LogoRect = None
@@ -923,15 +936,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

tencentcloud/faceid/v20180301/faceid_client.py

@@ -211,7 +211,7 @@ class FaceidClient(AbstractClient):
 
 
     def DetectAIFakeFaces(self, request):
-        """提供对人脸图片/视频的AI合成、翻拍、水印等攻击痕迹的检测，增强图片/视频防伪能力
+        """基于多模态的AI大模型算法，提供对人脸图片、视频的防攻击检测能力，可针对性有效识别高仿真的AIGC换脸、高清翻拍、批量黑产攻击、水印等攻击痕迹，增强对图片和视频的防伪安全能力。
 
         :param request: Request instance for DetectAIFakeFaces.
         :type request: :class:`tencentcloud.faceid.v20180301.models.DetectAIFakeFacesRequest`