1 Star 17 Fork 2

tencentcloud/tencentcloud-sdk-python

Create your Gitee Account
Explore and code with more than 12 million developers,Free private repositories !:)
Sign up
Clone or Download
vm_client.py 9.32 KB
Copy Edit Raw Blame History
tencentcloud authored 2024-03-18 04:21 . release 3.0.1110
# -*- coding: utf8 -*-
# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. 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.
import json
from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
from tencentcloud.common.abstract_client import AbstractClient
from tencentcloud.vm.v20210922 import models
class VmClient(AbstractClient):
_apiVersion = '2021-09-22'
_endpoint = 'vm.tencentcloudapi.com'
_service = 'vm'
def CancelTask(self, request):
"""可使用该接口取消审核任务,成功取消后,该接口返回已取消任务的TaskId。
:param request: Request instance for CancelTask.
:type request: :class:`tencentcloud.vm.v20210922.models.CancelTaskRequest`
:rtype: :class:`tencentcloud.vm.v20210922.models.CancelTaskResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("CancelTask", params, headers=headers)
response = json.loads(body)
model = models.CancelTaskResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def CreateVideoModerationTask(self, request):
"""本接口(Video Moderation System,VM)用于提交视频文件或视频流进行智能审核任务。使用前请您使用腾讯云主账号登录控制台[开通视频内容安全服务](https://console.cloud.tencent.com/cms)并调整好对应的业务配置。<br>
### 功能使用说明:
- 前往“[内容安全控制台-视频内容安全](https://console.cloud.tencent.com/cms)”开启使用视频内容安全服务,首次开通服务的用户可免费领用试用套餐包,包含200分钟的处理量(换算1s每帧截图,赠送**12000张图**、**200分钟的音频**处理量),有效期为15天。
- 该接口为收费接口,计费方式敬请参见[腾讯云视频内容安全定价](https://cloud.tencent.com/product/vm/pricing)。
- 默认接口请求频率限制:**20次/秒**,对于异步审核任务(点播视频),超出频率限制的请求会自动排入待审核队列,对于同步审核任务(直播视频),超出频率限制将会报错。
- 默认并发审核路数限制:点播默认10路,异步审核任务(点播视频)数量超过并发审核路数时,将会进入排队;直播默认100路,同步审核任务(直播视频)超过并发审核路数,接口会返回错误。
### 接口功能说明:
- 支持对视频文件或视频流进行自动检测,从 OCR文本识别、物体检测(实体、广告台标、二维码等)、图像识别及音频审核四个维度,通过深度学习技术识别视频中的违规内容;
- 支持设置回调地址 Callback 获取检测结果,或通过接口(查看任务详情)主动轮询获取检测结果详情;对于正常审核中的视频任务,如含有违规内容,则截帧图片最长会在**3s**内回调,音频片段会在用户配置的**切片时长 + 2s**内回调;对于在队列中的待审核任务,回调时间为正常审核回调时间+等待时间;
- 支持通过接口(查看审核任务列表)查询任务队列,用户可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表;
- 支持识别多种违规场景,包括:低俗、谩骂、色情、广告等场景;
- 支持根据不同的业务场景配置自定义的审核策略;
- 支持用户自定义配置黑白词库及图片库,打击自定义违规内容(目前仅支持黑名单配置);
- 支持用户自定义配置审核任务优先级,当有多个任务排队时,可根据用户配置自动调整任务优先级;
- 支持批量提交检测任务,**最多可同时创建10个任务**;
### 视频文件调用说明:
- 视频文件大小支持:**4K视频文件 < 10GB**;**低于4K视频文件 < 5GB**
- 视频文件分辨率支持:**最佳分辨率为1920x1080 (1080p)**,如果视频文件小于300MB,则分辨率可以大于1080p,分辨率最大支持4K,更大视频可以调用[云转码服务](https://cloud.tencent.com/product/mps/details)转码后再送审;
- 视频文件支持格式:flv、mkv 、mp4 、rmvb 、avi 、wmv、3gp、ts、mov、rm、mpeg、wmf等。
- 视频文件支持的访问方式:链接地址(支持HTTP/HTTPS)、腾讯云COS存储;
- 若传入视频文件的访问链接,则需要注意视频**头文件的读取时间限制为3秒**,为保障被检测视频的稳定性和可靠性,建议您使用腾讯云COS存储或者CDN缓存等;
- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频文件图像内容进行审核。
### 视频流调用说明:
- 视频流时长支持:**8小时以内**
- 视频流分辨率支持:支持**1920x1080 (1080p)**,更高分辨率视频可以调用[直播云转码服务](https://cloud.tencent.com/document/product/267/39889)转码后再送审;
- 视频流支持格式:rmtp,flv 等主流视频流编码格式。
- 视频流支持的传输协议:HTTP/HTTPS/RTMP;
- 支持用户配置是否需要开启音频审核,若不开启则将仅对视频流图像内容进行审核。
### 直播断流处理说明:
- 请确认已对接[取消任务](https://cloud.tencent.com/document/product/1265/80018)。
- 如果直播任务取消/结束,则终止直播拉流并退出审核。
- 如果直播任务没有取消/结束,直播视频推流因故中断,产品将在将在10分钟内持续拉流重试。如果10分钟检测到图片截帧/音频切片数据,则恢复正常审核,反之,则终止拉流并退出审核。在拉流终止后,用户如有审核需求,需重新送审。
:param request: Request instance for CreateVideoModerationTask.
:type request: :class:`tencentcloud.vm.v20210922.models.CreateVideoModerationTaskRequest`
:rtype: :class:`tencentcloud.vm.v20210922.models.CreateVideoModerationTaskResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("CreateVideoModerationTask", params, headers=headers)
response = json.loads(body)
model = models.CreateVideoModerationTaskResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def DescribeTaskDetail(self, request):
"""通过查看任务详情 DescribeTaskDetail 接口,可主动轮询获取检测结果详情。
:param request: Request instance for DescribeTaskDetail.
:type request: :class:`tencentcloud.vm.v20210922.models.DescribeTaskDetailRequest`
:rtype: :class:`tencentcloud.vm.v20210922.models.DescribeTaskDetailResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("DescribeTaskDetail", params, headers=headers)
response = json.loads(body)
model = models.DescribeTaskDetailResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
def DescribeTasks(self, request):
"""通过查看审核任务列表接口,可查询任务队列;您可根据多种业务信息(业务类型、审核结果、任务状态等)筛选审核任务列表。
:param request: Request instance for DescribeTasks.
:type request: :class:`tencentcloud.vm.v20210922.models.DescribeTasksRequest`
:rtype: :class:`tencentcloud.vm.v20210922.models.DescribeTasksResponse`
"""
try:
params = request._serialize()
headers = request.headers
body = self.call("DescribeTasks", params, headers=headers)
response = json.loads(body)
model = models.DescribeTasksResponse()
model._deserialize(response["Response"])
return model
except Exception as e:
if isinstance(e, TencentCloudSDKException):
raise
else:
raise TencentCloudSDKException(type(e).__name__, str(e))
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/tencentcloud/tencentcloud-sdk-python.git
git@gitee.com:tencentcloud/tencentcloud-sdk-python.git
tencentcloud
tencentcloud-sdk-python
tencentcloud-sdk-python
master

Search