智能多媒体 API

  • 图片鉴暴恐

    最近更新时间:2017-09-27 14:30:03

    用户通过图片鉴暴恐接口qterror对存储在七牛云 bucket(目前仅支持华东 bucket)或 非七牛云 bucket 的图片进行智能识别,得到图片是属于暴恐还是正常的分类检测结果。我们返回的结果中还包含图片属于此分类的概率值,概率值越高,表示属于此类的概率越大。

    用户可以根据返回结果中review字段的值来确定是否需要人工审核,true表示需要人工审核,false表示不需要人工审核。暴恐识别模型对疑似涉嫌暴恐信息的图片零容忍。

    1. 使用方式

    图片鉴暴恐接口支持对存储在七牛云 bucket(目前仅支持华东 bucket)或 非七牛云 bucket的图片进行暴恐识别。目前支持的图片格式有 png、jpg 和 bmp。

    1.1 存储在七牛云 bucket 的图片

    开发者使用图片鉴暴恐功能之前,需要先注册七牛云账号,并把图片上传到七牛云 bucket,具体操作步骤如下:

    打开七牛云官网,点击注册,个人账号或企业账号均可。注册成功后,登录七牛云开发者平台。如果已有账号,请直接登录七牛云开发者平台

    创建七牛云 bucket,如果已有 bucket,直接进入七牛云 bucket;

    在七牛云 bucket 上传图片;

    上传成功后,得到图片的URL。

    具体调用步骤

    请求语法

    GET <DownloadURI>?qterror HTTP/1.1
    Host: <DownloadHost>
    

    请求头部

    头部名称 必填 说明
    Host 下载服务器域名,必须为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    {
        // ...鉴暴恐返回值...
    }
    

    响应头部

    头部名称 说明
    Content-Type MIME类型,固定为application/json
    Cache-Control 缓存控制,固定为no-store,不缓存。

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    200 ok
    
    {
         "code":0,
         "message":"success",
         "result":
                 {
                  "label":0,
                  "review":false,
                  "score":1
                 }
    }
    
    字段名称 类型 说明
    code Number 0调用成功;
    message String code对应的状态描述信息
    result Object 每个元素表示每张图片的检测结果:
    score:介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限。
    label:介于0-1间的整数,表示该图像被机器判定为哪个分类,分别对应: 0正常;1暴恐;二种分类的具体解释如下。
    0正常:图片中不具备有暴恐特征的图片。
    1暴恐:图片具有爆炸、血腥、打架斗殴等暴力恐怖主义特征或游行集会内容。注意,恐怖主义组织旗帜也被归入此类。
    review: 是否需要人工复审该图片,鉴黄服务是否对结果确定。true需要false不需要

    示例

    第一步

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

    第二步

    在您的图片的 url 后面加上 ?qterror 例如:https://odum9helk.qnssl.com/resource/gogopher.jpg?qterror

    返回的结果(内容经过格式化方便阅读):

    {
             "code":0,
             "message":"success",
             "result":
                     {
                     "label":0,
                     "review":false,
                     "score":0.99999535
                     }
    }
    

    1.2 非七牛云 bucket 的图片

    该方法支持对非七牛云 bucket 的图片进行高性能的鉴暴恐。

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

    请求语法

    POST /v1/terror HTTP/1.1
    Host: argus.atlab.ai
    Content-Type: application/json
    Authorization: Qiniu <AccessKey>:<Sign>
    
    {
        "data": {
            "uri": "https://odum9helk.qnssl.com/resource/gogopher.jpg"
        }
    }
    

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

    响应语法

    {
             "code":0,
             "message":"success",
             "result":
                     {
                     "label":0,
                     "review":false,
                     "score":0.99999535
                     }
    }
    
    字段名称 类型 说明
    code Number 处理状态:0调用成功;
    message String code对应的状态描述信息
    result Object 每个元素表示每张图片的检测结果:
    score:介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限。
    label:介于0-1间的整数,表示该图像被机器判定为哪个分类,分别对应: 0正常;1暴恐;二种分类的具体解释如下。
    0正常:图片中不具备有暴恐特征的图片。
    1暴恐:图片具有爆炸、血腥、打架斗殴等暴力恐怖主义特征或游行集会内容。注意,恐怖主义组织旗帜也被归入此类。
    review: 是否需要人工复审该图片,鉴黄服务是否对结果确定。true需要false不需要

    示例

    POST /v1/terror HTTP/1.1
    Host: argus.atlab.ai
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "data": {
            "uri": "https://odum9helk.qnssl.com/resource/gogopher.jpg"
        }
    }
    

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

    返回结果(内容经过格式化以便阅读):

    {
             "code":0,
             "message":"success",
             "result":
                     {
                     "label":0,
                     "review":false,
                     "score":0.99999535
                     }
    }
    

    2. 服务价格

    图片鉴暴恐是一项收费服务,七牛云 bucket 的图片和非七牛云 bucket 的图片调用图片鉴暴恐的价格一样,具体价格如下。

    总调用量P 确定部分 不确定部分
    单位:万张 单价(元/百张) 单价(元/百张)
    P < = 300 0.23 0.0625
    300 < P <=1500 0.21 0.0575
    1500 < P <= 3000 0.19 0.0525
    P > 3000 0.16 0.045

    注意:

    • 确定部分:可信度高,无需review(返回数据中review为false)。
    • 不确定部分:需要人工 review,但根据返回的参考值排序可以大大降低工作量(返回数据中review为true)。

    计费示例

    某公司2015年5月使用七牛图片鉴暴恐服务,共发起500万张鉴暴恐请求, 其中结果确定的图片为480万张,结果不确定的图片为20万张,则当月使七牛鉴暴恐服务产生的费用为:

    确定的结果产生费用:0.23元/百张 300万张 + 0.21元/百张 (480万张 - 300万张) = 6900元 + 3780元 = 10680元

    不确定的结果产生费用:0.0625元/百张 * 20万次 = 125元

    总计费用:10680元 + 125元 = 10805元

    以上内容是否对您有帮助?
  • 提交工单