返回参数#

用户如果需要服务端主动对视频检测结果进行回调,则需要在请求参数中指定回调协议接口URL callback参数,服务端根据该参数在视频审核完成后,主动回调用户。

支持协议#

HTTPHTTPS

请求方法#

POST

字符编码格式#

UTF-8

推送策略#

经机审结果推送至请求参数的callback参数地址,每次推送超时时长5S,收到返回HTTP状态码为200时,表示推送成功;否则系统将进行幂指数推送,最多20次推送。

返回参数#

参数名称类型是否必选说明
checksumstringY由accessKey + btId + result拼成字符串
通过SHA256算法生成
为防止篡改,可以按此算法生成字符串,与checksum做一次校验
resultstringY审核结果

其中,result可反序列化为Json结构,内容如下:

参数名称类型是否必选说明
codeintY返回码,详见常见错误码
除message和requestId之外的字段,只有当code为1100时才会存在
messagestringY返回码详情描述
requestIdstringY请求唯一标识
用于数据检索,排查和优化模型,强烈建议保存
btIdstringY视频唯一标识,最长64位
auxInfojson_objectY辅助信息:用于存储扩展字段
labelsstringN风险标签
riskLevelstringN风险级别
可能返回值:
PASS:正常内容,建议直接放行
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
detailjson_arrayN风险详情
additionjson_objectN额外内容
callbackParamjson_objectN当提交请求中,callbackParam字段有值时存在

auxInfo参数结构如下:

参数名称类型是否必选说明
frameCountintY展示视频文件中的截帧张数

其中,detail数组中每一项的具体参数如下:

参数名称类型是否必选说明
timefloatY风险截帧图片在视频中的时间
从视频起始计算,单位秒
imgUrlstringY风险截帧图片地址
当retallImg传入值为1时,可获取视频所有截帧图片地址
similarityfloatY返回当前截帧图片和上一帧截帧图片的相似度
注意:有图片则该字段就会返回,
视频文件初始第一帧将比对纯黑背景图片
riskLevelstringY识别结果,可能返回值:
PASS:正常内容,建议放行处置
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
riskTypeintN截帧图片风险类型,可能取值:
正常:0
涉政:100
色情:200
性感:210
广告:300
二维码:310
水印:320
暴恐:400
违规:500
未成年人:520
黑名单:700
matchedListstringN图片内容命中的名单字段
matchedItemstringN图片内容包含的广告文字
当TYPE传入AD并检测到包含广告文字时存在
polityNamestringN识别出的涉政人物名字
当TYPE传入PERSON并检测到涉政人物时存在
violenceLabelstringN暴恐场景分类
当TYPE传入VIOENCE并检测到暴恐场景时存在
logosjson_arrayN返回视频帧识别出来的logo结果
如:"logos": ["douyin"]

addition参数结构如下:

字段类型是否必返说明
audio_evidencejson_arrayN违规音频及违规详情数组
当存在违规音频时存在
title_evidencejson_objectN违规标题信息(当存在违规标题时存在)

audio_evidence的参数结构如下:

字段类型是否必返说明
audioModelstringN命中规则编号
audioTextstringN违规音频的音转文文字
audio_starttimefloatN违规音频发生时间
audio_endtimefloatN违规音频结束时间
audio_urlstringN音频地址
audio_matchedListstringN违规音频名单内容
audio_matchedItemstringN违规音频敏感词内容
descriptionstringN音频片段风险原因描述
requestIdstringN风险音频片段请求唯一标识,强烈建议保存
用于定位异常请求,以及效果调优
riskLevelstringN识别结果,可能返回值:
PASS:正常内容,建议放行处置
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
riskTypeintN风险类型,静音时不返回
可能取值:
正常:0
涉政:100
国歌:120
色情:200
辱骂:210
娇喘:250
广告:300
黑名单:700
自定义:900
isSingintN表示该条音频文件是否唱歌,可选值
0:表示没有唱歌
1:表示唱歌。
仅当type传入值包含SING时返回。
languagestringN语种标签与概率值列表

audio_evidence其中的language数组的参数结构如下:

字段类型是否必返说明
labelintN语种识别类别标识,可能取值:
0:普通话
1:英语
2:粤语
confidencefloatN对应语种标签可能性大小,
取值0-100,数值越高表示概率越大。

addition中title_evidence的参数结构如下:

字段类型是否必返说明
title_matchedItemstringN违规标题敏感词内容
audio_matchedListstringN违规音频名单内容

返回示例#

{
"code":1100,
"message":"成功",
"requestId":"b891cf2d82e214de45df33fc2bea4875",
"riskLevel":"REJECT",
"btId":"xxxx",
"labels":"色情-图像",
"detail":[
{
"time":"6",
"url":"http://antifraudimage-1251671073.file.myqcloud.com/20180314/d435c505fece80363a7283c62942c639_1533272.jpg",
"riskLevel":"REJECT",
"riskType":100
}]
}