tencent cloud

文档反馈

图片审核

最后更新时间:2024-01-19 16:15:11

    简介

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

    图片同步审核

    功能说明

    图片审核的存量扫描功能通过借助数据万象的持久化处理接口,实现对 COS 存量数据的涉黄、违法违规以及广告引导类图片的扫描。

    使用示例

    var config = {
    // 需要替换成您自己的存储桶信息
    Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
    Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
    };
    function getImageAuditing() {
    cos.request({
    Bucket: config.Bucket,
    Region: config.Region,
    Method: 'GET',
    Key: '1.png', /* 存储桶内的图片文件,必须字段 */
    Query: {
    'ci-process': 'sensitive-content-recognition', /** 固定值,必须 */
    'biz-type': '', /** 审核类型,非必须 */
    'detect-type': 'porn,ads', /** 审核策略,不填写则使用默认策略,非必须 */
    'detect-url': '', /** 审核任意公网可访问的图片链接,非必须 */
    'interval': 5, /** 审核 GIF 动图时,每隔interval帧截取一帧,非必须 */
    'max-frames': 5, /** 审核 GIF 动图时,最大截帧数,非必须 */
    'large-image-detect': '0', /** 是否需要压缩图片后再审核,非必须 */
    'dataid': '123', /** 自定义图片标识,非必须 */
    },
    },
    function(err, data){
    console.log(err || data);
    });
    }

    参数说明

    Query 中的具体数据描述如下:
    节点名称(关键字)
    父节点
    描述
    类型
    是否必选
    biz-type
    Query
    审核策略,不填写则使用默认策略。可在控制台进行配置,详情请参见 设置公共审核策略
    String
    detect-type
    Query
    审核类型审核类型,porn(涉黄识别)、ads(广告识别)。可选择多种识别类型用 , 连接。
    String
    object-key
    Query
    图片文件在 bucket 中的位置。
    String
    detect-url
    Query
    您可以通过填写 detect-url 审核任意公网可访问的图片链接。
    不填写 detect-url 时,后台会默认审核 ObjectKey
    填写 detect-url 时,后台会审核 detect-url 链接,无需再填写 ObjectKey
    detect-url 示例:http://www.example.com/abc.jpg
    String
    interval
    Query
    审核 GIF 动图时,可使用该参数进行截帧配置,代表截帧的间隔。例如值设为5,则表示从第1帧开始截取,每隔5帧截取一帧,默认值5
    Int
    max-frames
    Query
    针对 GIF 动图审核的最大截帧数量,需大于0。例如值设为5,则表示最大截取5帧,默认值为5。
    Int
    large-image-detect
    Query
    对于超过大小限制的图片是否进行压缩后再审核,取值为:0(不压缩),1(压缩)。默认为0。
    注:压缩最大支持32M的图片,且会收取压缩费用。
    String
    dataid
    Query
    图片标识,该字段在结果中返回原始内容,长度限制为512字节。
    String

    返回结果说明

    详情请参见 图片同步审核

    图片批量审核

    功能说明

    图片批量审核接口为同步请求方式,您可以通过本接口对多个图片文件进行内容审核。该接口属于 POST 请求。

    请求示例

    var config = {
    // 需要替换成您自己的存储桶信息
    Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
    Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
    };
    function postImagesAuditing() {
    var host = config.Bucket + '.ci.' + config.Region + '.myqcloud.com';
    var url = 'https://' + host + '/image/auditing';
    var body = COS.util.json2xml({
    Request: {
    Input: [{
    Object: '1.png', /* 需要审核的图片,存储桶里的路径 */
    }, {
    Object: 'a/6.png', /* 需要审核的图片,存储桶里的路径 */
    }],
    Conf: {
    BizType: '', /* 不填写代表默认策略 */
    DetectType: 'Porn' /* 只审核是否涉黄 */
    }
    }
    });
    cos.request({
    Bucket: config.Bucket,
    Region: config.Region,
    Method: 'POST',
    Url: url,
    Key: '/image/auditing', /** 固定值,必须 */
    ContentType: 'application/xml', /** 固定值,必须 */
    Body: body
    },
    function(err, data){
    console.log(err || data);
    });
    }

    参数说明

    request的数据描述如下:
    节点名称(关键字)
    父节点
    描述
    类型
    是否必选
    Request
    图片批量审核的具体配置项。
    Container
    Container 类型 Request 的具体数据描述如下:
    节点名称(关键字)
    父节点
    描述
    类型
    是否必选
    Input
    Request
    需要审核的内容,如有多个图片,请传入多个 Input 结构。
    Container Array
    Conf
    Request
    审核规则配置。
    Container
    Container 类型 Input 的具体数据描述如下,使用其中一种:
    节点名称(关键字)
    父节点
    描述
    类型
    是否必选
    Object
    Request.Input
    存储在 COS 存储桶中的图片文件名称,例如在目录 test 中的文件 image.jpg,则文件名称为 test/image.jpg。Object 和 Url 只能选择其中一种。
    String
    Url
    Request.Input
    图片文件的链接地址,例如 http://a-1250000.cos.ap-shanghai.myqcloud.com/image.jpg。Object 和 Url 只能选择其中一种。
    String
    Interval
    Request.Input
    截帧频率,GIF 图检测专用,默认值为5,表示从第一帧(包含)开始每隔5帧截取一帧
    Int
    MaxFrames
    Request.Input
    最大截帧数量,GIF 图检测专用,默认值为5,表示只截取 GIF 的5帧图片进行审核,必须大于0
    Int
    DataId
    Request.Input
    图片标识,该字段在结果中返回原始内容,长度限制为512字节
    String
    Container 类型 Conf 的具体数据描述如下:
    节点名称(关键字)
    父节点
    描述
    类型
    是否必选
    DetectType
    Request.Conf
    审核的场景类型,有效值:Porn(涉黄)、Ads(广告),可以传入多种类型,不同类型以 , 分隔,例如:Porn,Ads。
    String
    BizType
    Request.Conf
    审核策略,不填写则使用默认策略。可在控制台进行配置,详情请参见 设置公共审核策略
    String
    注意
    通过 Object 进行审核为内网操作,不会产生额外的外网流量。
    通过 Url 进行审核,会产生图片所在源站对应的外网流量。

    返回结果说明

    详情请参见 图片批量审核
    联系我们

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

    技术支持

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

    7x24 电话支持