智能多媒体服务 > 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	内部错误

以上内容是否对您有帮助？