API调用图片鉴暴恐v1(不推荐)
用户通过图片鉴暴恐接口qterror
对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的图片进行智能识别,得到图片是属于暴恐还是正常的分类检测结果。暴恐识别模型对疑似涉嫌暴恐信息的图片零容忍。
返回结果包含图片暴恐分类结果、属于此分类的概率值并判断是否需要人工审核。其中概率值越高,表示属于此类的概率越大。用户可以根据返回结果中review
字段的值来确定是否需要人工审核,true
表示需要人工审核,false
表示不需要人工审核。也可以根据您的业务需求,使用概率值score
确定需要人工复审的界限。
接入前准备
1. 申请七牛账号
请用户打开七牛云官网,点击注册,个人账号或企业账号均可。我们会在一个工作日内完成实名认证。注册成功后,登录七牛云开发者平台。
2. 获取图片 url
存储在七牛云 bucket 的图片
具体操作步骤如下:
1.如果用户未将图片上传到七牛云 bucket,请根据对象存储快速入门建立 bucket 并将图片上传。
2.获取单个文件 url:
点击“复制外链”获取选定图片 url3.批量获取文件 url 可通过命令行工具来完成。
非七牛云 bucket 的图片
请用户获取自己的图片 url。
请求说明
1. 存储在七牛云 bucket 的图片
该方法对存储在七牛云 bucket(支持华东、华北和华南 bucket)的图片进行智能高性能的鉴暴恐。
请求方式: GET请求语法
GET <DownloadURI>?qterror HTTP/1.1
Host: <DownloadHost>
请求Header
Header | 说明 |
---|---|
Host | 下载服务器域名,必须为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程 |
参数 | 说明 |
---|---|
<DownloadURI> | 图片 url |
注意: 此方法默认不返回暴恐的详细分类,若需返回详细分类请使用针对非七牛云 bucket 图片的调用方法。
请求示例第一步 获取图片 url
获取到您存在七牛 bucket 里面的图片的 url。 例如:https://dn-odum9helk.qbox.me/resource/gogopher.jpg
第二步 调用服务
在您的图片的 url 后面加上 ?qterror 例如:https://dn-odum9helk.qbox.me/resource/gogopher.jpg?qterror
调用示例代码:
curl https://dn-odum9helk.qbox.me/resource/gogopher.jpg?qterror
2. 非七牛云 bucket 的图片
该方法支持对非七牛云 bucket 的图片进行高性能的鉴暴恐。
注: 此方法也支持对七牛云 bucket 的单张图片进行鉴暴恐。
请求方式: POST请求url: http://ai.qiniuapi.com/v1/terror
请求Header
字段 | 取值 |
---|---|
Content-Type | application/json |
Authorization | Qiniu <AccessKey>:<Sign> 注意: 用户请根据 AccessKey 和 SecretKey 生成鉴权,以便进行身份验证。<Sign> 的取值请参考七牛鉴权 |
字段 | 类型 | 是否必选 | 说明 |
---|---|---|---|
uri | string | Y | 图片资源。支持两种资源表达方式: 1. 网络图片URL地址; 2. 图片 base64 编码字符串,需在编码字符串前加上前缀 data:application/octet-stream;base64, 例:data:application/octet-stream;base64,xxx |
params.detail | bool | N | 是否返回暴恐的详细分类。true 表示返回详细分类结果,false 表示不返回详细分类结果。默认是false |
POST /v1/terror HTTP/1.1
Host: ai.qiniuapi.com
Content-Type: application/json
Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
{
"data": {
"uri": "https://dn-odum9helk.qbox.me/resource/gogopher.jpg"
},
"params":{
"detail": true
}
}
注意:请把 Authorization 换成您的账号七牛鉴权 QiniuToken。
返回说明
返回参数
字段 | 类型 | 说明 |
---|---|---|
code | int | 0 调用成功 |
message | string | 与code 对应的状态描述信息 |
result.label | int | 介于0-1间的整数,表示该图像被机器判定为哪个分类,分别对应: 0 正常;1 暴恐;二种分类的具体解释如下: 0 正常:图片中不具备有暴恐特征的图片 1 暴恐:图片具有爆炸、血腥、打架斗殴等暴力恐怖主义特征或游行集会内容。注意,恐怖主义组织旗帜也被归入此类 |
result.class | string | 暴恐的详细分类,指定 detail=true 的情况下返回;分类包括血腥bloodiness 、自焚self_burning 、斩首类beheaded 、人群聚集类march_crowed 、警民冲突fight_police 、民众肢体接触fight_person 、违规旗帜类illegal_flag 、刀knives 、枪guns 、特殊字符文字(主要为阿拉伯语,不支持藏语)special_characters 、 动漫血腥类anime_bloodiness 、特殊着装special_clothing 、二次元刀anime_knives 以及二次元枪anime_guns |
result.review | bool | 是否需要人工复审该图片,暴恐服务是否对结果确定。true 需要false 不需要 |
result.score | float | 表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限 |
HTTP/1.1 200 OK
Content-Type: application/json
{
"code":0,
"message":"success",
"result":
{
"label":1,
"class":"march_banner",
"review":false,
"score":0.99999535,
}
}
审核文件适用规格
可处理的图片文件:
- 图片大小不超过10M
- 图片尺寸大于32x32,小于5000x5000
- RGB通道数为3和3以内的图片,不能包含alpha通道
- 图片格式支持 png、jpg、jpeg、bmp、webp、tif 和 gif,多帧图片格式将会取首帧进行审核
服务价格
每月提供账单,按当月的使用量进行阶梯收费。
内容审核产品的新用户会获得一次性18万免费额度,其中鉴黄、鉴暴恐和政治人物识别各6万。如果是本月15号(包括15号)之前开始使用内容审核,免费额度会在本月生效,如果是本月15号之后开始使用内容审核,免费额度会在下月生效。免费额度的周期为月,当月结束后会清零。每个用户最多只能获得一次免费额度,当月使用量在免费额度内,不收费;如超出免费额度,对超出部分收费。
内容审核计费修改为采用调用总量,不再单独以审核结果“确定”和“不确定”计费,主要原因是“不确定”的量一般比较少,并且采用调用总量的单价有大幅降低。
每月总调用量P | 机审+人审价格(单位:元/百张) |
---|---|
第 0 张 至 300 万张 | 0.155 |
第 300 万张 至 1500 万张 | 0.145 |
第 1500 万张 至 3000 万张 | 0.125 |
3000 万至1亿张 | 0.115 |
1 亿张以上 | 0.1 |
计费示例
用户一个月的调用量为 506 万次,扣减免费额度后,总调用量为 500 万次,账单金额约为:
300 万张 * 100 * 0.085 元/百张 +200 万张 * 100 * 0.075元/百张 = 4050元