human: 如何处理七牛云的智能多媒体服务数美图片审核

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > Open API >数美图片审核

#  数美图片审核

最近更新时间: 2021-08-12 10:16:16

# 功能描述

图片审核功能基于先进的人工智能技术，精准高效识别涉政、色情、暴恐、广告、水印logo，不良场景等违规内容，帮助您提前防御内容风险，提高审核效率，净化网络环境，提升用户体验。

# 请求参数

**请求URL** : `https://censor-open.qiniuapi.com/anti_fraud/v2/img`

**字符编码格式** : 请求及返回结果都使用 UTF-8 字符集进行编码

**请求方法** : POST

**建议超时时长** : 5s

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
type | string | Y | 选择识别类型，可选值:   
POLITICS:涉政识别  
PORN:色情识别  
OCR:图片中的OCR文字识别  
AD:广告识别  
LOGO:视频水印logo识别  
BEHAVIOR:不良场景识别，支持识别吸烟、喝酒、赌博、吸毒、避孕套和无意义画面  
通过下划线连接，如AD_PORN_POLITICS用于广告、色情和涉政组合识别  
**注意** 这里POLITICS实际上等价于以下两个类型:PERSON:涉政人脸识别，VIOLENCE:暴恐识别  
**建议** 传入:POLITICS_PORN_AD_BEHAVIOR  
data | json_object | Y | 请求数据内容，最长10MB  
  
其中，data的内容如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
img | string | Y | 要检测的图片，使用图片的url链接   
支持格式:jpg，jpeg，jp2，png，webp， gif，bmp，tiff，tif，dib，ppm，pgm，pbm， hdr，pic  
建议图片像素不小于256*256  
tokenId | string | Y | 客户端用户唯一标识，用于用户行为分析，建议传入用户UID   
注:不同用户务必传入不同的tokenId对其进行唯一标识  
channel | string | N | 见channel字段说明  
registerTime | int | N | 帐号注册时间，强烈建议传递此参数，新注册帐号的异常操作风险较高，毫秒级时间戳  
friendNum | int | N | 帐号好友数，社交场景强烈推荐传此参数，标识用户质量  
fansNum | int | N | 帐号粉丝数，直播/社区场景强烈推荐传此参数，标识用户质量  
isPremiumUser | int | N | 是否优质(如付费)用户，配置不同等级，标识用户质量   
1为优质用户，0为默认值  
ip | string | N | 客户端IP，该参数用于IP维度的用户行为分析，同时可用于比对IP黑库  
receiveTokenId | string | N | 接收者的tokenId，私聊场景必选  
sex | int | N | 用户的性别，可选值:   
0:女性  
1:男性  
age | int | N | 用户的年龄，可选值:   
0:青年(大约 18-45 岁)  
1:中年(大约 45-60 岁)  
2:老年(大于 60 岁)  
level | int | N | 用户等级，针对不同等级的用户可配置不同拦截策略  
role | string | N | 用户角色，对不同角色可配置不同策略。   
直播领域"ADMIN"表示房管，"HOST"表示主播，"SYSTEM"系统角色  
游戏领域"ADMIN"表示管理员，"USER"表示普通用户，缺失或者"USER"默认普通用户  
topic | string | N | 讨论的话题编号，可为书评区编号、论坛帖子编号  
phone | string | N | 用户手机号，可用于比对手机号黑库  
deviceId | string | N | 强烈建议传入，设备指纹标识，用于用户行为分析。当恶意用户篡改mac、imei等设备信息时，使用deviceId能够发现和识别此类恶意行为，同时可用于比对设备指纹黑名单  
imeimac | string | N | 用户android设备唯一标识，相比tokenId和IP，imei和mac更难被更换，当恶意用户使用多个不同账户和IP进作恶时，通过imei和mac能够有效关联识别此类恶意行为，同时可用于比对设备黑名单。  
idfvidfa | string | N | 用户iOS应用唯一标识，相比tokenId和IP，idfv不能被修改，当恶意用户使用多个不同账户和IP进行恶意行为时，使用idfv能够发现和识别此类恶意行为  
maxFrame | int | N | 最大截帧数量，GIF图检测专用，默认值为20。当interval*maxFrame小于该图片所包含的图片数量时，截帧间隔会自动修改为该图片所包含的图片数/maxFrame，以提高整体检测效果。  
interval | int | N | 截帧频率，GIF图检测专用，默认值为1。每interval张图片抽取一张进行检测。  
  
channel字段说明：

根据客户不同业务场景，配置不同的渠道(channel)，制定针对性的拦截策略，同时也方便客户针对不同业务场景的数据进行筛选、分析。业务场景和渠道取值对应表如下:

业务场景 | channel 取值 | 备注  
---|---|---  
头像 | HEAD_IMG | 用户头像  
相册 | IMGS | 用户相册  
动态 | DYNAMIC | 社交平台的动态配图  
文章配图 | ARTICLE | 博客、文章中的配图  
评论插图 | COMMENT | 评论里面的配图  
封面 | COVER | 相册中的封面或者背景图  
商品图片 | PRODUCT | 电商平台的商品图片  
群聊图片 | GROUP_CHAT | 群聊里面的图片消息  
私聊图片 | MESSAGE | 私聊里面的图片消息  
离线测试 | OFFLINE_TEST | 关闭了画像和行为相关策略，离线测试专用  
  
