智能多媒体 API

  • 图片鉴黄

    最近更新时间:2018-09-20 17:32:11

    用户通过图片鉴黄接口qpulp对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的图片进行智能识别,得到图片是属于色情、性感还是正常的分类检测结果。

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

    应用场景


    图片鉴黄

    可以对UGC内容的网站、APP在海量的图片中准确迅速定位不良内容,告别传统人工审核时代,节省企业成本。

    也可以对上线存量业务图片进行全面的鉴黄审核,排除不良内容。

    视频鉴黄

    在直播使用场景中,平台上有大量直播房间,人工鉴黄成本高,并且可能存在人为疏忽和间断,一旦发现违规内容,对于平台的影响巨大,采用直播视频截帧+图片鉴黄的方式,从截图中迅速找出可疑直播线路,然后使用少量人力完成二次审核并进行相应处理,保障平台安全。

    在点播及短视频使用场景中,UGC 平台上大量的用户上传的短视频,采用人工鉴黄成本高,效率低,并存在漏检风险,采用视频截帧+图片鉴黄的方式,迅速定位违规视频,并及时处理,规避政策风险。

    接入前准备


    1. 申请七牛账号

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

    2. 获取图片 url

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

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

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

    请求说明


    1. 存储在七牛云 bucket 的图片

    该方法对存储在七牛云 bucket(支持华东、华北和华南 bucket)的图片进行智能高性能的鉴黄。

    请求方式: GET
    请求语法
    GET <DownloadURI>?qpulp HTTP/1.1
    Host: <DownloadHost>
    
    请求Header
    Header 说明
    Host 下载服务器域名,必须为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程
    请求参数
    参数 说明
    <DownloadURI> 图片 url
    请求示例

    第一步 获取图片 url

    获取到您存在七牛 bucket 里面的图片的 url。 例如:https://mars-assets.qnssl.com/resource/gogopher.jpg

    第二步 调用服务

    在您的图片的 url 后面加上 ?qpulp 例如:https://mars-assets.qnssl.com/resource/gogopher.jpg?qpulp

    调用示例代码:

    curl https://mars-assets.qnssl.com/resource/gogopher.jpg?qpulp
    

    2. 非七牛云 bucket 的图片

    该方法能对非七牛云 bucket 的单张图片进行高性能的鉴黄,支持输入图片的 url 和 base64 的二进制文件形式。

    注: 此方法也支持对七牛云 bucket 的单张图片进行鉴黄。

    请求方式: POST
    请求urlhttp://ai.qiniuapi.com/v1/pulp
    请求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
    请求示例
    POST /v1/pulp HTTP/1.1
    Host: ai.qiniuapi.com
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "data": {
            "uri": "http://7xlv47.com1.z0.glb.clouddn.com/pulpsexy.jpg"
        }
    }
    
    

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

    返回说明


    返回参数
    字段 类型 说明
    code int 处理状态:0调用成功
    message string code对应的状态描述信息
    result.label int 介于0-2间的整数,表示该图像被判定为哪个分类,分别对应: 0色情;1性感;2正常,三种分类的具体解释如下:
    0色情:有明显的敏感部分裸露的图片,血腥图片,描述性交行为的体位或姿势和色情场景的图片。注意,儿童色情的内容,也被归为0
    1性感:衣着暴露但没有裸露敏感部位。次类跨度比较大,从露出皮肤较多的图片到性感写真、诱惑自拍等,区分0和1最重要的规则为是否有裸露敏感部位。注意,孕妇自拍露肚子的图也被归为了1
    2正常:非色情,非性感图片
    result.review bool 是否需要人工复审该图片。true需要false不需要
    result.score float 表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限
    返回示例
    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
         "code":0,
         "message":"",
         "result":
                 {
                 "label":1,
                 "review":false,
                 "score":0.9999392
                 }
    }
    

    审核文件适用规格


    可处理的图片文件:

    1. 图片大小不超过10M
    2. 图片尺寸不小于32x32,不超过4999x4999
    3. RGB通道数为3和3以内的图片,不能包含alpha通道
    4. 图片格式支持 png、jpg、jpeg、bmp、webp 和 gif
    以上内容是否对您有帮助?
  • Icon free helper
    Close