tencentcloud-sdk-python 3.0.1375__py2.py3-none-any.whl → 3.0.1377__py2.py3-none-any.whl

tencentcloud/hunyuan/v20230901/hunyuan_client.py

@@ -315,6 +315,31 @@ class HunyuanClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def ImageQuestion(self, request):
+        """如需使用OpenAI兼容接口， 请参考文档：[OpenAI 兼容接口](https://cloud.tencent.com/document/product/1729/111007)
+
+        腾讯混元大模型是由腾讯研发的大语言模型，具备强大的中文创作能力，复杂语境下的逻辑推理能力，以及可靠的任务执行能力。本接口支持流式或非流式调用，当使用流式调用时为 SSE 协议。
+
+         1. 本接口暂不支持返回图片内容。
+         2. 默认该接口下单账号限制并发数为  5 路，如您有提高并发限制的需求请 [购买](https://buy.cloud.tencent.com/hunyuan) 。
+         3. 请使用 SDK 调用本接口，每种开发语言的 SDK Git 仓库 examples/hunyuan/v20230901/ 目录下有提供示例供参考。SDK 链接在文档下方 “**开发者资源 - SDK**” 部分提供。
+         4. 我们推荐您使用 API Explorer，方便快速地在线调试接口和下载各语言的示例代码，[点击打开](https://console.cloud.tencent.com/api/explorer?Product=hunyuan&Version=2023-09-01&Action=ChatCompletions)。
+
+        :param request: Request instance for ImageQuestion.
+        :type request: :class:`tencentcloud.hunyuan.v20230901.models.ImageQuestionRequest`
+        :rtype: :class:`tencentcloud.hunyuan.v20230901.models.ImageQuestionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            return self._call_and_deserialize("ImageQuestion", params, models.ImageQuestionResponse, headers=request.headers)
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def QueryHunyuanImageChatJob(self, request):
         """混元生图（多轮对话）接口基于混元大模型，将根据输入的文本描述生成图像，支持通过多轮对话的方式不断调整图像内容。分为提交任务和查询任务2个接口。
         提交任务：输入文本和前置对话 ID 等，提交一个混元生图多轮对话异步任务，获得任务 ID。

tencentcloud/hunyuan/v20230901/models.py

@@ -1391,10 +1391,13 @@ class Delta(AbstractModel):
 
 注意：此字段可能返回 null，表示取不到有效值。
         :type ToolCalls: list of ToolCall
+        :param _ReasoningContent: 思维链内容。用于展示模型思考过程，仅 Hunyuan-T1 系列模型可用。注意：在进行多轮对话时，请不要将此字段拼接到 messages 中。请求 messages 的请求参数中包含 reasoning_content，接口将报错。
+        :type ReasoningContent: str
         """
         self._Role = None
         self._Content = None
         self._ToolCalls = None
+        self._ReasoningContent = None
 
     @property
     def Role(self):
@@ -1433,6 +1436,17 @@ class Delta(AbstractModel):
     def ToolCalls(self, ToolCalls):
         self._ToolCalls = ToolCalls
 
+    @property
+    def ReasoningContent(self):
+        """思维链内容。用于展示模型思考过程，仅 Hunyuan-T1 系列模型可用。注意：在进行多轮对话时，请不要将此字段拼接到 messages 中。请求 messages 的请求参数中包含 reasoning_content，接口将报错。
+        :rtype: str
+        """
+        return self._ReasoningContent
+
+    @ReasoningContent.setter
+    def ReasoningContent(self, ReasoningContent):
+        self._ReasoningContent = ReasoningContent
+
 
     def _deserialize(self, params):
         self._Role = params.get("Role")
@@ -1443,6 +1457,7 @@ class Delta(AbstractModel):
                 obj = ToolCall()
                 obj._deserialize(item)
                 self._ToolCalls.append(obj)
+        self._ReasoningContent = params.get("ReasoningContent")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -1642,7 +1657,7 @@ class File3D(AbstractModel):
         r"""
         :param _Type: 3D文件的格式。取值范围：GIF, OBJ
         :type Type: str
-        :param _Url: 文件的Url
+        :param _Url: 文件的Url（有效期24小时）
         :type Url: str
         """
         self._Type = None
@@ -1661,7 +1676,7 @@ class File3D(AbstractModel):
 
     @property
     def Url(self):
-        """文件的Url
+        """文件的Url（有效期24小时）
         :rtype: str
         """
         return self._Url
@@ -3726,6 +3741,301 @@ class Image(AbstractModel):
         
 
 
