tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageSDK Documentation.NET(C#) SDKContent ModerationAudio Moderation
Audio Moderation
Download PDF
Last updated: 2024-02-06 16:48:42
Audio Moderation
Last updated: 2024-02-06 16:48:42
Download PDF

Overview

This document describes how to use the content moderation feature provided by Cloud Infinite (CI). CI fully integrates the processing capabilities with the COS SDK.
Note:
To use the content moderation service, you need to have the permission to use CI:
For root accounts, click here for role authorization.
For sub-accounts, see Authorizing Sub-Accounts to Access CI Services.
This document provides an overview of APIs and SDK code samples for audio moderation.
API
Description
Submits audio moderation job.
Queries the result of specified audio moderation job.

Submitting Audio Moderation Job

Feature description

This API is used to submit an audio moderation job. The audio moderation feature is async. You can submit a job to moderate your audio files, and then use the API for querying audio moderation job result to query the moderation results.
The following example shows how to submit an audio moderation job and then query the result by JobId.
Note:
To perform this operation, the bucket should have CI features enabled.
Audio moderation APIs are supported starting from v5.4.24. To download the latest SDK, go to Releases or see Getting Started.
To view the version change log, go to GitHub.

Sample code

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") // Set the default region. For the abbreviations for COS regions, visit https://cloud.tencent.com/document/product/436/6224. 
          .Build();

        string secretId = "SECRET_ID";   // `SecretId` of your TencentCloud API key. For more information on how to get it, visit https://console.tencentcloud.com/cam/capi.
        string secretKey = "SECRET_KEY"; // `SecretKey` of your TencentCloud API key. For more information on how to get it, visit https://console.tencentcloud.com/cam/capi.
        long durationSecond = 600;          // Validity period of the request signature in seconds
        QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, 
          secretKey, durationSecond);

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

      /// Submit the audio moderation job
      public string SubmitAudioCensorJob()
      {
        // Bucket name, which must be in the format of `bucketname-APPID`. For more information on how to get the `APPID`, visit https://console.tencentcloud.com/developer.
        string bucket = "examplebucket-1250000000"; // Note: To perform this operation, the bucket should have the content moderation feature enabled.
        SubmitAudioCensorJobRequest request = new SubmitAudioCensorJobRequest(bucket);
        request.SetCensorObject("audio.mp3"); // Object key of the media file, which should be replaced with that of the actual media file in the bucket.
        // The scene to be moderated, such as `Porn` (pornography) and `Ads` (advertising). You can pass in multiple types and separate them by comma, such as `Porn,Ads`.
        request.SetDetectType("Porn,Ads");
        // Execute the request
        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();
        /// Submit the moderation job
        string JobId = m.SubmitAudioCensorJob();
        /// Print the `JobId` that uniquely identifies this moderation job
        Console.WriteLine("JobId : " + JobId);
      }
    }
}
Note:
For more complete samples, visit GitHub.

Querying Audio Moderation Job Result

Feature description

This API is used to query the status and result of an audio moderation job.

Sample code

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") // Set the default region. For the abbreviations for COS regions, visit https://cloud.tencent.com/document/product/436/6224. 
          .Build();

        string secretId = "SECRET_ID";   // `SecretId` of your TencentCloud API key. For more information on how to get it, visit https://console.tencentcloud.com/cam/capi.
        string secretKey = "SECRET_KEY"; // `SecretKey` of your TencentCloud API key. For more information on how to get it, visit https://console.tencentcloud.com/cam/capi.
        long durationSecond = 600;          // Validity period of the request signature in seconds
        QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, 
          secretKey, durationSecond);

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

      /// Query the audio moderation job result
      public void GetAudioCensorJobResult(string JobId)
      {
        // Bucket name, which must be in the format of `bucketname-APPID`. For more information on how to get the `APPID`, visit https://console.tencentcloud.com/developer.
        string bucket = "examplebucket-1250000000"; // Note: To perform this operation, the bucket should have the content moderation feature enabled.
        GetAudioCensorJobRequest request = new GetAudioCensorJobRequest(bucket, JobId);
        // Execute the request
        GetAudioCensorJobResult result = cosXml.GetAudioCensorJob(request);
        Console.WriteLine(result.GetResultInfo());

        // Read the moderation result
        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);

        // Information of audio sections
        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();
        /// Enter the `JobId` obtained when you submit the moderation job
        string JobId = "xxx";
        /// Query the moderation job result
        m.GetAudioCensorJobResult(JobId);
      }
    }
}
Note:
For more complete samples, visit GitHub.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon