支持环境
Python 2.7,3.6至3.9版本。
调用地址:
tms.tencentcloudapi.com
。注意
API 支持就近地域接入,本产品就近地域接入的域名为 tms.tencentcloudapi.com,也支持指定地域域名访问,例如:广州地域的域名为 tms.ap-guangzhou.tencentcloudapi.com。详细请参考 文本内容安全-请求结构。
安装 SDK
方式1:通过 Pip 安装(推荐)
可通过 pip 安装方式将腾讯云 Python SDK 安装至您的项目中,在命令行中执行以下命令,安装 Python SDK。
pip install --upgrade tencentcloud-sdk-python
说明
若您的项目环境未安装 pip,请前往 pip 官网 完成安装。
若同时具备 Python2 及 Python3 环境,则需使用 pip3 命令进行安装。中国大陆地区的用户可以使用国内镜像源提高下载速度,例如:
pip install -i https://mirrors.tencent.com/pypi/simple/ --upgrade tencentcloud-sdk-python
。如果只想使用某个具体产品的包,例如云服务器 CVM,可以单独安装,但是注意不能和总包同时工作。
更多 SDK 支持的云产品,请参见 云产品名列表。
方式2:通过源码包安装
$ cd tencentcloud-sdk-python$ python setup.py install
使用 SDK
引用方法可参考示例,以下为 TextModeration 接口的 demo 示例,其中 region 配置为广州,实际请按需配置。
import jsonfrom tencentcloud.common import credentialfrom tencentcloud.common.profile.client_profile import ClientProfilefrom tencentcloud.common.profile.http_profile import HttpProfilefrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKExceptionfrom tencentcloud.tms.v20201229 import tms_client, modelstry:# 实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密# 代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见:https://cloud.tencent.com/document/product/1278/85305# 密钥可前往官网控制台 https://console.cloud.tencent.com/cam/capi 进行获取cred = credential.Credential("SecretId", "SecretKey")# 实例化一个http选项,可选的,没有特殊需求可以跳过httpProfile = HttpProfile()httpProfile.endpoint = "tms.tencentcloudapi.com"# 实例化一个client选项,可选的,没有特殊需求可以跳过clientProfile = ClientProfile()clientProfile.httpProfile = httpProfile# 实例化要请求产品的client对象,clientProfile是可选的client = tms_client.TmsClient(cred, "", clientProfile)# 实例化一个请求对象,每个接口都会对应一个request对象req = models.TextModerationRequest()params = {}req.from_json_string(json.dumps(params))# 返回的resp是一个TextModerationResponse的实例,与请求对象对应resp = client.TextModeration(req)# 输出json格式的字符串回包print(resp.to_json_string())except TencentCloudSDKException as err:print(err)