# 返回参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
code | int | Y | 返回码  
message | string | Y | 返回码详情描述  
entryId | string | Y | 请求唯一标识，后续可用于数据查询  
score | int | N | 风险分数(code为1100时存在)   
取值范围[0,1000]，分数越高风险越大  
riskLevel | string | N | 风险级别(code为1100时存在)   
可能返回值:PASS，REVIEW，REJECT  
PASS:正常内容，建议直接放行  
REVIEW:可疑内容，建议人工审核  
REJECT:违规内容，建议直接拦截  
status | int | Y | 提示服务是否超时   
0:正常  
501:超时  
detail | json_object | N | 风险详情(code为1100时存在)  
  
其中，detail的内容如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
riskType | int | Y | 标识风险类型，可能取值:   
0: 正常  
100:涉政  
200:色情  
210:性感  
300:广告  
310:二维码  
320:水印  
400:暴恐  
500:违规  
510:不良场景  
520:未成年人  
700:黑名单  
710:白名单  
800:高危账号  
900:自定义  
model | string | Y | 策略规则标识，用来标识命中的策略规则  
description | string | Y | 拦截的风险原因解释   
仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理  
descriptionV2 | string | N | 新版策略规则风险原因描述   
注:该参数为新版API返回参数，过渡阶段只有新策略才会返回  
text | string | N | OCR识别出的文字，可根据需求返回该参数  
matchedItem | string | N | 命中的具体敏感词(该参数仅在命中敏感词时存在)，可根据需求返回该参数  
matchedList | string | N | 命中敏感词所在的名单名称(该参数仅在命中敏感词时存在)，可根据需求返回该参数  
matchedDetail | string | N | 命中的敏感词详细信息，可以反序列化为json_array，可根据需求返回该参数  
pornLabel | string | N | 色情识别标签，标识色情识别结果;   
开启色情识别后可根据需求选择是否返回该参数;  
可选值:“色情”、“性感”、“正常”  
pornRate | float | N | 色情图片概率，可根据需求返回该参数  
sexyRate | float | N | 性感图片概率，可根据需求返回该参数  
normalRate | float | N | 正常图片概率，可根据需求返回该参数  
polityName | string | N | 开启涉政人物识别后可根据需求选择是否   
返回该参数;  
返回值为最相似的涉政人物名称  
polityRate | float | N | 最相似的涉政人物概率，可根据需求返回该参数  
violenceLabel | string | N | 暴恐识别标签，标识暴恐识别结果;   
开启暴恐识别后可根据需求选择是否返回该参数;  
可选值:“暴乱场景”、“国旗国徽”、“军装”、“恐怖组织”、“枪支刀具”、“血腥场景”、“游戏枪支刀具”、“中国地图”、“坦克”、“蜡烛”、“制服”、“正常”  
rebelRate | float | N | 暴乱场景概率，可根据需求返回该参数  
flagRate | float | N | 国旗国徽概率，可根据需求返回该参数  
armyRate | float | N | 军装概率，可根据需求返回该参数  
terrorismRate | float | N | 恐怖组织概率，可根据需求返回该参数  
weaponRate | float | N | 枪支刀具概率，可根据需求返回该参数  
bloodRate | float | N | 血腥场景概率，可根据需求返回该参数  
gameWeaponRate | float | N | 游戏枪支刀具概率，可根据需求返回该参数  
chinamapRate | float | N | 中国地图概率，可根据需求返回该参数  
tankRate | float | N | 坦克概率，可根据需求返回该参数  
candleRate | float | N | 蜡烛概率，可根据需求返回该参数  
uniformRate | float | N | 制服概率，可根据需求返回该参数  
nonViolenceRate | float | N | 非暴恐图片概率，可根据需求返回该参数  
segments | int | N | 实际处理的片段数量，当检测的图片为GIF图或长图时，会返回该参数  
logos | json_array | N | 返回图片识别出来的logo结果  
  
# 示例

## 请求示例

    
    
    POST /anti_fraud/v2/img HTTP/1.1
    Host: censor-open.qiniuapi.com
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "type":"POLITICS_PORN_AD",
        "data":{
            "img":"http://www.leilingfushi.com/UpFiles/Article/2017/5/11/2017051152012237.jpg",
            "tokenId":"test"
        }
    }
    

## 返回示例

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
        "code":1100,
        "message":"成功", 
        "entryrid":"5564f430ee6a1adb40f06d768b40316b",
        "score":700,
        "riskLevel":"REJECT",
        "detail":{
            "description":"暴恐图片",
            "model":"M010118",
            "riskType":400,
            "text":""
        },
        "status":0
    }
    

# 错误码

Code | Message  
---|---  
1100 | 成功  
1901 | QPS受限  
1902 | 参数不合法  
1903 | 服务失败  
1911 | 下载超时  
91xx | 内部错误  
  
以上内容是否对您有帮助？