tencentcloud-sdk-nodejs 3.0.269 → 3.0.270

package/tencentcloud/ams/v20201229/ams_client.js

@@ -16,8 +16,10 @@
  */
 const models = require("./models");
 const AbstractClient = require('../../common/abstract_client')
+const TextResult = models.TextResult;
 const DescribeTasksRequest = models.DescribeTasksRequest;
 const StorageInfo = models.StorageInfo;
+const CreateAudioModerationSyncTaskRequest = models.CreateAudioModerationSyncTaskRequest;
 const BucketInfo = models.BucketInfo;
 const CreateAudioModerationTaskResponse = models.CreateAudioModerationTaskResponse;
 const TaskResult = models.TaskResult;
@@ -26,11 +28,13 @@ const DescribeTaskDetailResponse = models.DescribeTaskDetailResponse;
 const CreateAudioModerationTaskRequest = models.CreateAudioModerationTaskRequest;
 const TaskInput = models.TaskInput;
 const DescribeTaskDetailRequest = models.DescribeTaskDetailRequest;
+const CreateAudioModerationSyncTaskResponse = models.CreateAudioModerationSyncTaskResponse;
 const TaskLabel = models.TaskLabel;
 const TaskFilter = models.TaskFilter;
 const InputInfo = models.InputInfo;
 const DescribeTasksResponse = models.DescribeTasksResponse;
 const AudioResultDetailLanguageResult = models.AudioResultDetailLanguageResult;
+const MoanResult = models.MoanResult;
 const CancelTaskResponse = models.CancelTaskResponse;
 const AudioResultDetailTextResult = models.AudioResultDetailTextResult;
 const AudioResult = models.AudioResult;
