tencentcloud-sdk-vm 3.0.696 → 3.0.697

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 71c6ffa0d6e2b30e6a4ae17633efb46e6e36057b
-  data.tar.gz: 7eb3c06d539b64b66db291838e3b300c5b896110
+  metadata.gz: efa8befab21b879a42d7d518ac59ca0e9d8e01f4
+  data.tar.gz: 619a6fcd5e95b5ffbad193aa3664042c3ffd058e
 SHA512:
-  metadata.gz: bd7197b3987888f6c87295dbfd0ff05f1d2834b0a5fb247c7a3fba4bba0c8cd5edf83cbd7ea78767ff26353df49ea91f7988d59dc54acd6d093c9f22dd81ceb8
-  data.tar.gz: a4bb701921fbde02afa4e017dd78ee1d732ef92e1eabca0bbf1447c24a2b5ecaa25ff691e32e7bf4b854aa5351cf70bf567301c3abde62e0f41f730c54c0401f
+  metadata.gz: f44878eb17101a660be148c66cb8f38a524a92658030892c39a805d8261c3da20c71858352c6a79071a345a04ce53a218b2533d7844b9a654839b544340261fd
+  data.tar.gz: 8f99beccb442e414e9dca828032eb81a27fe03e5f633fc47474a53825a5b8c101abb515819c1f55086ad80ef944169eda2a250ff9bc076c3a73098a78d256aea

data/lib/VERSION

@@ -1 +1 @@
-3.0.696
+3.0.697

data/lib/v20210922/client.rb

@@ -29,7 +29,7 @@ module TencentCloud
         end
 
 
-        # 取消任务
+        # 可使用该接口取消审核任务，成功取消后，该接口返回已取消任务的TaskId。
 
         # @param request: Request instance for CancelTask.
         # @type request: :class:`Tencentcloud::vm::V20210922::CancelTaskRequest`
@@ -53,15 +53,50 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过URL或存储桶创建审核任务。
+        # 本接口（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分钟检测到图片截帧/音频切片数据，则恢复正常审核，反之，则终止拉流并退出审核。在拉流终止后，用户如有审核需求，需重新送审。
 
-        # 默认接口请求频率限制：20次/秒。
-
         # @param request: Request instance for CreateVideoModerationTask.
         # @type request: :class:`Tencentcloud::vm::V20210922::CreateVideoModerationTaskRequest`
         # @rtype: :class:`Tencentcloud::vm::V20210922::CreateVideoModerationTaskResponse`
@@ -84,7 +119,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 查看任务详情DescribeTaskDetail
+        # 通过查看任务详情 DescribeTaskDetail 接口，可主动轮询获取检测结果详情。
 
         # @param request: Request instance for DescribeTaskDetail.
         # @type request: :class:`Tencentcloud::vm::V20210922::DescribeTaskDetailRequest`
@@ -108,9 +143,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 通过查看审核任务列表接口，可查询任务队列；您可根据多种业务信息（业务类型、审核结果、任务状态等）筛选审核任务列表。<br>
-
-        # 默认接口请求频率限制：**20次/秒**。
+        # 通过查看审核任务列表接口，可查询任务队列；您可根据多种业务信息（业务类型、审核结果、任务状态等）筛选审核任务列表。
 
         # @param request: Request instance for DescribeTasks.
         # @type request: :class:`Tencentcloud::vm::V20210922::DescribeTasksRequest`

data/lib/v20210922/models.rb

@@ -340,7 +340,8 @@ module TencentCloud
 
       # CreateVideoModerationTask请求参数结构体
       class CreateVideoModerationTaskRequest < TencentCloud::Common::AbstractModel
-        # @param BizType: 业务类型, 定义 模版策略，输出存储配置。如果没有BizType，可以先参考 【创建业务配置】接口进行创建
+        # @param BizType: 该字段表示策略的具体编号，用于接口调度，在[内容安全控制台](https://console.cloud.tencent.com/cms/clouds/manage)中可配置。若不传入Biztype参数（留空），则代表采用默认的识别策略；传入则会在审核时根据业务场景采取不同的审核策略。
+        # 备注：Biztype仅为数字、字母与下划线的组合，长度为3-32个字符；不同Biztype关联不同的业务场景与识别能力策略，调用前请确认正确的Biztype。
         # @type BizType: String
         # @param Type: 任务类型：可选VIDEO（点播视频），LIVE_VIDEO（直播视频）
         # @type Type: String
@@ -477,9 +478,14 @@ module TencentCloud
         # @param AudioSegments: 该字段用于返回视频中音频审核的结果，详细返回内容敬请参考AudioSegments数据结构的描述。<br>备注：数据有效期为24小时，如需要延长存储时间，请在已配置的COS储存桶中设置。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type AudioSegments: Array
-        # @param ErrorType: 当任务状态为Error时，返回对应错误的类型，取值：**DECODE_ERROR**: 解码失败。（输入资源中可能包含无法解码的视频）
+        # @param ErrorType: 当任务状态为Error时，返回对应错误的类型，取值：
+        # **DECODE_ERROR**: 解码失败。（输入资源中可能包含无法解码的视频）
         # **URL_ERROR**：下载地址验证失败。
-        # **TIMEOUT_ERROR**：处理超时。任务状态非Error时默认返回为空。
+        # **TIMEOUT_ERROR**：处理超时。
+        # **CALLBACK_ERRORR**：回调错误。
+        # **MODERATION_ERROR**：审核失败。
+        # **URL_NOT_SUPPORTED**：源文件太大或没有图片音频帧
+        # 任务状态非Error时默认返回为空。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type ErrorType: String
         # @param ErrorDescription: 当任务状态为Error时，该字段用于返回对应错误的详细描述，任务状态非Error时默认返回为空。
