对象存储

动态与公告

产品简介

购买指南

快速入门

控制台指南

工具指南

最佳实践

视频教程专区

开发者指南

第三方教程

数据湖存储

数据处理 Demo 体验

故障处理

API 文档

SDK 文档

常见问题

服务等级协议

附录

联系我们

词汇表
数据库文档捉虫大赛邀您参加，好礼多多> HOT
文档中心 > 对象存储 > SDK 文档 > Node.js SDK > 内容审核 > 音频审核

音频审核

最近更新时间：2022-10-14 10:36:30

前往 GitHub 编辑 我的收藏

本页目录：

简介

内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。

说明：

使用内容审核服务需拥有数据万象使用权限：

本文档提供关于音频审核的 API 概览和 SDK 示例代码。

注意：

COS Node.js SDK 版本需要大于等于 v2.11.2。

API 操作描述
提交音频审核任务 用于提交一个音频审核任务
查询音频审核任务结果 用于查询指定的音频审核任务

提交音频审核任务

功能说明

用于提交一个音频审核任务。

请求示例

var config = {
  // 需要替换成您自己的存储桶信息
  Bucket: 'examplebucket-1250000000', /* 存储桶，必须 */
  Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */
};
function postAudioAuditing() {
  var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
  var url = 'https://' + host + '/audio/auditing';
  var body = COS.util.json2xml({
    Request: {
      Input: {
        Object: '1.mp3', /* 需要审核的音频文件，存储桶里的路径 */
      },
      Conf: {
        BizType: '',
        DetectType: 'Porn',
      }
    }
  });
  cos.request({
      Bucket: config.Bucket,
      Region: config.Region,
      Method: 'POST',
      Url: url,
      Key: '/audio/auditing', /** 固定值，必须 */
      ContentType: 'application/xml', /** 固定值，必须 */
      Body: body
  },
  function(err, data){
      console.log(err || data);
  });
}

参数说明

Request 中的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Input Request 需要审核的内容。 Container 是
Conf Request 审核规则配置。 Container 是

Container 类型 Input 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Object Request.Input 存储在 COS 存储桶中的音频文件名称，例如在目录 test 中的文件 audio.mp3，则文件名称为 test/audio.mp3。Object 和 Url 只能选择其中一种。 String 否
Url Request.Input 音频文件的链接地址，例如 http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/audio.mp3。Object 和 Url 只能选择其中一种。 String 否

Container 类型 Conf 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
DetectType Request.Conf 审核的场景类型，有效值：Porn（涉黄）、Ads（广告）、Illegal（违法）、Abuse（谩骂），可以传入多种类型，不同类型以逗号分隔，例如：Porn,Ads。 String 否
Callback Request.Conf 审核结果以回调形式发送至您的回调地址，支持以 http:// 或者 https:// 开头的地址，例如：http://www.callback.com。 String 否
CallbackVersion Request.Conf 回调内容的结构，有效值：Simple（回调内容包含基本信息）、Detail（回调内容包含详细信息）。默认为 Simple。 string 否
BizType Request.Conf 审核策略，不填写则使用默认策略。可在控制台进行配置，详情请参见 设置公共审核策略。 String 否

返回结果说明

详情请参见 提交音频审核任务。

查询音频审核任务

功能说明

用于查询音频审核任务执行情况和结果。

请求示例

var config = {
  // 需要替换成您自己的存储桶信息
  Bucket: 'examplebucket-1250000000', /* 存储桶，必须 */
  Region: 'COS_REGION', /* 存储桶所在地域，必须字段 */
};
function getAudioAuditingResult() {
  var jobId = 'sa0c28d41daff411ecb23352540078cxxx'; // jobId可以通过提交音频审核任务返回
  var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
  var url = 'https://' + host + '/audio/auditing/' + jobId;
  cos.request({
      Bucket: config.Bucket,
      Region: config.Region,
      Method: 'GET',
      Key: '/audio/auditing/' + jobId,
      Url: url,
  },
  function(err, data){
      console.log(err || data);
  });
}

参数说明

参数名称 描述 类型 是否必选
jobId 需要查询的任务 ID。 String 是

返回结果说明

详情请参见 查询音频审核任务结果。

目录