+class ImageMessage(AbstractModel):
+    """拍照解题内容
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Role: 角色，可选值包括 system、user、assistant。
+        :type Role: str
+        :param _Content: 文本内容
+        :type Content: str
+        :param _Contents: 多种类型内容（目前支持图片和文本），仅 hunyuan-vision 和 hunyuan-turbo-vision 模型支持
+        :type Contents: list of Content
+        """
+        self._Role = None
+        self._Content = None
+        self._Contents = None
+
+    @property
+    def Role(self):
+        """角色，可选值包括 system、user、assistant。
+        :rtype: str
+        """
+        return self._Role
+
+    @Role.setter
+    def Role(self, Role):
+        self._Role = Role
+
+    @property
+    def Content(self):
+        """文本内容
+        :rtype: str
+        """
+        return self._Content
+
+    @Content.setter
+    def Content(self, Content):
+        self._Content = Content
+
+    @property
+    def Contents(self):
+        """多种类型内容（目前支持图片和文本），仅 hunyuan-vision 和 hunyuan-turbo-vision 模型支持
+        :rtype: list of Content
+        """
+        return self._Contents
+
+    @Contents.setter
+    def Contents(self, Contents):
+        self._Contents = Contents
+
+
+    def _deserialize(self, params):
+        self._Role = params.get("Role")
+        self._Content = params.get("Content")
+        if params.get("Contents") is not None:
+            self._Contents = []
+            for item in params.get("Contents"):
+                obj = Content()
+                obj._deserialize(item)
+                self._Contents.append(obj)
+        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 ImageQuestionRequest(AbstractModel):
+    """ImageQuestion请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Model: 模型名称，可选值包括 hunyuan-vision-image-question。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。
+        :type Model: str
+        :param _Messages: 聊天上下文信息。说明：1. 长度最多为 40，按对话时间从旧到新在数组中排列。2. Message.Role 可选值：system、user、assistant。其中，system 角色可选，如存在则必须位于列表的最开始。user 和 assistant 需交替出现（一问一答），以 user 提问开始，user提问结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。3. Messages 中 Content 总长度不能超过模型输入长度上限（可参考 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 文档），超过则会截断最前面的内容，只保留尾部内容。
+        :type Messages: list of ImageMessage
+        :param _Stream: 流式调用开关。
+说明：
+1. 未传值时默认为非流式调用（false）。
+2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。
+3. 非流式调用时：
+调用方式与普通 HTTP 请求无异。
+接口响应耗时较长，**如需更低时延建议设置为 true**。
+只返回一次最终结果（返回值取 Choices[n].Message 中的值）。
+
+注意：
+通过 SDK 调用时，流式和非流式调用需用**不同的方式**获取返回值，具体参考 SDK 中的注释或示例（在各语言 SDK 代码仓库的 examples/hunyuan/v20230901/ 目录中）。
+        :type Stream: bool
+        """
+        self._Model = None
+        self._Messages = None
+        self._Stream = None
+
+    @property
+    def Model(self):
+        """模型名称，可选值包括 hunyuan-vision-image-question。各模型介绍请阅读 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 中的说明。注意：不同的模型计费不同，请根据 [购买指南](https://cloud.tencent.com/document/product/1729/97731) 按需调用。
+        :rtype: str
+        """
+        return self._Model
+
+    @Model.setter
+    def Model(self, Model):
+        self._Model = Model
+
+    @property
+    def Messages(self):
+        """聊天上下文信息。说明：1. 长度最多为 40，按对话时间从旧到新在数组中排列。2. Message.Role 可选值：system、user、assistant。其中，system 角色可选，如存在则必须位于列表的最开始。user 和 assistant 需交替出现（一问一答），以 user 提问开始，user提问结束，且 Content 不能为空。Role 的顺序示例：[system（可选） user assistant user assistant user ...]。3. Messages 中 Content 总长度不能超过模型输入长度上限（可参考 [产品概述](https://cloud.tencent.com/document/product/1729/104753) 文档），超过则会截断最前面的内容，只保留尾部内容。
+        :rtype: list of ImageMessage
+        """
+        return self._Messages
+
+    @Messages.setter
+    def Messages(self, Messages):
+        self._Messages = Messages
+
+    @property
+    def Stream(self):
+        """流式调用开关。
+说明：
+1. 未传值时默认为非流式调用（false）。
+2. 流式调用时以 SSE 协议增量返回结果（返回值取 Choices[n].Delta 中的值，需要拼接增量数据才能获得完整结果）。
+3. 非流式调用时：
+调用方式与普通 HTTP 请求无异。
+接口响应耗时较长，**如需更低时延建议设置为 true**。
+只返回一次最终结果（返回值取 Choices[n].Message 中的值）。
+
+注意：
+通过 SDK 调用时，流式和非流式调用需用**不同的方式**获取返回值，具体参考 SDK 中的注释或示例（在各语言 SDK 代码仓库的 examples/hunyuan/v20230901/ 目录中）。
+        :rtype: bool
+        """
+        return self._Stream
+
+    @Stream.setter
+    def Stream(self, Stream):
+        self._Stream = Stream
+
+
+    def _deserialize(self, params):
+        self._Model = params.get("Model")
+        if params.get("Messages") is not None:
+            self._Messages = []
+            for item in params.get("Messages"):
+                obj = ImageMessage()
+                obj._deserialize(item)
+                self._Messages.append(obj)
+        self._Stream = params.get("Stream")
+        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 ImageQuestionResponse(AbstractModel):
+    """ImageQuestion返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Created: Unix 时间戳，单位为秒。
+        :type Created: int
+        :param _Usage: Token 统计信息。
+按照总 Token 数量计费。
+        :type Usage: :class:`tencentcloud.hunyuan.v20230901.models.Usage`
+        :param _Note: 免责声明。
+        :type Note: str
+        :param _Id: 本次请求的 RequestId。
+        :type Id: str
+        :param _Choices: 回复内容。
+        :type Choices: list of Choice
+        :param _ErrorMsg: 错误信息。
+如果流式返回中服务处理异常，返回该错误信息。
+注意：此字段可能返回 null，表示取不到有效值。
+        :type ErrorMsg: :class:`tencentcloud.hunyuan.v20230901.models.ErrorMsg`
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+        :type RequestId: str
+        """
+        self._Created = None
+        self._Usage = None
+        self._Note = None
+        self._Id = None
+        self._Choices = None
+        self._ErrorMsg = None
+        self._RequestId = None
+
+    @property
+    def Created(self):
+        """Unix 时间戳，单位为秒。
+        :rtype: int
+        """
+        return self._Created
+
+    @Created.setter
+    def Created(self, Created):
+        self._Created = Created
+
+    @property
+    def Usage(self):
+        """Token 统计信息。
+按照总 Token 数量计费。
+        :rtype: :class:`tencentcloud.hunyuan.v20230901.models.Usage`
+        """
+        return self._Usage
+
+    @Usage.setter
+    def Usage(self, Usage):
+        self._Usage = Usage
+
+    @property
+    def Note(self):
+        """免责声明。
+        :rtype: str
+        """
+        return self._Note
+
+    @Note.setter
+    def Note(self, Note):
+        self._Note = Note
+
+    @property
+    def Id(self):
+        """本次请求的 RequestId。
+        :rtype: str
+        """
+        return self._Id
+
+    @Id.setter
+    def Id(self, Id):
+        self._Id = Id
+
+    @property
+    def Choices(self):
+        """回复内容。
+        :rtype: list of Choice
+        """
+        return self._Choices
+
+    @Choices.setter
+    def Choices(self, Choices):
+        self._Choices = Choices
+
+    @property
+    def ErrorMsg(self):
+        """错误信息。
+如果流式返回中服务处理异常，返回该错误信息。
+注意：此字段可能返回 null，表示取不到有效值。
+        :rtype: :class:`tencentcloud.hunyuan.v20230901.models.ErrorMsg`
+        """
+        return self._ErrorMsg
+
+    @ErrorMsg.setter
+    def ErrorMsg(self, ErrorMsg):
+        self._ErrorMsg = ErrorMsg
+
+    @property
+    def RequestId(self):
+        """唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。本接口为流式响应接口，当请求成功时，RequestId 会被放在 HTTP 响应的 Header "X-TC-RequestId" 中。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._Created = params.get("Created")
+        if params.get("Usage") is not None:
+            self._Usage = Usage()
+            self._Usage._deserialize(params.get("Usage"))
+        self._Note = params.get("Note")
+        self._Id = params.get("Id")
+        if params.get("Choices") is not None:
+            self._Choices = []
+            for item in params.get("Choices"):
+                obj = Choice()
+                obj._deserialize(item)
+                self._Choices.append(obj)
+        if params.get("ErrorMsg") is not None:
+            self._ErrorMsg = ErrorMsg()
+            self._ErrorMsg._deserialize(params.get("ErrorMsg"))
+        self._RequestId = params.get("RequestId")
+
+
 class ImageUrl(AbstractModel):
     """具体的图片内容
 
