tencent cloud

14天试用边缘安全加速平台 EO 限时免费

文档反馈

对象存储

音频审核

最后更新时间:2024-01-05 17:40:23

简介

内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。
说明
使用内容审核服务需拥有数据万象使用权限:
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
本文档提供关于音频审核的 API 概览和 SDK 示例代码。
API
操作描述
用于提交一个音频审核任务
用于查询指定的音频审核任务

提交音频审核任务

功能说明

本接口用于提交一个音频审核任务。音频审核功能为异步任务方式,您可以通过提交音频审核任务审核您的音频文件,然后通过查询音频审核任务接口查询审核结果。
下面示例展示了如何提交一个音频审核任务,然后通过 JobId 查询音频审核任务结果。
说明
此操作需要存储桶开通数据万象相关功能。
音频审核接口从 5.4.24 版本开始支持,下载新版 SDK 前往 Releases 或参见 快速入门
查看版本 Changelog 请前往 GitHub

示例代码

using COSXML.Model.CI;
using COSXML.Auth;
using System;
using System.Threading;
using COSXML;

namespace COSSnippet
{
public class SubmitAudioCensorJobModel {

private CosXml cosXml;

SubmitAudioCensorJobModel() {
CosXmlConfig config = new CosXmlConfig.Builder()
.SetRegion("COS_REGION") // 设置默认的地域, COS 地域的简称请参照 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1
.Build();

string secretId = "SECRET_ID"; // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
long durationSecond = 600; //每次请求签名有效时长,单位为秒
QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId,
secretKey, durationSecond);

this.cosXml = new CosXmlServer(config, qCloudCredentialProvider);
}

// 提交音频审核任务
public string SubmitAudioCensorJob()
{
// 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
SubmitAudioCensorJobRequest request = new SubmitAudioCensorJobRequest(bucket);
request.SetCensorObject("audio.mp3"); // 媒体文件的对象键,需要替换成桶内存在的媒体文件的对象键
// 审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads
request.SetDetectType("Porn,Ads");
// 执行请求
SubmitCensorJobResult result = cosXml.SubmitAudioCensorJob(request);
Console.WriteLine(result.GetResultInfo());
Console.WriteLine(result.censorJobsResponse.JobsDetail.JobId);
Console.WriteLine(result.censorJobsResponse.JobsDetail.State);
Console.WriteLine(result.censorJobsResponse.JobsDetail.CreationTime);
return result.censorJobsResponse.JobsDetail.JobId;
}

static void Main(string[] args)
{
SubmitAudioCensorJobModel m = new SubmitAudioCensorJobModel();
// 提交审核任务
string JobId = m.SubmitAudioCensorJob();
// 打印唯一标识此次审核任务的 JobId
Console.WriteLine("JobId : " + JobId);
}
}
}
说明
更多完整示例,请前往 GitHub 查看。

查询音频审核任务结果

功能说明

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

示例代码

using COSXML.Model.CI;
using COSXML.Auth;
using System;
using System.Threading;
using COSXML;

namespace COSSnippet
{
public class SubmitAudioCensorJobModel {

private CosXml cosXml;

SubmitAudioCensorJobModel() {
CosXmlConfig config = new CosXmlConfig.Builder()
.SetRegion("COS_REGION") // 设置默认的地域, COS 地域的简称请参照 https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1
.Build();

string secretId = "SECRET_ID"; // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.tencentcloud.com/cam/capi
long durationSecond = 600; //每次请求签名有效时长,单位为秒
QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId,
secretKey, durationSecond);

this.cosXml = new CosXmlServer(config, qCloudCredentialProvider);
}

// 查询音频审核任务结果
public void GetAudioCensorJobResult(string JobId)
{
// 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
GetAudioCensorJobRequest request = new GetAudioCensorJobRequest(bucket, JobId);
// 执行请求
GetAudioCensorJobResult result = cosXml.GetAudioCensorJob(request);
Console.WriteLine(result.GetResultInfo());

// 读取审核结果
Console.WriteLine(result.resultStruct.JobsDetail.JobId);
Console.WriteLine(result.resultStruct.JobsDetail.State);
Console.WriteLine(result.resultStruct.JobsDetail.CreationTime);
Console.WriteLine(result.resultStruct.JobsDetail.Object);
Console.WriteLine(result.resultStruct.JobsDetail.Result);
Console.WriteLine(result.resultStruct.JobsDetail.AudioText);

Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.Score);
Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.Label);

Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.Score);
Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.Label);

// 音频节选Section信息
for(int i = 0; i < result.resultStruct.JobsDetail.Section.Count; i++)
{
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].Url);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].OffsetTime);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].Duration);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].Text);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].PornInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].PornInfo.Score);

Console.WriteLine(result.resultStruct.JobsDetail.Section[i].AdsInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.Section[i].AdsInfo.Score);
}
}

static void Main(string[] args)
{
SubmitAudioCensorJobModel m = new SubmitAudioCensorJobModel();
// 输入提交审核任务时获取的 JobId
string JobId = "xxx";
// 查询审核任务结果
m.GetAudioCensorJobResult(JobId);
}
}
}
说明
更多完整示例,请前往 GitHub 查看。
联系我们

联系我们,为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持
中国香港
+852 800 906 020 (免费)
美国
+1 844 606 0804 (免费)
英国
+44 808 196 4551 (免费)
加拿大
+1 888 605 7930 (免费)
澳大利亚
+61 1300 986 386 (免费)
EdgeOne 热线
+852 300 80699
更多本地服务热线陆续新增中