简介
本文档提供关于图片审核相关的 API 概览以及 SDK 示例代码。
API | 操作描述 |
对对象存储(Cloud Object Storage,COS)存量数据进行涉黄、违法违规以及广告引导类图片的扫描 | |
对多个图片进行批量审核 | |
本接口用于主动查询指定的图片审核任务结果 | |
您可通过本接口反馈与预期不符的审核结果,例如色情图片被审核判定为正常或正常图片被判定为色情时可通过该接口直接反馈 |
SDK API 参考
图片同步审核
功能说明
QCloudSyncImageRecognitionRequest 接口用于提交一个图片审核任务。您可以通过主动设置回调地址接收审核信息,也可以通过 Jobid 进行查询。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。
请求示例
Objective-C
QCloudSyncImageRecognitionRequest * request = [[QCloudSyncImageRecognitionRequest alloc]init];// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"bucket";// 文件所在地域request.regionName = @"regionName";// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"request.object = @"***.jpg";// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345request.bizType = @"bizType";[request setFinishBlock:^(QCloudImageRecognitionResult * _Nullable result, NSError * _Nullable error) {// outputObject 提交审核反馈信息,详细字段请查看 API 文档或者 SDK 源码// QCloudImageRecognitionResult 类;}];[[QCloudCOSXMLService defaultCOSXML] SyncImageRecognition:request];
说明
Swift
let request : QCloudSyncImageRecognitionRequest = QCloudSyncImageRecognitionRequest();// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = "bucket";// 文件所在地域request.regionName = "regionName";// 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"request.object = "***.jpg";// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345request.bizType = "bizType";request.finishBlock = { (result, error) in// outputObject 提交审核反馈信息,详细字段请查看 API 文档或者 SDK 源码// QCloudImageRecognitionResult 类;}QCloudCOSXMLService.defaultCOSXML().syncImageRecognition(request);
说明
图片批量审核
功能说明
图片批量审核接口为同步请求方式,您可以通过本接口对多个图片文件进行内容审核。该接口属于 POST 请求。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。
请求示例
Objective-C
QCloudBatchimageRecognitionRequest * request = [[QCloudBatchimageRecognitionRequest alloc]init];request.bucket = @"bucket";// 文件所在地域request.regionName = @"regionName";NSMutableArray * input = [NSMutableArray new];// 待审核的图片对象QCloudBatchRecognitionImageInfo * input1 = [QCloudBatchRecognitionImageInfo new];input1.Object = @"***.jpg";[input addObject:input1];QCloudBatchRecognitionImageInfo * input2 = [QCloudBatchRecognitionImageInfo new];input2.Object = @"***.jpg";[input addObject:input2];// 待审核的图片对象数组request.input = input;// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345request.bizType = @"bizType";[request setFinishBlock:^(QCloudBatchImageRecognitionResult * _Nullable result, NSError * _Nullable error) {// outputObject 审核结果,详细字段请查看 API 文档或者 SDK 源码// QCloudBatchImageRecognitionResult 类;}];[[QCloudCOSXMLService defaultCOSXML] BatchImageRecognition:request];
说明
Swift
let request = QCloudBatchimageRecognitionRequest();request.bucket = "bucket";// 文件所在地域request.regionName = "regionName";// 待审核的图片对象let input1 = QCloudBatchRecognitionImageInfo();input1.object = "***.jpg";let input2 = QCloudBatchRecognitionImageInfo();input2.object = "***.jpg";// 待审核的图片对象数组request.input = [input1,input2];// 审核策略,不带审核策略时使用默认策略。具体查看 https://cloud.tencent.com/document/product/460/56345request.bizType = "bizType";request.setFinish { outputObject, error in// outputObject 审核结果,详细字段请查看 API 文档或者 SDK 源码// QCloudBatchImageRecognitionResult 类;}QCloudCOSXMLService.defaultCOSXML().batchImageRecognition(request);
说明
查询图片审核任务结果
功能说明
QCloudGetImageRecognitionRequest 本接口用于主动查询指定的图片审核任务结果。您可以根据图片同步审核或批量审核任务的 JobId 来查询图片审核结果。
注意
COS iOS SDK 版本需要大于等于 v6.0.9。
请求示例
Objective-C
QCloudGetImageRecognitionRequest * request = [[QCloudGetImageRecognitionRequest alloc]init];// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// 文件所在地域request.regionName = @"regionName";// 同步审核或批量审核返回结果的jobidrequest.jobId = @"jobid";request.finishBlock = ^(QCloudImageRecognitionResult * outputObject, NSError *error) {// outputObject 审核结果 包含用于查询的 job id,详细字段请查看 API 文档或者 SDK 源码// QCloudImageRecognitionResult 类;};[[QCloudCOSXMLService defaultCOSXML] GetImageRecognition:request];
说明
Swift
let request = QCloudGetImageRecognitionRequest();// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = "examplebucket-1250000000";request.regionName = "regionName";// 同步审核或批量审核返回结果的jobidrequest.jobId = "jobid";request.setFinish { outputObject, error in// outputObject 审核结果 包含用于查询的 job id,详细字段请查看API 文档或者 SDK 源码// QCloudWebRecognitionResult 类;};QCloudCOSXMLService.defaultCOSXML().getImageRecognition(request);
说明
图片审核结果反馈
功能说明
您可通过本接口反馈与预期不符的审核结果,例如色情图片被审核判定为正常或正常图片被判定为色情时可通过该接口直接反馈。
注意:
COS iOS SDK 版本需要大于等于 v6.2.5。
示例代码
Objective-C
QCloudPostImageAuditReportRequest * request = [QCloudPostImageAuditReportRequest new];// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";// 文件所在地域request.regionName = @"regionName";QCloudPostImageAuditReport * input = [QCloudPostImageAuditReport new];input.ContentType = 2;input.Label = @"Label";input.SuggestedLabel = @"Normal";request.input = input;[request setFinishBlock:^(QCloudPostImageAuditReportResult * _Nullable result, NSError * _Nullable error) {/// result 审核结果反馈 ,详细字段请查看 API 文档或者 SDK 源码}];[[QCloudCOSXMLService defaultCOSXML] PostImageAuditReport:request];
说明:
Swift
let request = QCloudPostImageAuditReportRequest()// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = "examplebucket-1250000000"// 文件所在地域request.regionName = "regionName"let input = QCloudPostImageAuditReport()input.contentType = 2input.label = "Label"input.suggestedLabel = "Normal"request.input = inputrequest.finishBlock = { result, error in/// result 结果反馈 ,详细字段请查看 API 文档或者 SDK 源码}QCloudCOSXMLService.defaultCOSXML().postImageAuditReport(request)
说明: