更新时间:2023-08-17 17:36:12
网宿图片鉴定服务提供对指定图片资源(URL)进行智能鉴定的功能,支持涉黄识别、涉恐识别、政治人物识别、OCR文件识别。
POST /imageDetect
Host: <MgrDomain>
Authorization:<accessToken>
参数 | 必填 | 描述 |
---|---|---|
Host | 是 | 管理域名,可在用户管理界面获取 |
Authorization | 是 | 管理凭证 |
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
image | 是 | string | 图片URL,需经过URL安全的Base64编码,多个图片编码后使用;分隔。 |
type | 是 | string | 鉴定类型,porn-鉴黄,terror-暴恐,political-政治人物识别,ocr-文件识别鉴定,不同类型使用逗号分隔。 eg: porn–只鉴黄 porn,terror-同时鉴黄和鉴恐 porn,terror,political,ocr—同时鉴黄、鉴恐和政治人物识别、文字识别鉴定 |
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>,
},
...
]
},
"ocrDetect": { //仅鉴定类型为文字识别,即type=ocr时返回该节点
"label":3, // 0:正常 1:暴恐 2:色情 3:涉政 4:敏感 5:⼴告 6:谩骂 7:灌水 8:自定义 ;注:该label为按涉政优先返回的label,如图片同时包含涉政和涉黄文字,label为3
"rate":0.99, // 概率值,介于0-1
"review":false, // 是否需要人工复审,true-需要 false-不需要
"objects": [{
"text": "刁xx",
"scores": 0.9384796222050985,
"label": 3,
"review": false,
"rate": 1
},{
"text": "这是测试 这是测试",
"scores": 0.9956928292910258,
"label": 0,
"review": false,
"rate": 1,
}]
}
},
...
]
}
返回字段说明
字段名 | 父元素 | 类型 | 描述 |
---|---|---|---|
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-不需要 |
- | |||
ocrDetect | results | node | ocr鉴定信息,仅type=ocr时返回该节点 |
label | ocrDetect | int | ocr鉴定结果分类;0:正常 1:暴恐 2:色情 3:涉政 4:敏感 5:⼴告 6:谩骂 7:灌水 8:自定义 ;注:该label为按涉政优先返回的label,如图片同时包含涉政和涉黄文字,label为3 |
rate | ocrDetect | float | 介于0-1间的概率值,概率越高,鉴定结果越肯定 |
review | ocrDetect | boolean | 是否需要人工复审该图片;true-需要,false-不需要 |
objects | ocrDetect | array | ocr识别信息 |
text | objects | string | 文字内容 |
scores | objects | float | 介于0-1间的概率值,概率越高,文本识别结果越可靠 |
label | objects | int | ocr鉴定结果分类;0:正常 1:暴恐 2:色情 3:涉政 4:敏感 5:⼴告 6:谩骂 7:灌水 8:自定义 ;注:该label为按涉政优先返回的label,如图片同时包含涉政和涉黄文字,label为3 |
review | objects | float | 是否需要人工复审该图片;true-需要,false-不需要 |
rate | objects | boolean | 介于0-1间的概率值,概率越高,鉴定结果越肯定 |
如果请求失败,则返回如下内容的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,terror&image=aHR0cDovL3d3dy5iYWlkdS5jb20=;aHR0cDovL3d3dy5iYWlkdS5jb21=&bucket=bucketName" –H "Authorization:86622e227a50d4543c24945bc123542e4ac543a7:Y2JmMGY0YTNsdfQxZmBMHGM2ZTA0==" http://apitestuser.mgr0.v1.wcsapi.com/imageDetect