tencent cloud

数据万象

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
功能概览
地域与域名
使用限制
产品计费
计费概述
计费方式
计费项
免费额度
欠费说明
查看消费明细
常见问题
快速入门
注册与登录
绑定存储桶
上传和处理文件
下载和删除文件
解绑存储桶
通过 COS 使用数据万象
能力地图
图片处理
媒体处理
内容审核
AI 内容识别
文档处理
智能语音
文件处理
用户指南
概览
存储桶管理
智能工具箱
任务与工作流
数据监控
用量统计
实践教程
版权保护解决方案
图片处理实践
API 授权策略使用指引
工作流实践
API 文档
API 概览
结构体
公共请求头部
公共响应头部
开通万象服务
图片处理
AI 内容识别
智能语音
媒体处理
内容审核
文档处理
文件处理
任务与工作流
云查毒
错误码
请求签名
SDK 文档
SDK 概览
图片处理 Android SDK
图片处理 iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
小程序 SDK
SDK 产品个人信息保护规则
安全与合规
权限管理
常见问题
基础设置
文档处理
媒体处理
内容识别
智能语音
服务协议
Service Level Agreement
联系我们
词汇表

文档审核

PDF
聚焦模式
字号
最后更新时间: 2024-03-04 16:55:55

简介

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

提交文档审核任务

功能说明

本接口用于提交一个文档审核任务,可审核您的文档文件是否存在敏感违规信息。文档审核结合了对象存储(Cloud Object Storage,COS)文档预览功能,通过预先将文档转成图片,结合图片内容审核、图片 OCR 审核等方式,进行文档审核。
下面示例展示了如何提交一个文档审核任务,然后何通过 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 SubmitDocumentCensorJobModel {

private CosXml cosXml;

SubmitDocumentCensorJobModel() {
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 SubmitDocumentCensorJob()
{
// 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
SubmitDocumentCensorJobRequest request = new SubmitDocumentCensorJobRequest(bucket);
request.SetUrl("url"); // 审核文档的URL,需要替换成具体需要审核的文档URL
// 审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以逗号分隔,例如:Porn,Ads
request.SetDetectType("Porn,Ads");
// 执行请求
SubmitCensorJobResult result = cosXml.SubmitDocumentCensorJob(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)
{
SubmitDocumentCensorJobModel m = new SubmitDocumentCensorJobModel();
/// 提交审核任务
string JobId = m.SubmitDocumentCensorJob();
}
}
}

说明:
更多完整示例,请前往 GitHub 查看。

查询文档审核任务

功能说明

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

示例代码

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

namespace COSSnippet
{
public class SubmitDocumentCensorJobModel {

private CosXml cosXml;

SubmitDocumentCensorJobModel() {
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 GetDocumentCensorJobResult(string JobId)
{
// 存储桶名称,此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.tencentcloud.com/developer
string bucket = "examplebucket-1250000000"; // 注意:此操作需要 bucket 开通内容审核相关功能
GetDocumentCensorJobRequest request = new GetDocumentCensorJobRequest(bucket, JobId);
// 执行请求
GetDocumentCensorJobResult result = cosXml.GetDocumentCensorJob(request);
Console.WriteLine(result.GetResultInfo());

// 读取审核结果
Console.WriteLine(result.resultStruct.JobsDetail.State);
Console.WriteLine(result.resultStruct.JobsDetail.JobId);
Console.WriteLine(result.resultStruct.JobsDetail.Suggestion);
Console.WriteLine(result.resultStruct.JobsDetail.CreationTime);
Console.WriteLine(result.resultStruct.JobsDetail.Url);
Console.WriteLine(result.resultStruct.JobsDetail.PageCount);
Console.WriteLine(result.resultStruct.JobsDetail.Labels);
Console.WriteLine(result.resultStruct.JobsDetail.Labels.PornInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.Labels.PornInfo.Score);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.Url);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.Text);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.PageNumber);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.PornInfo.HitFlag);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.PornInfo.SubLabel);
Console.WriteLine(result.resultStruct.JobsDetail.PageSegment.Results.PornInfo.Score);
}

static void Main(string[] args)
{
SubmitDocumentCensorJobModel m = new SubmitDocumentCensorJobModel();
/// 输入提交审核任务时返回的, 唯一标识此次审核任务的 JobId
string JobId = "xxx";
/// 查询审核任务结果
m.GetDocumentCensorJobResult(JobId);
}
}
}

说明:
更多完整示例,请前往 GitHub 查看。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