内容审核 > API 文档 > API调用图片审核 > API调用图片审核历史文档 > API调用图片鉴黄v1（不推荐）

API调用图片鉴黄v1（不推荐）

最近更新时间: 2019-07-11 17:55:40

用户通过图片鉴黄接口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
请求url： http://ai.qiniuapi.com/v1/pulp
请求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`

请求示例

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
             }
}

审核文件适用规格

可处理的图片文件：

图片大小不超过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元

以上内容是否对您有帮助？

内容审核