@@ -6130,9 +6440,15 @@ class SubmitHunyuanTo3DJobRequest(AbstractModel):
         r"""
         :param _Prompt: 3D内容的描述，中文正向提示词。最多支持200个 utf-8 字符，ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :type Prompt: str
-        :param _ImageBase64: 输入图 Base64 数据。最多支持200个 utf-8 字符，ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        :param _ImageBase64: 输入图 Base64 数据。
+大小：单边分辨率要求不小于50，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+格式：jpg，png，jpeg，webp。
+ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :type ImageBase64: str
-        :param _ImageUrl: 输入图Url。最多支持200个 utf-8 字符，ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        :param _ImageUrl: 输入图Url。
+大小：单边分辨率要求不小于50，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+格式：jpg，png，jpeg，webp。
+ImageBase64/ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :type ImageUrl: str
         :param _Num: 生成数量。默认1，当前限制只能为1。
         :type Num: int
@@ -6155,7 +6471,10 @@ class SubmitHunyuanTo3DJobRequest(AbstractModel):
 
     @property
     def ImageBase64(self):
-        """输入图 Base64 数据。最多支持200个 utf-8 字符，ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        """输入图 Base64 数据。
+大小：单边分辨率要求不小于50，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+格式：jpg，png，jpeg，webp。
+ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :rtype: str
         """
         return self._ImageBase64