@@ -494,12 +500,15 @@ module TencentCloud
         # @param Asrs: 该字段用于返回音频文件识别出的对应文本内容。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Asrs: Array
+        # @param SegmentCosUrlList: 该字段用于返回检测结果明细数据相关的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type SegmentCosUrlList: :class:`Tencentcloud::Vm.v20210922.models.SegmentCosUrlList`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
 
-        attr_accessor :TaskId, :DataId, :BizType, :Name, :Status, :Type, :Suggestion, :Labels, :MediaInfo, :InputInfo, :CreatedAt, :UpdatedAt, :TryInSeconds, :ImageSegments, :AudioSegments, :ErrorType, :ErrorDescription, :Label, :AudioText, :Asrs, :RequestId
+        attr_accessor :TaskId, :DataId, :BizType, :Name, :Status, :Type, :Suggestion, :Labels, :MediaInfo, :InputInfo, :CreatedAt, :UpdatedAt, :TryInSeconds, :ImageSegments, :AudioSegments, :ErrorType, :ErrorDescription, :Label, :AudioText, :Asrs, :SegmentCosUrlList, :RequestId
 
-        def initialize(taskid=nil, dataid=nil, biztype=nil, name=nil, status=nil, type=nil, suggestion=nil, labels=nil, mediainfo=nil, inputinfo=nil, createdat=nil, updatedat=nil, tryinseconds=nil, imagesegments=nil, audiosegments=nil, errortype=nil, errordescription=nil, label=nil, audiotext=nil, asrs=nil, requestid=nil)
+        def initialize(taskid=nil, dataid=nil, biztype=nil, name=nil, status=nil, type=nil, suggestion=nil, labels=nil, mediainfo=nil, inputinfo=nil, createdat=nil, updatedat=nil, tryinseconds=nil, imagesegments=nil, audiosegments=nil, errortype=nil, errordescription=nil, label=nil, audiotext=nil, asrs=nil, segmentcosurllist=nil, requestid=nil)
           @TaskId = taskid
           @DataId = dataid
           @BizType = biztype
@@ -520,6 +529,7 @@ module TencentCloud
           @Label = label
           @AudioText = audiotext
           @Asrs = asrs
+          @SegmentCosUrlList = segmentcosurllist
           @RequestId = requestid
         end
 
@@ -578,6 +588,10 @@ module TencentCloud
               @Asrs << rcbasr_tmp
             end
           end
+          unless params['SegmentCosUrlList'].nil?
+            @SegmentCosUrlList = SegmentCosUrlList.new
+            @SegmentCosUrlList.deserialize(params['SegmentCosUrlList'])
+          end
           @RequestId = params['RequestId']
         end
       end
@@ -753,7 +767,7 @@ module TencentCloud
         # @param Score: 分数
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Score: Integer
-        # @param Names: 如果命中场景为涉政，则该数据为人物姓名列表，否则null
+        # @param Names: 人物名称列表，如未识别，则为null
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Names: Array
         # @param Text: 图片OCR文本
@@ -1035,6 +1049,43 @@ module TencentCloud
         end
       end
 
+      # 明细数据相关的cos url
+      class SegmentCosUrlList < TencentCloud::Common::AbstractModel
+        # @param ImageAllUrl: 全量图片片段的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ImageAllUrl: String
+        # @param AudioAllUrl: 全量音频片段的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type AudioAllUrl: String
+        # @param ImageBlockUrl: 违规图片片段的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type ImageBlockUrl: String
+        # @param AudioBlockUrl: 违规音频片段的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type AudioBlockUrl: String
+        # @param AsrUrl: 全量音频识别文本的cos url
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type AsrUrl: String
+
+        attr_accessor :ImageAllUrl, :AudioAllUrl, :ImageBlockUrl, :AudioBlockUrl, :AsrUrl
+
+        def initialize(imageallurl=nil, audioallurl=nil, imageblockurl=nil, audioblockurl=nil, asrurl=nil)
+          @ImageAllUrl = imageallurl
+          @AudioAllUrl = audioallurl
+          @ImageBlockUrl = imageblockurl
+          @AudioBlockUrl = audioblockurl
+          @AsrUrl = asrurl
+        end
+
+        def deserialize(params)
+          @ImageAllUrl = params['ImageAllUrl']
+          @AudioAllUrl = params['AudioAllUrl']
+          @ImageBlockUrl = params['ImageBlockUrl']
+          @AudioBlockUrl = params['AudioBlockUrl']
+          @AsrUrl = params['AsrUrl']
+        end
+      end
+
       #  数据存储信息
       class StorageInfo < TencentCloud::Common::AbstractModel
         # @param Type: 类型 可选：
@@ -1259,19 +1310,24 @@ module TencentCloud
         # @param Score: 得分，分数是 0 ～ 100
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Score: Integer
+        # @param SubLabel: 命中的二级标签
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type SubLabel: String
 
-        attr_accessor :Label, :Suggestion, :Score
+        attr_accessor :Label, :Suggestion, :Score, :SubLabel
 
-        def initialize(label=nil, suggestion=nil, score=nil)
+        def initialize(label=nil, suggestion=nil, score=nil, sublabel=nil)
           @Label = label
           @Suggestion = suggestion
           @Score = score
+          @SubLabel = sublabel
         end
 
         def deserialize(params)
           @Label = params['Label']
           @Suggestion = params['Suggestion']
           @Score = params['Score']
+          @SubLabel = params['SubLabel']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-vm
 version: !ruby/object:Gem::Version
-  version: 3.0.696
+  version: 3.0.697
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-08 00:00:00.000000000 Z
+date: 2023-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common