图片鉴定

描述

网宿图片鉴定服务提供对指定图片资源(URL)进行智能鉴定的功能。

请求说明

POST /imageDetect
Host: <MgrDomain>
Authorization:<accessToken>

头部说明

参数 必填 描述
Host 管理域名,可在用户管理界面获取
Authorization 管理凭证

参数说明

参数 必填 类型 描述
image string 图片URL,单次只支持一个URL的鉴定,需经过URL安全的Base64编码
type string 鉴定类型,porn-鉴黄,terror-暴恐,political-政治人物识别。单次请求只能指定一种鉴定类型
bucket string 空间名,云存储空间名

响应说明

如果请求成功,则返回如下内容的Json串

    {
        "results":[
            {
                "image": <image string>,
                "errMessage": <errMessage string>,
                "pornDetect": {  //仅鉴定类型为鉴黄,即type=porn时返回该节点
                    "label": <label int>,
                    "rate": <rate float>,
                    "review": <review boolean>
                },
                "terrorDetect": {  //仅鉴定类型为鉴恐,即type=terror时返回该节点
                   "label": <label int>,
                   "rate": <rate float>,
                   "review": <review boolean>
                },
                "politicalDetect": {  //仅鉴定类型为政治人物识别,即type=political时返回该节点
                   "label":0,
                   "persons":[
                      {
                         "name": <name string>,
                         "rate": <rate float>,
                         "review": <review boolean>,
                        },
                        ...
                    ]
                }
            },
            ...
        ]
    }

返回字段说明

字段名 父元素 类型 描述
results - array 鉴定结果
image results string 请求鉴定的图片
errMessage results string 错误信息,鉴定成功返回空值
pornDetect results node 鉴黄信息,仅type=porn时返回该节点
label pornDetect int 图片鉴黄结果分类;0-色情, 1-性感, 2-正常
rate pornDetect float 介于0-1间的概率值,概率越高,鉴定结果越肯定
review pornDetect boolean 是否需要人工复审该图片;true-需要,false-不需要
-
terrorDetect results node 鉴恐信息,仅type=terror时返回该节点
label terrorDetect int 图片鉴恐结果分类;0-非暴恐, 1-暴恐
rate terrorDetect float 介于0-1间的概率值,概率越高,鉴定结果越肯定
review terrorDetect boolean 是否需要人工复审该图片;true-需要,false-不需要
-
politicalDetect results node 政治人物识别信息,仅type=political时返回该节点
label politicalDetect int 图片政治人物识别结果分类;0-非政治人物, 1-政治人物
persons politicalDetect array 政治人物信息
name persons string 政治人物名字
rate persons float 介于0-1间的概率值,概率越高,鉴定结果越肯定
review persons boolean 是否需要人工复审该图片;true-需要,false-不需要

如果请求失败,则返回如下内容的Json字符串:

例1:鉴权失败(空间拒绝访问)

{
    "code": <code string>,
    "message": <message string>
}

例2:图片鉴定异常(如图片格式错误)

{
    resutls:[
        {
            "image": <image string>,
            "errMessage": <errMessage string>
        },
        {
            "image": <image string>,
            "errMessage": <errMessage string>,
            "pornDetect": {         
                "label": <label int>,
                "rate": <rate float>,
                "review": <review boolean>
            }
        }
    ]
}
字段名 描述
code HTTP请求响应码,参见HTTP响应状态码
message 请求失败的提示信息

范例

curl –X POST –d "type=porn&image=aHR0cDovL3d3dy5iYWlkdS5jb20=&bucket=bucketName"
–H "Authorization: 86622e227a50d4543c24945bc123542e4ac543a7:Y2JmMGY0YTNsdfQxZmBMHGM2ZTA0=="
http://apitestuser.mgr0.v1.wcsapi.com/imageDetect