图片识别接口

最近更新时间:2019-08-09 10:18:27

接口描述

识别图片是否存在以下信息:色情、性感、OCR 识别恶意、敏感内容、政治人物、暴恐、违法、血腥、其他。

协议:HTTPS

域名:upload-csec.api.qcloud.com

接口名:ContentSecurity.Image.Recognition

请求参数

注意:
以下每一个参数对于识别恶意都非常重要,缺少任何参数都有可能影响识别效果 。

参数名称 类型 描述
API 公共字段
Action String 具体操作的指令接口名称,此处 Action 参数为 ContentSecurity.Image.Recognition
Region String 地域参数,用来标识希望操作哪个地域的实例。具体可参见 《地域和可用区列表》
Timestamp Uint 当前 UNIX 时间戳,可记录发起 API 请求的时间
Nonce Uint 随机正整数,与 Timestamp 联合起来, 用于防止重放攻击
SecretId String 在云 API 密钥 上申请的标识身份的 SecretId,一个 SecretId 对应唯一的 SecretKey , 而 SecretKey 会用来生成请求签名 Signature。具体可参考 《签名方法》
Signature String 请求签名,用来验证此次请求的合法性,需要用户根据实际的输入参数计算得出。计算方法可参考 《签名方法》
基本字段:必选
fileName String 文件名
基本字段:二选一参数,要求至少选择一项
fileUrl String 文件的 URL 地址
fileContent String 对图片内容 Base64 位编码值
其他可选字段
category String 识别类型,不填默认值: pornDetection,多类型检测可通过|连接。例如:pornDetection|OCR
category 可填参数
pornDetection String 色情鉴定
OCR String OCR 文字识别提取
political String 涉政人物检测
QRCode String 二维码图案检测
liveScene String 吸烟鉴定
violentTerrorism String 暴恐鉴定

响应参数

参数名称 类型 描述
code Int 公共错误码
0:表示成功
其他值:表示失败
详见错误码页面
codeDesc String 业务侧错误码
成功时返回 Success
错误时返回具体业务错误原因
message String 模块错误信息描述,与接口相关
data Array 识别内容详情,具体内容参见 data 参数类型说明
data 参数类型说明
名称 类型 描述
category String 识别类型,具体内容参见 category 说明
label String 识别类型子标签
confidence Int 识别为label的概率
suggestion String pass:通过
review:人工审核
block:阻止传播
subcode Int 具体服务错误码,具体内容参见 subcode 说明
content Array OCR 或 QRCode 识别返回结果
candidates Array political识别相似人脸信息
candidates.confidence Int political识别相似人脸信息置信度
candidates.name String political识别相似人脸信息名称


subcode 说明

错误码 含义
-1102 图片解码失败
-1308 URL 图片下载失败
-1403 图片下载失败
-5208 服务内部错误
category 说明
category 标签 说明
pornDetection porn 色情
pornDetection hot 性感
pornDetection breast 凸显胸部
pornDetection ass 凸显臀部或大腿
pornDetection bareBody 裸露身体
pornDetection unrealHotPeople 非真实人物
OCR OCR OCR 提取
OCR UgcAntiSpam OCR 文本识别
political political 识别政治人物或自定义人物
ViolentTerrorism terrorists 武装分子
ViolentTerrorism knife 刀具
ViolentTerrorism guns 枪支
ViolentTerrorism blood 血腥
ViolentTerrorism fire 火灾
ViolentTerrorism flag 旗帜
ViolentTerrorism crowd 人群聚集
QRCode QRCode 识别二维码
liveScene smoke 吸烟

代码示例

{
    "code": 0,
    "message": "NoError",
    "codeDesc": "Success",
    "data":[
        {
            "confidence": 20, 
            "category": "pornDetection", 
            "suggestion": "block", 
            "subCode": "0", 
            "label": "porn"
        },
        {
            "confidence": 30, 
            "category": "pornDetection",
            "suggestion": "pass", 
            "subCode": "0", 
            "label": "hot"
        },
        {
            "confidence": 50, 
            "category": "pornDetection",
            "suggestion": "pass", 
            "subCode": "0", 
            "label": "breast"
        },
        {
            "confidence": 50, 
            "category": "pornDetection",
            "suggestion": "pass", 
            "subCode": "0", 
            "label": "ass"
        },
        {
            "confidence": 50, 
            "category": "pornDetection",
            "suggestion": "pass", 
            "subCode": "0", 
            "label": "bareBody"
        },
        {
            "confidence": 50,
            "category": "pornDetection",
            "suggestion": "pass", 
            "subCode": "0", 
            "label": "unrealHotPeople"
        },
        {
            "confidence": 100,
            "category": "OCR",
            "suggestion": "block", 
            "label": "ocr",
            "subCode": "0", 
            "ocrMsg":"加微信看爽片"
        },
        {
            "confidence": 100,
            "category": "OCR",
            "suggestion": "block", 
            "label": "UgcAntiSpam    ",
            "subCode": "0"
        },
        {
            "confidence": 80,
            "category": "political",
            "suggestion": "block", 
            "label": "political",
            "subCode": "0", 
            "candidates":[{"confidence":80,"name":"张三"}, {"confidence":70,"name":"李四"}]
        },
        {
            "confidence": 100,
            "category": "QRCode",
            "suggestion": "block", 
            "label": "QRCode",
            "subCode": "0", 
            "candidates":["http://u.wechat.com/EGn4HWqn3jXK8xvx52uUYRE","http://u.wechat.com/EGn4HWqn3jXK8xvx52uUYkE"]
        },
        {
            "confidence": 70,
            "category": "liveScene",
            "suggestion": "block", 
            "subCode": "0", 
            "label": "smoke"
        }
    ]
}