智能多媒体 API

  • 图片审核

    最近更新时间:2018-08-13 12:55:22

    图片审核接口融合了图片鉴黄、图片鉴暴恐和政治人物识别三项功能,用户通过图片审核接口image/censor对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的图片进行智能识别,可得到图片涉黄,暴恐以及政治人物共三个维度的检测结果。我们返回的结果中针对每一类检测,包含图片属于此分类的概率值,概率值越高,表示属于此类的概率越大。

    用户可以根据返回结果中review字段的值来确定是否需要人工审核,true表示需要人工审核,false表示不需要人工审核。也可以根据您的业务需求,使用概率值score确定需要人工复审的界限。

    1. API的使用方式

    图片审核接口支持对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket的图片进行智能识别。目前支持的图片格式有 png、jpg 和 bmp。

    请求语法

    POST /v1/image/censor HTTP/1.1
    Host: argus.atlab.ai
    Content-Type: application/json
    Authorization: Qiniu <AccessKey>:<Sign>
    
    {
        "data": {
            "uri": "http://oayjpradp.bkt.clouddn.com/Audrey_Hepburn.jpg"
        },
        "params": {
            "type": [
                "pulp",
                "terror",
                "politician"
            ],
            "detail": true
        }
    }
    

    注意: 需要在 POST 请求的 head 部分添加七牛鉴权,以进行用户身份验证。

    请求字段说明:

    字段 取值 说明
    uri string 图片资源表示方式:
    1. HTTP, 网络资源,形如:http://host/path,http://host/path
    2. Data,Data URI Scheme形态的二进制文件,形如:data:application/octet-stream;base64,xxx。( 注意:当前只支持前缀为data:application/octet-stream;base64的数据。)
    params.type string 选择的审核类型,可选项:pulp/terror/politician;可选参数,不填表示全部执行
    params.detail string 可选参数,仅当params.type是terror时有效,用于判断是否返回暴恐的详细分类结果。true表示返回详细分类结果,false表示不返回详细分类结果。默认是false,不返回详细分类结果。

    响应语法

    {
        "code": 0,
        "message": "",
        "result": {
            "label": 1,
            "score": 0.8726697,
            "details": [
                {
                    "type": "pulp",
                    "label": 0,
                    "score": 0.8726697,
                    "review": false
                },
                {
                    "type": "terror",
                    "label": 0,
                    "class": normal,
                    "score": 0.6530496,
                    "review": false
                },
                {
                    "type": "politician",
                    "label": 1,
                    "score": 0.77954,
                    "review": True,
                    "more": [
                        {
                            "boundingBox":{
                                "pts": [[1213,400],[205,400],[205,535],[1213,535]],
                                "score":0.998
                            },
                            "value": {
                                "name": "xx",
                                "score":0.567,
                                "review": True
                            },
                            "sample": {
                                "url": "",
                                "pts": [[1213,400],[205,400],[205,535],[1213,535]]
                            }
                        },
                        {
                            "boundingBox":{
                                "pts": [[1109,500],[205,500],[205,535],[1109,535]],
                                "score":0.98
                            },
                            "value": {
                                "score":0.987,
                                "review": False
                            }
                        }
                    ]
                }
            ]
        }
    }
    

    返回字段说明:

    字段 取值 说明
    code int 处理状态:0调用成功
    message string code对应的状态描述信息
    result.label int 是否违规,0:不违规;1:违规。图片被认定为违规的逻辑是:当type=pulp时,label=0(色情)会被认为是违规;当type=terror时,label=1(暴恐)会被认为是违规;当type=politician时,label=1(涉政)会被认为是违规。
    result.score float 是否违规置信度
    result.details.type string 审核类型, 与用户设置的params.type一致,设置了某种审核类型,结果中就应该包含该审核类型的返回信息。不填表示全部执行,则pulp,terror,politician都包含。
    result.details.label int 审核结果类别,具体看各类型。pulp请参考图片鉴黄图片鉴黄;terror请参考图片鉴暴恐;politician请参考图片政治人物识别
    result.details.class string 暴恐的详细分类,具体分类包括血腥类bloodiness、爆炸类bomb、斩首类beheaded、游行类march、斗殴类fight、伊斯兰星月旗islamic flag、ISIS旗帜isis flag、藏独旗帜tibetan flag、刀knives、枪guns、正常normal
    result.details.score float 审核结果置信度
    result.details.review string 是否需要人工复审该图片,鉴黄服务是否对结果确定。true需要false不需要

    说明
    如果您的业务对于图片审核的要求比较严格,认为鉴黄检测出来的性感图片也是违规图片,那么您可以依据一下逻辑过滤出性感图片。
    过滤逻辑为:type=pulp时,label=1

    2. 审核文件限制

    内容审核模块对于能处理的文件有一些限制。

    图片文件的限制:

    1. 图片大小大于10M不能处理
    2. 图片尺寸大于4999x4999,小于32x32不能处理
    3. 图片纬度不等于3不能处理
    以上内容是否对您有帮助?
  • Close