图片鉴黄

文档中心

图片鉴定

描述

网宿图片鉴定服务提供对指定图片资源（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