tencentcloud-sdk-python 3.0.1491__py2.py3-none-any.whl → 3.1.6__py2.py3-none-any.whl

tencentcloud/faceid/v20180301/models.py

@@ -1911,13 +1911,15 @@ Base64编码后的大小建议在8M以内、最大不可超过10M，支持mp4、
 视频分辨率建议为480x640（最大支持720p），帧率在25fps~30fps之间。
 请使用标准的Base64编码方式(带=补位)，编码规范参考RFC4648。
 
-示例值：/9j/4AAQSkZJRg.....s97n//2Q==
+若您未使用Encryption进行加密传输，则本字段为必填参数。
         :type FaceInput: str
         :param _FaceInputType: 传入的类型。
 - 取值范围：
 1：传入的是图片类型。
 2：传入的是视频类型。
 其他：返回错误码InvalidParameter。
+
+若您未使用Encryption进行加密传输，则本字段为必填参数。
         :type FaceInputType: int
         :param _Encryption: 是否需要对请求信息进行全包体加密。
 - 支持的加密算法:AES-256-CBC、SM4-GCM。
@@ -1947,7 +1949,7 @@ Base64编码后的大小建议在8M以内、最大不可超过10M，支持mp4、
 视频分辨率建议为480x640（最大支持720p），帧率在25fps~30fps之间。
 请使用标准的Base64编码方式(带=补位)，编码规范参考RFC4648。
 
-示例值：/9j/4AAQSkZJRg.....s97n//2Q==
+若您未使用Encryption进行加密传输，则本字段为必填参数。
         :rtype: str
         """
         return self._FaceInput
@@ -1963,6 +1965,8 @@ Base64编码后的大小建议在8M以内、最大不可超过10M，支持mp4、
 1：传入的是图片类型。
 2：传入的是视频类型。
 其他：返回错误码InvalidParameter。
+
+若您未使用Encryption进行加密传输，则本字段为必填参数。
         :rtype: int
         """
         return self._FaceInputType
@@ -3010,7 +3014,7 @@ class DetectInfoText(AbstractModel):
         :type Comparemsg: str
         :param _Sim: 本次流程活体一比一的分数。
 - 取值范围 [0.00, 100.00]。
-- 相似度大于等于70时才判断为同一人，也可根据具体场景自行调整阈值。
+- 相似度大于等于70时才判断为同一人，阈值不支持自定义。
 - 阈值70的误通过率为千分之一，阈值80的误通过率是万分之一。
 注意：此字段可能返回 null，表示取不到有效值。
         :type Sim: str
@@ -3074,6 +3078,17 @@ class DetectInfoText(AbstractModel):
         :param _VisaNum: 港澳台居住证签发次数。
 注意：此字段可能返回 null，表示取不到有效值。
         :type VisaNum: str
+        :param _LivenessActionSequence: 活体检测的动作顺序，多动作以“,”分隔。
+输出格式如：“1,2”表示“张嘴+眨眼”。
+- 详细序列值含义如下： 
+   1：张嘴
+2：眨眼
+3：点头
+4：摇头
+5：静默
+注：仅浮层H5产品返回
+注意：此字段可能返回 null，表示取不到有效值。
+        :type LivenessActionSequence: str
         """
         self._ErrCode = None
         self._ErrMsg = None
@@ -3105,6 +3120,7 @@ class DetectInfoText(AbstractModel):
         self._NFCBillingCounts = None
         self._PassNo = None
         self._VisaNum = None
+        self._LivenessActionSequence = None
 
     @property
     def ErrCode(self):
@@ -3340,7 +3356,7 @@ class DetectInfoText(AbstractModel):
     def Sim(self):
         r"""本次流程活体一比一的分数。
 - 取值范围 [0.00, 100.00]。
-- 相似度大于等于70时才判断为同一人，也可根据具体场景自行调整阈值。
+- 相似度大于等于70时才判断为同一人，阈值不支持自定义。
 - 阈值70的误通过率为千分之一，阈值80的误通过率是万分之一。
 注意：此字段可能返回 null，表示取不到有效值。
         :rtype: str
@@ -3510,6 +3526,26 @@ class DetectInfoText(AbstractModel):
     def VisaNum(self, VisaNum):
         self._VisaNum = VisaNum
 
+    @property
+    def LivenessActionSequence(self):
+        r"""活体检测的动作顺序，多动作以“,”分隔。
+输出格式如：“1,2”表示“张嘴+眨眼”。
+- 详细序列值含义如下： 
+   1：张嘴
+2：眨眼
+3：点头
+4：摇头
+5：静默
+注：仅浮层H5产品返回
+注意：此字段可能返回 null，表示取不到有效值。
+        :rtype: str
+        """
+        return self._LivenessActionSequence
+
+    @LivenessActionSequence.setter
+    def LivenessActionSequence(self, LivenessActionSequence):
+        self._LivenessActionSequence = LivenessActionSequence
+
 
     def _deserialize(self, params):
         self._ErrCode = params.get("ErrCode")
