API调用图片审核v1(不推荐)
图片审核接口融合了图片鉴黄、图片鉴暴恐和敏感人物识别三项功能,用户通过同步图片审核接口/v1/image/censor
对存储在七牛云 bucket(支持华东、华北和华南 bucket)或 非七牛云 bucket 的图片进行智能识别,可得到图片涉黄,暴恐以及敏感人物共三个维度的检测结果。
功能描述
返回结果中针对每一类检测,包含图片分类结果、属于此分类的概率值并判断是否需要人工审核。其中概率值越高,表示属于此类的概率越大。用户可以根据返回结果中review
字段的值来确定是否需要人工审核,true
表示需要人工审核,false
表示不需要人工审核。也可以根据您的业务需求,使用概率值score
确定需要人工复审的界限。
关于审核图片的规格
- 图片大小不超过10M
- 图片尺寸大于32x32,小于5000x5000
- RGB通道数为3和3以内的图片,不能包含 alpha 通道
- 图片格式支持 png、jpg、jpeg、bmp、webp、tif 和 gif
- 接口响应时间依赖图片的下载时间。请保证被审核图片所在的存储服务稳定可靠,建议您使用七牛云存储或者CDN缓存等。
请求说明
请求方式: POST
请求url: http://ai.qiniuapi.com/v1/image/censor
请求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.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 | 指定的审核类型对应的label结果分类参数,具体label/group请参见图片内容审核 |
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
}
}
]
}
]
}
}
服务价格
每月提供账单,按当月的使用量进行阶梯收费。
内容审核产品的新用户会获得一次性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元