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

tencentcloud/igtm/v20231024/models.py

@@ -925,11 +925,25 @@ class CreateInstanceResponse(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _InstanceId: 实例id
+        :type InstanceId: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
+        self._InstanceId = None
         self._RequestId = None
 
+    @property
+    def InstanceId(self):
+        r"""实例id
+        :rtype: str
+        """
+        return self._InstanceId
+
+    @InstanceId.setter
+    def InstanceId(self, InstanceId):
+        self._InstanceId = InstanceId
+
     @property
     def RequestId(self):
         r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
@@ -943,6 +957,7 @@ class CreateInstanceResponse(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._InstanceId = params.get("InstanceId")
         self._RequestId = params.get("RequestId")
 
 
@@ -2261,14 +2276,28 @@ class DescribeDetectTaskPackageListRequest(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _Offset: 偏移量
+        :type Offset: int
         :param _Limit: 每页条数
         :type Limit: int
         :param _Filters: 探测任务过滤条件：ResourceId 探测任务的资源id，PeriodStart 最小过期时间,PeriodEnd 最大过期时间
         :type Filters: list of ResourceFilter
         """
+        self._Offset = None
         self._Limit = None
         self._Filters = None
 
+    @property
+    def Offset(self):
+        r"""偏移量
+        :rtype: int
+        """
+        return self._Offset
+
+    @Offset.setter
+    def Offset(self, Offset):
+        self._Offset = Offset
+
     @property
     def Limit(self):
         r"""每页条数
@@ -2293,6 +2322,7 @@ class DescribeDetectTaskPackageListRequest(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._Offset = params.get("Offset")
         self._Limit = params.get("Limit")
         if params.get("Filters") is not None:
             self._Filters = []
@@ -2516,6 +2546,36 @@ class DescribeInstanceDetailRequest(AbstractModel):
 
     """
 
+    def __init__(self):
+        r"""
+        :param _InstanceId: 实例id
+        :type InstanceId: str
+        """
+        self._InstanceId = None
+
+    @property
+    def InstanceId(self):
+        r"""实例id
+        :rtype: str
+        """
+        return self._InstanceId
+
+    @InstanceId.setter
+    def InstanceId(self, InstanceId):
+        self._InstanceId = InstanceId
+
+
+    def _deserialize(self, params):
+        self._InstanceId = params.get("InstanceId")
+        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 DescribeInstanceDetailResponse(AbstractModel):
     r"""DescribeInstanceDetail返回参数结构体
@@ -2718,6 +2778,8 @@ class DescribeInstancePackageListRequest(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _Offset: 偏移量
+        :type Offset: int
         :param _Limit: 每页条数
         :type Limit: int
         :param _Filters: InstanceId实例Id，InstanceName实例名称，ResourceId套餐Id，PackageType套餐类型 
@@ -2725,10 +2787,22 @@ class DescribeInstancePackageListRequest(AbstractModel):
         :param _IsUsed: 是否使用：0未使用1已使用
         :type IsUsed: int
         """
+        self._Offset = None
         self._Limit = None
         self._Filters = None
         self._IsUsed = None
 
+    @property
+    def Offset(self):
+        r"""偏移量
+        :rtype: int
+        """
+        return self._Offset
+
+    @Offset.setter
+    def Offset(self, Offset):
+        self._Offset = Offset
+
     @property
     def Limit(self):
         r"""每页条数
@@ -2764,6 +2838,7 @@ class DescribeInstancePackageListRequest(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._Offset = params.get("Offset")
         self._Limit = params.get("Limit")
         if params.get("Filters") is not None:
             self._Filters = []
@@ -2937,11 +3012,14 @@ class DescribeMonitorsRequest(AbstractModel):
         :type Offset: int
         :param _Limit: 分页，当前分页记录数
         :type Limit: int
+        :param _Filters: 查询过滤条件：MonitorName：监控器名称；MonitorId：监控器id
+        :type Filters: list of ResourceFilter
         :param _IsDetectNum: 是否查探测次数0否1是
         :type IsDetectNum: int
         """
         self._Offset = None
         self._Limit = None
+        self._Filters = None
         self._IsDetectNum = None
 
     @property
@@ -2966,6 +3044,17 @@ class DescribeMonitorsRequest(AbstractModel):
     def Limit(self, Limit):
         self._Limit = Limit
 
+    @property
+    def Filters(self):
+        r"""查询过滤条件：MonitorName：监控器名称；MonitorId：监控器id
+        :rtype: list of ResourceFilter
+        """
+        return self._Filters
+
+    @Filters.setter
+    def Filters(self, Filters):
+        self._Filters = Filters
+
     @property
     def IsDetectNum(self):
         r"""是否查探测次数0否1是
@@ -2981,6 +3070,12 @@ class DescribeMonitorsRequest(AbstractModel):
     def _deserialize(self, params):
         self._Offset = params.get("Offset")
         self._Limit = params.get("Limit")
+        if params.get("Filters") is not None:
+            self._Filters = []
+            for item in params.get("Filters"):
+                obj = ResourceFilter()
+                obj._deserialize(item)
+                self._Filters.append(obj)
         self._IsDetectNum = params.get("IsDetectNum")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
@@ -5218,11 +5313,25 @@ class ModifyInstanceConfigRequest(AbstractModel):
 
     def __init__(self):
         r"""
+        :param _InstanceId: 实例id	
+        :type InstanceId: str
         :param _InstanceConfig: 实例配置详情
         :type InstanceConfig: :class:`tencentcloud.igtm.v20231024.models.InstanceConfig`
         """
+        self._InstanceId = None
         self._InstanceConfig = None
 
+    @property
+    def InstanceId(self):
+        r"""实例id	
+        :rtype: str
+        """
+        return self._InstanceId
+
+    @InstanceId.setter
+    def InstanceId(self, InstanceId):
+        self._InstanceId = InstanceId
+
     @property
     def InstanceConfig(self):
         r"""实例配置详情
@@ -5236,6 +5345,7 @@ class ModifyInstanceConfigRequest(AbstractModel):
 
 
     def _deserialize(self, params):
+        self._InstanceId = params.get("InstanceId")
         if params.get("InstanceConfig") is not None:
             self._InstanceConfig = InstanceConfig()
             self._InstanceConfig._deserialize(params.get("InstanceConfig"))

tencentcloud/ims/v20200713/ims_client_async.py

@@ -0,0 +1,60 @@
+# -*- 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.ims.v20200713 import models
+from typing import Dict
+
+
+class ImsClient(AbstractClient):
+    _apiVersion = '2020-07-13'
+    _endpoint = 'ims.tencentcloudapi.com'
+    _service = 'ims'
+
+    async def ImageModeration(
+            self,
+            request: models.ImageModerationRequest,
+            opts: Dict = None,
+    ) -> models.ImageModerationResponse:
+        """
+        图片同步检测服务（Image Moderation, IM）能自动扫描图片，识别可能令人反感、不安全或不适宜的内容，同时支持用户配置图片黑名单，打击自定义识别类型的图片。
+
+        <div class="rno-api-explorer" style="margin-bottom:20px">
+            <div class="rno-api-explorer-inner">
+                <div class="rno-api-explorer-hd">
+                    <div class="rno-api-explorer-title">
+                        关于版本迭代的描述
+                    </div>
+                </div>
+                <div class="rno-api-explorer-body">
+                    <div class="rno-api-explorer-cont">
+                        <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
+                        <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ImageModeration"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ImageModerationResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud/ims/v20201229/ims_client_async.py

@@ -0,0 +1,132 @@
+# -*- 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.ims.v20201229 import models
+from typing import Dict
+
+
+class ImsClient(AbstractClient):
+    _apiVersion = '2020-12-29'
+    _endpoint = 'ims.tencentcloudapi.com'
+    _service = 'ims'
+
+    async def CreateImageModerationAsyncTask(
+            self,
+            request: models.CreateImageModerationAsyncTaskRequest,
+            opts: Dict = None,
+    ) -> models.CreateImageModerationAsyncTaskResponse:
+        """
+        本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
+        ### 接口使用说明：
+        - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
+        - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
+
+        ### 接口功能说明：
+        - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
+        - 支持对长图进行拆分检测；
+        - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
+        - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
+        - 支持根据不同的业务场景配置自定义的审核策略；
+        - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
+        - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
+        ### 接口调用说明：
+        - 图片文件大小限制：**Base64编码内容应小于10MB**；**图片资源应小于100MB**
+        - 图片尺寸支持：**长和宽 需>50分辨率且<40000分辨率，并且图片长宽比<90:1；**
+        - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
+        - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
+        - 图片文件链接支持的传输协议：HTTP、HTTPS；
+        - 若传入图片文件的访问链接，则需要注意**图片异步接口下载超时时间为15秒，失败后重试1次为3 秒，共18秒下载时间**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
+        - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
+        - ### 接口回调格式：
+        - 图片异步检测接口回调格式同[图片同步检测接口输出参数](https://cloud.tencent.com/document/product/1125/53273#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0)
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateImageModerationAsyncTask"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateImageModerationAsyncTaskResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ImageModeration(
+            self,
+            request: models.ImageModerationRequest,
+            opts: Dict = None,
+    ) -> models.ImageModerationResponse:
+        """
+        本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms) 并调整好对应的业务配置。
+        ### 接口使用说明：
+        - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**3000张图片**识别额度，有效期为15天。
+        - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
+
+        ### 接口功能说明：
+        - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
+        - 支持对GIF图/长图进行截帧或拆分检测；
+        - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
+        - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
+        - 支持根据不同的业务场景配置自定义的审核策略；
+        - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
+        - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
+
+        ### 接口调用说明：
+        - 文件大小限制：
+            - 文件大小的最小限制为16字节；
+            - Base64编码后的内容（仅限FileContent）应小于10MB；
+            - 通过FileURL可访问的源图大小应小于30MB；
+        - 图片尺寸支持：长和宽需大于50像素且小于10000像素，并且图片长宽比需小于90:1；
+        - 分辨率建议：为保证识别效果，建议图片分辨率大于256x256。
+        - 文件格式支持：
+            - **静态图**：BMP、ICO、JPEG、JNG、PNG、TIFF、RAW、SVG、GIF、WEBP、HEIC、AVIF
+            - **动态图**：GIF、WEBP、HEIC（默认最多抽取5帧图像，每隔5帧进行一次采样）
+        - 传输协议：仅支持HTTP和HTTPS协议的图片链接；
+        - 并发请求与审核：每次仅能传输一条URL进行审核，支持多并发请求，默认并发量为100 QPS。超过此限制将返回`RequestLimitExceeded`错误；
+        - 存储与缓存建议：为了保障图片的稳定性和可靠性，推荐使用腾讯云COS存储或CDN缓存服务存放图片文件。
+
+        ### 图片下载说明：
+        请根据以下规则调整您的图片链接和下载逻辑，以确保最佳的下载体验。
+        - 下载时间限制：图片的首次下载超时时间为3秒；如果首次下载超时，系统将自动重试一次，重试的超时时间同样是3秒；若重试后仍未能成功下载，系统将返回 `ImageDownloadError`（下载超时）；
+        - 网络安全策略：由于网络安全策略的影响，带有HTTP 302重定向状态码的链接可能会导致下载失败。请尽量避免使用此类链接，以确保下载过程顺利进行；对于因重定向或其他原因导致的下载失败，可能返回 `ResourceUnavailable.ImageDownloadError`；
+        - 异步回源支持：目前不支持通过异步回源方式获取图片源。请确保提供的链接为直接指向图片资源的链接，以避免因异步回源不支持而导致的下载失败。
+
+        <div class="rno-api-explorer" style="margin-bottom:20px">
+            <div class="rno-api-explorer-inner">
+                <div class="rno-api-explorer-hd">
+                    <div class="rno-api-explorer-title">
+                        关于版本迭代的描述
+                    </div>
+                </div>
+                <div class="rno-api-explorer-body">
+                    <div class="rno-api-explorer-cont">
+                        <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本</p>
+                        <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级。</p>
+                    </div>
+                </div>
+            </div>
+        </div>
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ImageModeration"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ImageModerationResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)