图片鉴黄服务接口协议
请求
请求报文格式
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"
}
另一种方式安装。
在左边的“添加资源”中,点击下面的“第三方数据处理” > "图片签黄"。
    文档反馈
    (如有产品使用问题,请 提交工单)