tencent cloud

文档反馈

文本审核

最后更新时间:2024-01-05 14:14:08

    简介

    内容审核功能是由 数据万象(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 SubmitTextCensorJobModel {
    
    private CosXml cosXml;
    
    SubmitTextCensorJobModel() {
    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 SubmitTextCensorJob()
    {
    // 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
    string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
    SubmitTextCensorJobRequest request = new SubmitTextCensorJobRequest(bucket);
    request.SetCensorObject("text.txt"); // 媒体文件的对象键,需要替换成桶内存在的媒体文件的对象键
    // 审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads
    request.SetDetectType("Porn,Ads");
    // 执行请求
    SubmitCensorJobResult result = cosXml.SubmitTextCensorJob(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;
    //.cssg-snippet-body-end
    }
    
    static void Main(string[] args)
    {
    SubmitTextCensorJobModel m = new SubmitTextCensorJobModel();
    /// 提交审核任务
    string JobId = m.SubmitTextCensorJob();
    /// 打印唯一标识了此次审核任务的 JobId
    Console.WriteLine("JobId : " + JobId);
    }
    }
    }
    
    说明
    更多完整示例,请前往 GitHub 查看。

    查询文本审核任务

    功能说明

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

    示例代码

    using COSXML.Model.CI;
    using COSXML.Auth;
    using System;
    using System.Threading;
    using COSXML;
    
    namespace COSSnippet
    {
    public class SubmitTextCensorJobModel {
    
    private CosXml cosXml;
    
    SubmitTextCensorJobModel() {
    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 GetTextCensorJobResult(string JobId)
    {
    // 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
    string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
    GetTextCensorJobRequest request = new GetTextCensorJobRequest(bucket, JobId);
    // 执行请求
    GetTextCensorJobResult result = cosXml.GetTextCensorJob(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.SectionCount);
    Console.WriteLine(result.resultStruct.JobsDetail.Result);
    
    Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.HitFlag);
    Console.WriteLine(result.resultStruct.JobsDetail.PornInfo.Count);
    Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.HitFlag);
    Console.WriteLine(result.resultStruct.JobsDetail.AdsInfo.Count);
    
    // 文本节选Section信息
    for(int i = 0; i < result.resultStruct.JobsDetail.Section.Count; i++)
    {
    Console.WriteLine(result.resultStruct.JobsDetail.Section[i].StartByte);
    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].PornInfo.Keywords);
    }
    }
    
    static void Main(string[] args)
    {
    SubmitTextCensorJobModel m = new SubmitTextCensorJobModel();
    // 输入提交文本审核任务时获取到的 JobId
    string JobId = "xxx";
    // 查询审核任务结果
    m.GetTextCensorJobResult(JobId);
    }
    }
    }
    
    说明
    更多完整示例,请前往 GitHub 查看。
    联系我们

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

    技术支持

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

    7x24 电话支持