@@ -6166,7 +6485,10 @@ class SubmitHunyuanTo3DJobRequest(AbstractModel):
 
     @property
     def ImageUrl(self):
-        """输入图Url。最多支持200个 utf-8 字符，ImageBase64、ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
+        """输入图Url。
+大小：单边分辨率要求不小于50，不大于5000。大小不超过8m（base64编码后会大30%左右，建议实际输入图片不超过6m）
+格式：jpg，png，jpeg，webp。
+ImageBase64/ImageUrl和 Prompt必填其一，且Prompt和ImageBase64/ImageUrl不能同时存在。
         :rtype: str
         """
         return self._ImageUrl
@@ -6209,7 +6531,7 @@ class SubmitHunyuanTo3DJobResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _JobId: 任务id
+        :param _JobId: 任务id（有效期24小时）
         :type JobId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -6219,7 +6541,7 @@ class SubmitHunyuanTo3DJobResponse(AbstractModel):
 
     @property
     def JobId(self):
-        """任务id
+        """任务id（有效期24小时）
         :rtype: str
         """
         return self._JobId

tencentcloud/iai/v20180301/models.py

@@ -246,28 +246,33 @@ class AnalyzeFaceRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Mode: 检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
+        :param _Mode: 检测模式。
+- 取值范围：0 为检测所有出现的人脸， 1 为检测面积最大的人脸。
+- 默认为 0。
+- 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
         :type Mode: int
-        :param _Image: 图片 base64 数据，base64 编码后大小不可超过5M。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        :param _Image: 图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
         :type Image: str
-        :param _Url: 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        :param _Url: 图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
         :type Url: str
         :param _FaceModelVersion: 人脸识别服务所用的算法模型版本。
-
-目前入参支持 “2.0”和“3.0“ 两个输入。
-
-2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-
-2020年11月26日后开通服务的账号仅支持输入“3.0”。
-
-不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
+- 目前入参支持 “2.0”和“3.0“ 两个输入。
+- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
+- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
+- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
         :type FaceModelVersion: str
-        :param _NeedRotateDetection: 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+        :param _NeedRotateDetection: 是否开启图片旋转识别支持。
+- 取值范围：0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
         :type NeedRotateDetection: int
         """
         self._Mode = None
@@ -278,7 +283,10 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
 
     @property
     def Mode(self):
-        """检测模式。0 为检测所有出现的人脸， 1 为检测面积最大的人脸。默认为 0。最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
+        """检测模式。
+- 取值范围：0 为检测所有出现的人脸， 1 为检测面积最大的人脸。
+- 默认为 0。
+- 最多返回 10 张人脸的五官定位（人脸关键点）具体信息。
         :rtype: int
         """
         return self._Mode
@@ -289,8 +297,9 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
 
     @property
     def Image(self):
-        """图片 base64 数据，base64 编码后大小不可超过5M。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        """图片 base64 数据。
+- base64 编码后大小不可超过5M。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
         :rtype: str
         """
         return self._Image
@@ -301,11 +310,12 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
 
     @property
     def Url(self):
-        """图片的 Url 。对应图片 base64 编码后大小不可超过5M。
-Url、Image必须提供一个，如果都提供，只使用 Url。  
-图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
-非腾讯云存储的Url速度和稳定性可能受一定影响。
-支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
+        """图片的 Url 。
+- 对应图片 base64 编码后大小不可超过5M。
+- Url、Image必须提供一个，如果都提供，只使用 Url。  
+- 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 
+- 非腾讯云存储的Url速度和稳定性可能受一定影响。
+- 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
         :rtype: str
         """
         return self._Url
