数据万象
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 数据万象 > SDK 文档 > COS iOS SDK > 内容审核 > 文本审核

文本审核

最近更新时间：2023-08-31 18:02:14

我的收藏

本页目录：

简介

内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。
说明
使用内容审核服务需拥有数据万象使用权限：
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
本文档提供关于文本审核的相关的 API 概览以及 SDK 示例代码。
API
操作描述
用于提交一个文本审核任务
用于查询指定的文本审核任务
您可通过本接口反馈与预期不符的审核结果，例如色情文本被审核判定为正常或正常文本被判定为色情时可通过该接口直接反馈
本接口不会直接修改审核结果，您反馈的错误审核结果将在后台进行确认，并在后续的审核任务中生效

SDK API 参考

SDK 所有接口的具体参数与方法说明，请参见 SDK API。

创建任务

功能说明

QCloudPostTextRecognitionRequest 接口用于提交一个文本审核任务。您可以通过主动设置回调地址接收审核信息，也可以通过 JobId 进行查询。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。

请求示例

Objective-C
QCloudPostTextRecognitionRequest * request = [[QCloudPostTextRecognitionRequest alloc]init];

// content:纯文本信息
// object:对象键，是对象在 COS 上的完整路径，如果带目录的话，格式为 "dir1/object1"
// url:文本文件的完整链接
// 单次请求只能使用 Object 、Content、Url 中的一个。
// 当选择 Object、Url 时，审核结果为异步返回，可通过 查询文本审核任务结果 API 接口获取返回结果。
// 当选择 Content 时，审核结果为同步返回，可通过 响应体 查看返回结果。
request.content = @"文本内容";

// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

// 文件所在地域
request.regionName = @"regionName";

// 审核策略，不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345
request.bizType = @"bizType";

request.finishBlock = ^(QCloudPostTextRecognitionResult * outputObject, NSError *error) {
    // outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看  API 文档或者 SDK 源码
    // QCloudPostTextRecognitionResult 类；
};
[[QCloudCOSXMLService defaultCOSXML] PostTextRecognition:request];
说明
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudPostTextRecognitionRequest();

// content:纯文本信息
// object:COS 存储桶中的文本文件名称
// url:文本文件的完整链接
// 单次请求只能使用 Object 、Content、Url 中的一个。
// 当选择 Object、Url 时，审核结果为异步返回，可通过 查询文本审核任务结果 API 接口获取返回结果。
// 当选择 Content 时，审核结果为同步返回，可通过 响应体 查看返回结果。
request.content = "文本内容";

// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

// 审核策略，不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345
request.bizType = "bizType";

// 文件所在地域
request.regionName = "regionName";

// 审核策略，不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345
request.setFinish { outputObject, error in
    // outputObject 提交审核反馈信息 包含用于查询的 job id，详细字段请查看 API 文档或者 SDK 源码
    // QCloudPostTextRecognitionResult 类；
}
QCloudCOSXMLService.defaultCOSXML().postTextRecognition(request);
说明
更多完整示例，请前往 GitHub 查看。

查询任务

功能说明

QCloudGetTextRecognitionRequest 接口用于查询指定的文本审核任务。您可以根据文本审核任务的 JobId 来查询文本审核结果。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。

请求示例

Objective-C
QCloudGetTextRecognitionRequest * request = [[QCloudGetTextRecognitionRequest alloc]init];

// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";

// 文件所在地域
request.regionName = @"regionName";

// QCloudPostTextRecognitionRequest接口返回的jobid
request.jobId = @"jobid";

request.finishBlock = ^(QCloudTextRecognitionResult * outputObject, NSError *error) {
    // outputObject 审核结果 包含用于查询的 job id，详细字段请查看 API 文档或者 SDK 源码
    // QCloudTextRecognitionResult 类；
};
[[QCloudCOSXMLService defaultCOSXML] GetTextRecognition:request];
说明
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudGetTextRecognitionRequest();

// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000";

// 文件所在地域
request.regionName = "regionName";

// QCloudPostTextRecognitionRequest 接口返回的 jobid
request.jobId = "jobid";

request.setFinish { outputObject, error in
    // outputObject 审核结果 包含用于查询的 job id，详细字段请查看 API 文档或者 SDK源码
    // QCloudTextRecognitionResult 类；
};
QCloudCOSXMLService.defaultCOSXML().getTextRecognition(request);
说明
更多完整示例，请前往 GitHub 查看。

文本审核结果反馈

功能说明

您可通过本接口反馈与预期不符的审核结果，例如色情文本被审核判定为正常或正文本被判定为色情时可通过该接口直接反馈。
注意：
COS iOS SDK 版本需要大于等于 v6.2.5。

示例代码

Objective-C
QCloudPostTextAuditReportRequest * request = [QCloudPostTextAuditReportRequest new]; 
// 存储桶名称，格式为 BucketName-APPID
request.bucket = @"examplebucket-1250000000";
// 文件所在地域
request.regionName = @"regionName";
QCloudPostTextAuditReport * input = [QCloudPostTextAuditReport new];
input.ContentType = 1;
input.Label = @"Label";
input.SuggestedLabel = @"Normal";
request.input = input;
[request setFinishBlock:^(QCloudPostTextAuditReportResult * _Nullable result, NSError * _Nullable error) {
  /// result 文本审核结果反馈 ，详细字段请查看 API 文档或者 SDK 源码
}];
[[QCloudCOSXMLService defaultCOSXML] PostTextAuditReport:request];
说明：
更多完整示例，请前往 GitHub 查看。
Swift
let request = QCloudPostTextAuditReportRequest()
// 存储桶名称，格式为 BucketName-APPID
request.bucket = "examplebucket-1250000000"
// 文件所在地域
request.regionName = "regionName"
let input = QCloudPostTextAuditReport()
input.contentType = 1
input.label = "Label"
input.suggestedLabel = "Normal"
request.input = input
request.finishBlock = { result, error in
  /// result 文本审核结果反馈 ，详细字段请查看 API 文档或者 SDK 源码
}
QCloudCOSXMLService.defaultCOSXML().postTextAuditReport(request)
说明：
更多完整示例，请前往 GitHub 查看。

中国站