tencent cloud

文档反馈

图片审核

最后更新时间:2024-03-13 10:07:11

    简介

    内容审核功能是由 数据万象(Cloud Infinite,CI)提供的,数据万象将处理能力与 COS SDK 完全结合,您可以直接按照本篇文档指引进行使用。
    说明:
    使用内容审核服务需拥有数据万象使用权限:
    主账号请 单击此处 进行角色授权。
    子账号请参见 授权子账号接入数据万象服务 文档。
    本文档提供关于图片审核相关的 API 概览以及 SDK 示例代码。
    API
    操作描述
    对对象存储(Cloud Object Storage,COS)存量数据进行涉黄、违法违规以及广告引导类图片的扫描
    对多个图片进行批量审核
    本接口用于主动查询指定的图片审核任务结果

    SDK API 参考

    SDK 所有接口的具体参数与方法说明,请参考 SDK API

    图片同步审核

    功能说明

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

    请求示例

    Objective-C
    QCloudSyncImageRecognitionRequest * request = [[QCloudSyncImageRecognitionRequest alloc]init];
    
    // 存储桶名称,格式为 BucketName-APPID
    request.bucket = @"bucket";
    
    // 文件所在地域
    request.regionName = @"regionName";
    
    // 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
    request.object = @"***.jpg";
    
    // 审核类型,拥有 porn(涉黄识别)、ads(广告识别)
    // 用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核
    // 可以使用或进行组合赋值 如: QCloudRecognitionPorn | QCloudRecognitionTerrorist
    request.detectType = QCloudRecognitionPorn | QCloudRecognitionTerrorist | QCloudRecognitionPolitics | QCloudRecognitionAds;
    [request setFinishBlock:^(QCloudImageRecognitionResult * _Nullable result, NSError * _Nullable error) {
    // outputObject 提交审核反馈信息,详细字段请查看api文档或者SDK源码
    // QCloudImageRecognitionResult 类;
    }];
    [[QCloudCOSXMLService defaultCOSXML] SyncImageRecognition:request];
    
    说明:
    更多完整示例,请前往 GitHub 查看。
    Swift
    let request : QCloudSyncImageRecognitionRequest = QCloudSyncImageRecognitionRequest();
    
    // 存储桶名称,格式为 BucketName-APPID
    request.bucket = "bucket";
    
    // 文件所在地域
    request.regionName = "regionName";
    
    // 对象键,是对象在 COS 上的完整路径,如果带目录的话,格式为 "dir1/object1"
    request.object = "***.jpg";
    
    // 审核类型,拥有 porn(涉黄识别)、ads(广告识别)
    // 用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核
    // 可以使用或进行组合赋值 如: QCloudRecognitionPorn | QCloudRecognitionTerrorist
    request.detectType = QCloudRecognitionEnum(rawValue: QCloudRecognitionEnum.porn.rawValue | QCloudRecognitionEnum.ads.rawValue)!
    
    request.finishBlock = { (result, error) in
    // outputObject 提交审核反馈信息,详细字段请查看api文档或者SDK源码
    // QCloudImageRecognitionResult 类;
    }
    QCloudCOSXMLService.defaultCOSXML().syncImageRecognition(request);
    说明:
    更多完整示例,请前往 GitHub 查看。

    图片批量审核

    功能说明

    图片批量审核接口为同步请求方式,您可以通过本接口对多个图片文件进行内容审核。该接口属于 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;
    request.detectType = QCloudRecognitionPorn | QCloudRecognitionTerrorist | QCloudRecognitionPolitics | QCloudRecognitionAds;
    [request setFinishBlock:^(QCloudBatchImageRecognitionResult * _Nullable result, NSError * _Nullable error) {
    // outputObject 审核结果,详细字段请查看api文档或者SDK源码
    // QCloudBatchImageRecognitionResult 类;
    }];
    [[QCloudCOSXMLService defaultCOSXML] BatchImageRecognition:request];
    
    说明:
    更多完整示例,请前往 GitHub 查看。
    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];
    request.detectType = QCloudRecognitionEnum(rawValue: QCloudRecognitionEnum.porn.rawValue | QCloudRecognitionEnum.ads.rawValue)!
    request.setFinish { outputObject, error in
    // outputObject 审核结果,详细字段请查看api文档或者SDK源码
    // QCloudBatchImageRecognitionResult 类;
    }
    QCloudCOSXMLService.defaultCOSXML().batchImageRecognition(request);
    说明:
    更多完整示例,请前往 GitHub 查看。

    查询图片审核任务结果

    功能说明

    QCloudGetImageRecognitionRequest 本接口用于主动查询指定的图片审核任务结果。。您可以根据图片同步审核或批量审核任务的 JobId 来查询图片审核结果。
    注意:
    COS iOS SDK 版本需要大于等于 v6.0.9。

    请求示例

    Objective-C
    QCloudGetImageRecognitionRequest * request = [[QCloudGetImageRecognitionRequest alloc]init];
    
    // 存储桶名称,格式为 BucketName-APPID
    request.bucket = @"examplebucket-1250000000";
    
    // 文件所在地域
    request.regionName = @"regionName";
    
    // 同步审核或批量审核返回结果的jobid
    request.jobId = @"jobid";
    
    request.finishBlock = ^(QCloudImageRecognitionResult * outputObject, NSError *error) {
    // outputObject 审核结果 包含用于查询的job id,详细字段请查看api文档或者SDK源码
    // QCloudImageRecognitionResult 类;
    };
    [[QCloudCOSXMLService defaultCOSXML] GetImageRecognition:request];
    说明:
    更多完整示例,请前往 GitHub 查看。
    Swift
    let request = QCloudGetImageRecognitionRequest();
    
    // 存储桶名称,格式为 BucketName-APPID
    request.bucket = "examplebucket-1250000000";
    
    request.regionName = "regionName";
    
    // 同步审核或批量审核返回结果的jobid
    request.jobId = "jobid";
    
    request.setFinish { outputObject, error in
    // outputObject 审核结果 包含用于查询的job id,详细字段请查看api文档或者SDK源码
    // QCloudWebRecognitionResult 类;
    };
    QCloudCOSXMLService.defaultCOSXML().getImageRecognition(request);
    说明:
    更多完整示例,请前往 GitHub 查看。
    联系我们

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

    技术支持

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

    7x24 电话支持