@@ -317,14 +327,10 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
     @property
     def FaceModelVersion(self):
         """人脸识别服务所用的算法模型版本。
-
-目前入参支持 “2.0”和“3.0“ 两个输入。
-
-2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
-
-2020年11月26日后开通服务的账号仅支持输入“3.0”。
-
-不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
+- 目前入参支持 “2.0”和“3.0“ 两个输入。
+- 2020年4月2日开始，默认为“3.0”，之前使用过本接口的账号若未填写本参数默认为“2.0”。
+- 2020年11月26日后开通服务的账号仅支持输入“3.0”。
+- 不同算法模型版本对应的人脸识别算法不同，新版本的整体效果会优于旧版本，建议使用“3.0”版本。
         :rtype: str
         """
         return self._FaceModelVersion
@@ -335,7 +341,11 @@ Url、Image必须提供一个，如果都提供，只使用 Url。
 
     @property
     def NeedRotateDetection(self):
-        """是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
+        """是否开启图片旋转识别支持。
+- 取值范围：0为不开启，1为开启。
+- 默认为0。
+- 本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。
+- 若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
         :rtype: int
         """
         return self._NeedRotateDetection

tencentcloud/keewidb/v20220308/models.py

@@ -1681,6 +1681,8 @@ class DescribeInstanceBackupsResponse(AbstractModel):
 
     @property
     def BackupSet(self):
+        warnings.warn("parameter `BackupSet` is deprecated", DeprecationWarning) 
+
         """废弃字段。
         :rtype: list of BinlogInfo
         """
@@ -1688,6 +1690,8 @@ class DescribeInstanceBackupsResponse(AbstractModel):
 
     @BackupSet.setter
     def BackupSet(self, BackupSet):
+        warnings.warn("parameter `BackupSet` is deprecated", DeprecationWarning) 
+
         self._BackupSet = BackupSet
 
     @property

tencentcloud/lighthouse/v20200324/models.py

@@ -6587,7 +6587,7 @@ class DescribeFirewallTemplatesRequest(AbstractModel):
 <li>template-type</li>按照【防火墙模板的类型】进行过滤。
 类型：String
 必选：否
-取值: "PRIVATE"(个人模版)
+取值: "PRIVATE"(个人模板)
 每次请求的 Filters 的上限为 10，Filter.Values 的上限为 100。参数不支持同时指定 TemplateIds 和 Filters。
         :type Filters: list of Filter
         :param _Offset: 偏移量，默认为 0。
@@ -6623,7 +6623,7 @@ class DescribeFirewallTemplatesRequest(AbstractModel):
 <li>template-type</li>按照【防火墙模板的类型】进行过滤。
 类型：String
 必选：否
-取值: "PRIVATE"(个人模版)
+取值: "PRIVATE"(个人模板)
 每次请求的 Filters 的上限为 10，Filter.Values 的上限为 100。参数不支持同时指定 TemplateIds 和 Filters。
         :rtype: list of Filter
         """
@@ -11160,7 +11160,7 @@ class FirewallTemplate(AbstractModel):
         :type TemplateId: str
         :param _TemplateName: 模板名称。
         :type TemplateName: str
-        :param _TemplateType: 模板类型。取值: "PRIVATE"(个人模版)
+        :param _TemplateType: 模板类型。取值: "PRIVATE"(个人模板)
         :type TemplateType: str
         :param _TemplateState: 模板状态。取值: "NORMAL"(正常)
         :type TemplateState: str
@@ -11197,7 +11197,7 @@ class FirewallTemplate(AbstractModel):
 
     @property
     def TemplateType(self):
-        """模板类型。取值: "PRIVATE"(个人模版)
+        """模板类型。取值: "PRIVATE"(个人模板)
         :rtype: str
         """
         return self._TemplateType

tencentcloud/mongodb/v20190725/models.py

@@ -9272,6 +9272,8 @@ class ModifyDBInstanceSpecRequest(AbstractModel):
 
     @property
     def OplogSize(self):
+        warnings.warn("parameter `OplogSize` is deprecated", DeprecationWarning) 
+
         """(已废弃) 请使用ResizeOplog独立接口完成。
 
 实例配置变更后 Oplog 的大小。
@@ -9283,6 +9285,8 @@ class ModifyDBInstanceSpecRequest(AbstractModel):
 
     @OplogSize.setter
     def OplogSize(self, OplogSize):
+        warnings.warn("parameter `OplogSize` is deprecated", DeprecationWarning) 
+
         self._OplogSize = OplogSize
 
     @property