智能多媒体 API

  • 图片审核

    最近更新时间:2018-10-23 17:44:16

    图片审核接口融合了图片鉴黄、图片鉴暴恐和敏感人物识别三项功能,用户通过图片审核接口image/censor对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的图片进行智能识别,可得到图片涉黄,暴恐以及敏感人物共三个维度的检测结果。

    返回结果中针对每一类检测,包含图片分类结果、属于此分类的概率值并判断是否需要人工审核。其中概率值越高,表示属于此类的概率越大。用户可以根据返回结果中review字段的值来确定是否需要人工审核,true表示需要人工审核,false表示不需要人工审核。也可以根据您的业务需求,使用概率值score确定需要人工复审的界限。

    接入前准备


    1. 申请七牛账号

    请用户打开七牛云官网,点击注册,个人账号或企业账号均可。我们会在一个工作日内完成实名认证。注册成功后,登录七牛云开发者平台

    2. 获取图片 url

    • 存储在七牛云 bucket 的图片
      具体操作步骤如下:
      1.如果用户未将图片上传到七牛云 bucket,请根据对象存储快速入门建立 bucket 并将图片上传。
      2.获取单个文件 url:
      点击“复制外链”获取选定图片 url

      3.批量获取文件 url 可通过命令行工具来完成。

    • 非七牛云 bucket 的图片
      请用户获取自己的图片 url。

    请求说明


    请求方式: POST
    请求urlhttp://ai.qiniuapi.com/v1/image/censor
    请求Header
    字段 取值
    Content-Type application/json
    Authorization Qiniu <AccessKey>:<Sign>
    注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权,以便进行身份验证。<Sign>的取值请参考七牛鉴权
    请求参数
    字段 取值 是否必选 说明
    uri string Y 图片资源。支持两种资源表达方式:
    1. 网络图片URL地址;
    2. 图片 base64 编码字符串,需在编码字符串前加上前缀 data:application/octet-stream;base64, 例:data:application/octet-stream;base64,xxx
    params.type string N 选择的审核类型,可选项:pulp/terror/politician。默认选择全部 pulp/terror/politician
    params.detail bool N 仅当 params.type 是terror时有效,用于判断是否返回暴恐的详细分类结果。true表示返回详细分类结果,false表示不返回详细分类结果。默认是false
    请求示例
    POST /v1/image/censor HTTP/1.1
    Host: ai.qiniuapi.com
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "data": {
            "uri": "http://oayjpradp.bkt.clouddn.com/Audrey_Hepburn.jpg"
        },
        "params": {
            "type": [
                "pulp",
                "terror",
                "politician"
            ],
            "detail": true
        }
    }
    

    注意: 请把 Authorization 换成您的账号七牛鉴权 QiniuToken。

    返回说明


    返回参数
    字段 取值 说明
    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.review bool 整体审核结果是否需要人工复审该图片。true需要false不需要
    result.details.type string 审核类型,与用户设置的params.type一致,结果中包含该审核类型的返回结果
    result.details.label int 审核结果,具体看各类型。pulp请参考图片鉴黄图片鉴黄terror请参考图片鉴暴恐politician请参考图片敏感人物识别
    result.details.class string 暴恐的详细分类,请参考图片鉴暴恐
    result.details.more list 当审核类型是politician时,返回人脸的具体信息,请参考图片敏感人物识别
    result.details.score float 审核结果置信度
    result.details.review string 针对每项审核类型的结果是否需要人工复审该图片。true需要false不需要

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

    返回示例
    {
        "code": 0,
        "message": "",
        "result": {
            "label": 1,
            "score": 0.8726697,
            "review": false,
            "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
                            }
                        }
                    ]
                }
            ]
        }
    }
    

    审核文件适用规格


    可处理的图片文件:

    1. 图片大小不超过10M
    2. 图片尺寸大于32x32,小于5000x5000
    3. RGB通道数为3和3以内的图片,不能包含 alpha 通道
    4. 图片格式支持 png、jpg、jpeg、bmp、webp 和 gif

    服务价格


    • 每月提供账单,按当月的使用量进行阶梯收费。

    • 内容审核产品的新用户会获得一次性18万免费额度,其中鉴黄、鉴暴恐和政治人物识别各6万。如果是本月15号(包括15号)之前开始使用内容审核,免费额度会在本月生效,如果是本月15号之后开始使用内容审核,免费额度会在下月生效。免费额度的周期为月,当月结束后会清零。每个用户最多只能获得一次免费额度,当月使用量在免费额度内,不收费;如超出免费额度,对超出部分收费。

    • 内容审核计费修改为采用调用总量,不再单独以审核结果“确定”和“不确定”计费,主要原因是“不确定”的量一般比较少,并且采用调用总量的单价有大幅降低。

    图片审核接口根据实际调用的服务单独收费,例如,调用图片审核接口时,同时做了图片鉴黄、鉴暴恐和政治人物识别,那么最终的价格是按照单个服务的价格总和。

    例:
    用户一个月调用图片审核,同时使用了图片鉴黄、图片鉴暴恐和图片政治人物识别,其调用量为506万次,各服务扣减免费6万额度后,账单金额为:
    图片鉴黄:

    3000000*0.155/100+2000000*0.145/100=4650+2900=7550元

    图片鉴暴恐:

    3000000*0.155/100+2000000*0.145/100=4650+2900=7550元

    图片政治人物识别:

    3000000*0.155/100+2000000*0.145/100=4650+2900=7550元

    总价为:

    7550+7550+7550=22650元

    以上内容是否对您有帮助?
  • Icon free helper
    Close