智能多媒体 API

  • 图片鉴暴恐

    最近更新时间:2018-07-18 20:47:41

    用户通过图片鉴暴恐接口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"
        }
        "params": {
            "detail": true
        }
    }
    

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

    字段名称 类型 说明
    data.uri string 必填参数,图片的外链
    params.detail bool 可选参数,是否返回暴恐的详细分类。true表示返回详细分类结果,false表示不返回详细分类结果。默认是false,不返回详细分类结果。

    响应语法

    {
             "code":0,
             "message":"success",
             "result":
                     {
                     "label":0,
                     "class": normal,
                     "review":false,
                     "score":0.99999535
                     }
    }
    
    字段名称 类型 说明
    code Number 处理状态:0调用成功;
    message String code对应的状态描述信息
    result Object 每个元素表示每张图片的检测结果:
    score:介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限。
    label:介于0-1间的整数,表示该图像被机器判定为哪个分类,分别对应: 0正常;1暴恐;二种分类的具体解释如下。
    0正常:图片中不具备有暴恐特征的图片。
    1暴恐:图片具有爆炸、血腥、打架斗殴等暴力恐怖主义特征或游行集会内容。注意,恐怖主义组织旗帜也被归入此类。
    class: 暴恐的详细分类。包括血腥类bloodiness、爆炸类bomb、斩首类beheaded、游行类march、斗殴类fight、伊斯兰星月旗islamic flag、ISIS旗帜isis flag、藏独旗帜tibetan flag、刀knives、枪guns、正常normal
    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
                     }
    }
    
    以上内容是否对您有帮助?
  • 提交工单