图片鉴黄服务接口协议
请求
请求报文格式
GET <DownloadURI>?nrop HTTP/1.1
Host: <DownloadHost>
请求头部
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 下载服务器域名,可为七牛三级域名或自定义二级域名,参考域名绑定 |
响应
响应报文格式
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store
{
// ...nrop data...
}
响应头部
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | MIME类型,固定为application/json |
Cache-Control | 是 | 缓存控制,固定为no-store,不缓存 |
响应内容
■ 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"code": "<ResultCode int>",
"message": "<ResultMessage string>",
"fileList": [
{
"rate": <Rate float>,
"label": <Category int>,
"name": "<FileName string>",
"review": <Review boolean>
}
],
"statistic": [
<Statistics int>,
...
],
"reviewCount": <ReviewCount int>,
"nonce": "<Nonce string>",
"timestamp": "<Timestamp string>"
}
字段名称 | 必填 | 说明 |
---|---|---|
code |
是 | 处理状态(0:调用成功; 1:授权失败; 2:模型ID错误; 3:没有上传文件; 4:API版本号错误; 5:API版本已弃用; 6:secretId 错误; 7:任务Id错误,您的secretId不能调用该任务; 8:secretId状态异常; 9:尚未上传证书; 100:服务器错误; 101:未知错误) |
message |
是 | 与code 对应的状态描述信息 |
fileList |
否 | 鉴别的图片文件列表 |
rate |
是 | 介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高、机器越肯定;您可以根据您的需求确定需要人工复审的界限。 |
label |
是 | 介于0-2间的整数,表示该图像被机器判定为哪个分类,分别对应: 0:色情; 1:性感; 2:正常 |
name |
是 | 鉴别图片文件的文件名 |
review |
是 | 是否需要人工复审该图片 |
statistic |
否 | 图像机器判定结果统计数组,分别对应判定为0-3的数据总量 |
callRecordId |
否 | 调用的唯一标识符,用于后续的人工复审的结果反馈 |
APIVersion |
是 | API的版本 |
reviewCount |
否 | 需要人工复审的图片数量 |
nonce |
是 | 随机数 |
timestamp |
是 | 当前的服务器的Unix时间,UTC格式时间字符串 |
■ 如果请求失败,请参考以上code
和message
字段的说明。
示例
在Web浏览器中输入以下图片地址:
http://qiniuphotos.qiniudn.com/gogopher.jpg?nrop
返回结果(内容经过格式化以便阅读)
{
"code": 0,
"message": "succeed.",
"fileList": [
{
"rate": 0.9558794498443604,
"label": 2,
"name": "czfh1cATkoExQ_AMVyg1zw==.resize",
"review": false
}
],
"statistic": [
0,
0,
1
],
"reviewCount": 0,
"nonce": "0.31666339887306094",
"timestamp": "Wed, 06 May 2015 07:42:27 GMT"
}
另一种方式安装。
在左边的“添加资源”中,点击下面的“第三方数据处理” > "图片签黄"。
文档反馈
(如有产品使用问题,请 提交工单)