@@ -3547,6 +3583,7 @@ class DetectInfoText(AbstractModel):
         self._NFCBillingCounts = params.get("NFCBillingCounts")
         self._PassNo = params.get("PassNo")
         self._VisaNum = params.get("VisaNum")
+        self._LivenessActionSequence = params.get("LivenessActionSequence")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -7616,14 +7653,14 @@ class IntentionActionConfig(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Text: 点头确认模式下，系统语音播报使用的问题文本，问题最大长度为150个字符。
+        :param _Text: 点头确认模式下，系统语音播报使用的问题文本，问题最大长度为250个字符。
         :type Text: str
         """
         self._Text = None
 
     @property
     def Text(self):
-        r"""点头确认模式下，系统语音播报使用的问题文本，问题最大长度为150个字符。
+        r"""点头确认模式下，系统语音播报使用的问题文本，问题最大长度为250个字符。
         :rtype: str
         """
         return self._Text
@@ -7827,7 +7864,7 @@ class IntentionQuestion(AbstractModel):
     def __init__(self):
         r"""
         :param _Question: 当选择语音问答模式时，系统自动播报的问题文本。
-- 最大长度为150个字符。
+- 最大长度为250个字符。
         :type Question: str
         :param _Answers: 当选择语音问答模式时，用于判断用户回答是否通过的标准答案列表。
 - 传入后可自动判断用户回答文本是否在标准文本列表中。
@@ -7840,7 +7877,7 @@ class IntentionQuestion(AbstractModel):
     @property
     def Question(self):
         r"""当选择语音问答模式时，系统自动播报的问题文本。
-- 最大长度为150个字符。
+- 最大长度为250个字符。
         :rtype: str
         """
         return self._Question
@@ -8832,193 +8869,6 @@ class LivenessRecognitionResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
-class LivenessRequest(AbstractModel):
-    r"""Liveness请求参数结构体
-
-    """
-
-    def __init__(self):
-        r"""
-        :param _VideoBase64: 用于活体检测的视频，视频的BASE64值；
-BASE64编码后的大小不超过8M，支持mp4、avi、flv格式。
-        :type VideoBase64: str
-        :param _LivenessType: 活体检测类型，取值：LIP/ACTION/SILENT。
-LIP为数字模式，ACTION为动作模式，SILENT为静默模式，三种模式选择一种传入。
-        :type LivenessType: str
-        :param _ValidateData: 数字模式传参：数字验证码(1234)，需先调用接口获取数字验证码；
-动作模式传参：传动作顺序(2,1 or 1,2)，需先调用接口获取动作顺序；
-静默模式传参：不需要传递此参数。
-        :type ValidateData: str
-        :param _Optional: 额外配置，传入JSON字符串。
-{
-"BestFrameNum": 2  //需要返回多张最佳截图，取值范围1-10
-}
-        :type Optional: str
-        """
-        self._VideoBase64 = None
-        self._LivenessType = None
-        self._ValidateData = None
-        self._Optional = None
-
-    @property
-    def VideoBase64(self):
-        r"""用于活体检测的视频，视频的BASE64值；
-BASE64编码后的大小不超过8M，支持mp4、avi、flv格式。
-        :rtype: str
-        """
-        return self._VideoBase64
-
-    @VideoBase64.setter
-    def VideoBase64(self, VideoBase64):
-        self._VideoBase64 = VideoBase64
-
-    @property
-    def LivenessType(self):
-        r"""活体检测类型，取值：LIP/ACTION/SILENT。
-LIP为数字模式，ACTION为动作模式，SILENT为静默模式，三种模式选择一种传入。
-        :rtype: str
-        """
-        return self._LivenessType
-
-    @LivenessType.setter
-    def LivenessType(self, LivenessType):
-        self._LivenessType = LivenessType
-
-    @property
-    def ValidateData(self):
-        r"""数字模式传参：数字验证码(1234)，需先调用接口获取数字验证码；
-动作模式传参：传动作顺序(2,1 or 1,2)，需先调用接口获取动作顺序；
-静默模式传参：不需要传递此参数。
-        :rtype: str
-        """
-        return self._ValidateData
-
-    @ValidateData.setter
-    def ValidateData(self, ValidateData):
-        self._ValidateData = ValidateData
-
-    @property
-    def Optional(self):
-        r"""额外配置，传入JSON字符串。
-{
-"BestFrameNum": 2  //需要返回多张最佳截图，取值范围1-10
-}
-        :rtype: str
-        """
-        return self._Optional
-
-    @Optional.setter
-    def Optional(self, Optional):
-        self._Optional = Optional
-
-
-    def _deserialize(self, params):
-        self._VideoBase64 = params.get("VideoBase64")
-        self._LivenessType = params.get("LivenessType")
-        self._ValidateData = params.get("ValidateData")
-        self._Optional = params.get("Optional")
-        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 LivenessResponse(AbstractModel):
-    r"""Liveness返回参数结构体
-
-    """
-
-    def __init__(self):
-        r"""
-        :param _BestFrameBase64: 验证通过后的视频最佳截图照片，照片为BASE64编码后的值，jpg格式。
-注意：此字段可能返回 null，表示取不到有效值。
-        :type BestFrameBase64: str
-        :param _Result: 业务错误码，成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分
-        :type Result: str
-        :param _Description: 业务结果描述。
-        :type Description: str
-        :param _BestFrameList: 最佳最佳截图列表，仅在配置了返回多张最佳截图时有效。
-注意：此字段可能返回 null，表示取不到有效值。
-        :type BestFrameList: list of str
-        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
-        :type RequestId: str
-        """
-        self._BestFrameBase64 = None
-        self._Result = None
-        self._Description = None
-        self._BestFrameList = None
-        self._RequestId = None
-
-    @property
-    def BestFrameBase64(self):
-        r"""验证通过后的视频最佳截图照片，照片为BASE64编码后的值，jpg格式。
-注意：此字段可能返回 null，表示取不到有效值。
-        :rtype: str
-        """
-        return self._BestFrameBase64
-
-    @BestFrameBase64.setter
-    def BestFrameBase64(self, BestFrameBase64):
-        self._BestFrameBase64 = BestFrameBase64
-
-    @property
-    def Result(self):
-        r"""业务错误码，成功情况返回Success, 错误情况请参考下方错误码 列表中FailedOperation部分
-        :rtype: str
-        """
-        return self._Result
-
-    @Result.setter
-    def Result(self, Result):
-        self._Result = Result
-
-    @property
-    def Description(self):
-        r"""业务结果描述。
-        :rtype: str
-        """
-        return self._Description
-
-    @Description.setter
-    def Description(self, Description):
-        self._Description = Description
-
-    @property
-    def BestFrameList(self):
-        r"""最佳最佳截图列表，仅在配置了返回多张最佳截图时有效。
-注意：此字段可能返回 null，表示取不到有效值。
-        :rtype: list of str
-        """
-        return self._BestFrameList
-
-    @BestFrameList.setter
-    def BestFrameList(self, BestFrameList):
-        self._BestFrameList = BestFrameList
-
-    @property
-    def RequestId(self):
-        r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
-        :rtype: str
-        """
-        return self._RequestId
-
-    @RequestId.setter
-    def RequestId(self, RequestId):
-        self._RequestId = RequestId
-
-
-    def _deserialize(self, params):
-        self._BestFrameBase64 = params.get("BestFrameBase64")
-        self._Result = params.get("Result")
-        self._Description = params.get("Description")
-        self._BestFrameList = params.get("BestFrameList")
-        self._RequestId = params.get("RequestId")
-
-
 class MinorsVerificationRequest(AbstractModel):
     r"""MinorsVerification请求参数结构体
 

tencentcloud/fmu/v20191213/fmu_client_async.py

@@ -0,0 +1,161 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. 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.
+
+
+
+from tencentcloud.common.abstract_client_async import AbstractClient
+from tencentcloud.fmu.v20191213 import models
+from typing import Dict
+
+
+class FmuClient(AbstractClient):
+    _apiVersion = '2019-12-13'
+    _endpoint = 'fmu.tencentcloudapi.com'
+    _service = 'fmu'
+
+    async def BeautifyPic(
+            self,
+            request: models.BeautifyPicRequest,
+            opts: Dict = None,
+    ) -> models.BeautifyPicResponse:
+        """
+        用户上传一张人脸图片（最多能处理一张图片中最大的五张人脸信息），精准定位五官，实现美肤、亮肤、祛痘等美颜功能。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "BeautifyPic"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.BeautifyPicResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def CreateModel(
+            self,
+            request: models.CreateModelRequest,
+            opts: Dict = None,
+    ) -> models.CreateModelResponse:
+        """
+        在使用LUT素材的modelid实现试唇色前，您需要先上传 LUT 格式的cube文件注册唇色ID。查看 [LUT文件的使用说明](https://cloud.tencent.com/document/product/1172/41701)。
+
+        注：您也可以直接使用 [试唇色接口](https://cloud.tencent.com/document/product/1172/40706)，通过输入RGBA模型数值的方式指定唇色，更简单易用。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateModel"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateModelResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DeleteModel(
+            self,
+            request: models.DeleteModelRequest,
+            opts: Dict = None,
+    ) -> models.DeleteModelResponse:
+        """
+        删除已注册的唇色素材。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DeleteModel"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DeleteModelResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def GetModelList(
+            self,
+            request: models.GetModelListRequest,
+            opts: Dict = None,
+    ) -> models.GetModelListResponse:
+        """
+        查询已注册的唇色素材。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "GetModelList"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.GetModelListResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def StyleImage(
+            self,
+            request: models.StyleImageRequest,
+            opts: Dict = None,
+    ) -> models.StyleImageResponse:
+        """
+        上传一张照片，输出滤镜处理后的图片。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "StyleImage"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.StyleImageResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def StyleImagePro(
+            self,
+            request: models.StyleImageProRequest,
+            opts: Dict = None,
+    ) -> models.StyleImageProResponse:
+        """
+        上传一张照片，输出滤镜处理后的图片。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "StyleImagePro"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.StyleImageProResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def TryLipstickPic(
+            self,
+            request: models.TryLipstickPicRequest,
+            opts: Dict = None,
+    ) -> models.TryLipstickPicResponse:
+        """
+        对图片中的人脸嘴唇进行着色，最多支持同时对一张图中的3张人脸进行试唇色。
+
+        您可以通过事先注册在腾讯云的唇色素材（LUT文件）改变图片中的人脸唇色，也可以输入RGBA模型数值。
+
+        为了更好的效果，建议您使用事先注册在腾讯云的唇色素材（LUT文件）。
+
+        >
+        - 公共参数中的签名方式请使用V3版本，即配置SignatureMethod参数为TC3-HMAC-SHA256。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "TryLipstickPic"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.TryLipstickPicResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud/ft/v20200304/ft_client_async.py