@@ -51,30 +55,31 @@ class AmsClient extends AbstractClient {
     }
     
     /**
-     * 本接口（Audio Moderation）用于提交音频内容（包括音频文件或流地址）进行智能审核任务，使用前请您登陆控制台开通音频内容安全服务。
+     * 本接口（Audio Moderation）用于提交音频内容（包括音频文件或流地址）进行智能审核任务，使用前请您使用腾讯云主账号登录控制台[开通音频内容安全服务](https://console.cloud.tencent.com/cms/audio/package)并调整好对应的业务配置。<br>
 
 ### 功能使用说明：
-- 前往“内容安全控制台-音频内容安全”开启使用音频内容安全服务，首次开通可获得20小时免费调用时长
+- 前往“[内容安全控制台-音频内容安全](https://console.cloud.tencent.com/cms/audio/package)”开启使用音频内容安全服务，首次开通可获得**10小时**免费调用时长，有效期为1个月。
+- 默认接口请求频率限制：**20次/秒**；对于异步审核任务（点播音频），超出频率限制的请求会自动排入待审核队列，对于同步审核任务（直播音频），超出频率限制将会报错。
 
 ### 接口功能说明：
 - 支持对音频流或音频文件进行检测，判断其中是否包含违规内容；
-- 支持设置回调地址 Callback 获取检测结果，或通过接口(查询音频检测结果)主动轮询获取检测结果；
-- 支持识别违规内容，包括：低俗、谩骂、色情、涉政、广告等场景；
-- 支持批量提交检测任务。检测任务列表最多支持10个；
+- 支持设置回调地址 Callback 获取检测结果（对于已在审核的任务，最长回调时间为用户配置的**切片时长 + 2s**），或通过接口(查询音频检测结果)主动轮询获取检测结果；
+- 支持识别违规内容，包括：低俗、谩骂、色情、广告等场景；
+- 支持批量提交检测任务，检测任务列表**最多支持10个**。
 
 ### 音频文件调用说明：
-- 音频文件大小支持：文件 < 500M；
-- 音频文件时长支持：< 1小时；
+- 音频文件大小支持：**文件 < 500M**；
+- 音频文件时长支持：**< 1小时**；
 - 音频码率类型支持：128 Kbps - 256 Kbps ；
 - 音频文件支持格式：wav、mp3、aac、flac、amr、3gp、 m4a、wma、ogg、ape；
-- 支持音视频文件分离并对音频文件进行独立识别；
+- （**当输入为视频文件时**）支持分离视频文件音轨，并对音频内容进行独立审核。
 
 ### 音频流调用说明：
-- 音频流时长支持：< 3小时；
+- 音频流时长支持：**< 3小时**；
 - 音频码率类型支持：128 Kbps - 256 Kbps ；
 - 音频流支持的传输协议：RTMP、HTTP、HTTPS；
 - 音频流格式支持的类型：rtp、srtp、rtmp、rtmps、mmsh、 mmst、hls、http、tcp、https、m3u8；
-- 支持音视频流分离并对音频流进行独立识别；
+- （**当输入为视频流时**）支持提取视频流音轨，并对音频内容进行独立审核。
      * @param {CreateAudioModerationTaskRequest} req
      * @param {function(string, CreateAudioModerationTaskResponse):void} cb
      * @public
@@ -85,7 +90,30 @@ class AmsClient extends AbstractClient {
     }
 
     /**
-     * 查看任务详情
+     * 本接口（CreateAudioModerationSyncTask） 用于提交短音频内容进行智能审核任务，使用前请您登录控制台开通音频内容安全服务。
+
+功能使用说明：
+前往“内容安全控制台-音频内容安全”开启使用音频内容安全服务，首次开通可获得10小时免费调用时长；
+
+接口限制：
+- 音频文件大小支持：文件 < 5M;
+- 音频文件时长小于60s，超过60s音频调用则报错；
+- 音频码率类型支持：8Kbps - 16Kbps；
+- 音频文件支持格式：wav、mp3；
+- 接口仅限音频文件传入，视频文件传入请调用长音频异步接口；
+- 接口默认QPS为10，默认接口请求频率限制20次/秒，如需要更高的并发或请求频率，请工单咨询；
+- 接口超时为5s，每一次请求超过该时长会报错；
+     * @param {CreateAudioModerationSyncTaskRequest} req
+     * @param {function(string, CreateAudioModerationSyncTaskResponse):void} cb
+     * @public
+     */
+    CreateAudioModerationSyncTask(req, cb) {
+        let resp = new CreateAudioModerationSyncTaskResponse();
+        this.request("CreateAudioModerationSyncTask", req, resp, cb);
+    }
+
+    /**
+     * 通过该接口可查看音频审核任务的详情信息，包括任务状态、检测结果、音频文件识别出的对应文本内容、检测结果所对应的恶意标签及推荐的后续操作等，具体输出内容可查看输出参数示例。<br>默认接口请求频率限制：**100次/秒**。
      * @param {DescribeTaskDetailRequest} req
      * @param {function(string, DescribeTaskDetailResponse):void} cb
      * @public
@@ -96,7 +124,7 @@ class AmsClient extends AbstractClient {
     }
 
     /**
-     * 查看审核任务列表
+     * 通过该接口可查看审核任务列表；您也可根据多种业务信息（业务类型、审核结果、任务状态等）筛选审核任务列表。任务列表输出内容包括当前查询的任务总量、任务名称、任务状态、音频审核类型、基于检测结果的恶意标签及其后续操作等，具体输出内容可查看输出参数示例。<br>默认接口请求频率限制：**20次/秒**。
      * @param {DescribeTasksRequest} req
      * @param {function(string, DescribeTasksResponse):void} cb
      * @public
@@ -107,7 +135,7 @@ class AmsClient extends AbstractClient {
     }
 
     /**
-     * 取消任务
+     * 可使用该接口取消审核任务。请求成功后，接口返回RequestId则说明取消成功。<br>默认接口请求频率限制：**20次/秒**。
      * @param {CancelTaskRequest} req
      * @param {function(string, CancelTaskResponse):void} cb
      * @public