@@ -0,0 +1,134 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. 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.
+
+
+
+from tencentcloud.common.abstract_client_async import AbstractClient
+from tencentcloud.ft.v20200304 import models
+from typing import Dict
+
+
+class FtClient(AbstractClient):
+    _apiVersion = '2020-03-04'
+    _endpoint = 'ft.tencentcloudapi.com'
+    _service = 'ft'
+
+    async def CancelFaceMorphJob(
+            self,
+            request: models.CancelFaceMorphJobRequest,
+            opts: Dict = None,
+    ) -> models.CancelFaceMorphJobResponse:
+        """
+        撤销人像渐变任务请求
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CancelFaceMorphJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CancelFaceMorphJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ChangeAgePic(
+            self,
+            request: models.ChangeAgePicRequest,
+            opts: Dict = None,
+    ) -> models.ChangeAgePicResponse:
+        """
+        用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸变老或变年轻的图片，支持实现人脸不同年龄的变化。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ChangeAgePic"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ChangeAgePicResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def FaceCartoonPic(
+            self,
+            request: models.FaceCartoonPicRequest,
+            opts: Dict = None,
+    ) -> models.FaceCartoonPicResponse:
+        """
+        输入一张人脸照片，生成个性化的二次元动漫形象，可用于打造个性头像、趣味活动、特效类应用等场景，提升社交娱乐的体验。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "FaceCartoonPic"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.FaceCartoonPicResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def MorphFace(
+            self,
+            request: models.MorphFaceRequest,
+            opts: Dict = None,
+    ) -> models.MorphFaceResponse:
+        """
+        输入2-5张人脸照片，生成一段以人脸为焦点的渐变视频或GIF图，支持自定义图片播放速度、视频每秒传输帧数，可用于短视频、表情包、创意H5等应用场景，丰富静态图片的玩法。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "MorphFace"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.MorphFaceResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def QueryFaceMorphJob(
+            self,
+            request: models.QueryFaceMorphJobRequest,
+            opts: Dict = None,
+    ) -> models.QueryFaceMorphJobResponse:
+        """
+        查询人像渐变处理进度
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "QueryFaceMorphJob"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.QueryFaceMorphJobResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def SwapGenderPic(
+            self,
+            request: models.SwapGenderPicRequest,
+            opts: Dict = None,
+    ) -> models.SwapGenderPicResponse:
+        """
+        用户上传一张人脸图片，基于人脸编辑与生成算法，输出一张人脸性别转换的图片。男变女可实现美颜、淡妆、加刘海和长发的效果；女变男可实现加胡须、变短发的效果。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "SwapGenderPic"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.SwapGenderPicResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)