请求参数#

请求url#

  • 北京:http://api-video-bj.fengkongcloud.com/v2/saas/anti_fraud/video

  • 上海:http://api-video-sh.fengkongcloud.com/v2/saas/anti_fraud/video

  • 新加坡:http://api-video-xjp.fengkongcloud.com/v2/saas/anti_fraud/video

请求方法#

POST

字符编码#

UTF-8

建议超时时间#

3s

视频格式#

AVI、FLV、MP4、MPG、WMV、MOV、WMA、RMVB

视频大小限制#

小于等于300MB

时长限制#

小于等于2小时

请求参数#

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

参数名称类型是否必选说明
accessKeystringY公司密钥
用于权限认证,开通账号服务时由数美提供
imgTypestringN视频中的画面识别类型,可选值:
涉政识别:POLITICS
涉政人物识别:PERSON
暴恐识别:VIOLENCE
色情识别:PORN
广告识别:AD
图片违规文字识别:OCR
视频水印logo识别:LOGO
不良场景识别:BEHAVIOR
支持吸烟、喝酒、赌博、吸毒、避孕套和无意义画面
如需做组合识别,通过下划线连接即可,如
POLITICS_PORN_AD用于广告、色情和涉政识别
注意这里POLITICS实际识别内容为涉政人物和暴恐
audioTypestringN视频中的音频识别类型,可选值:
涉政识别:POLITICAL
国歌识别:ANTHEN
色情识别:PORN
广告识别:AD
娇喘识别:MOAN
性别识别:GENDER
音色识别:TIMBRE
辱骂识别:ABUSE
唱歌识别:SING
语种识别:LANGUAGE
不需要识别音频:NONE
如需做组合识别,通过下划线连接即可,如
POLITICAL_PORN_MOAN用于广告、色情和涉政识别
subtitleTypestringN视频标题的识别类型,可选值:
涉政识别:POLITICS
色情识别:PORN
广告识别:AD
不需要识别视频标题:NONE
如需做组合识别,通过下划线连接即可,如
POLITICS_PORN_AD用于广告、色情和涉政识别
appIdstringN应用标识,用于区分相同公司的不同应用,
该参数传递值可与数美服务协商用于区分应用
默认应用值:default
btIdstringY视频唯一标识
用于查询识别结果,最长64位
callbackstringN回调http或https接口,
当该字段非空时,服务将根据该字段回调通知用户审核结果
注意:使用https接口可能会增加些许延迟
callbackParamjson_objectN回调透传字段
回调透传字段,当callback存在时可选,发送回调请求时服务将该字段内容同视频结果一起返回
datajson_objectY请求数据内容,最长1MB

其中,data的内容如下:

参数名称类型是否必选说明
urlstringY要检测的视频url地址
detectFrequencyfloatN截帧频率间隔,单位为秒
取值范围为0.5~60s
如不传递默认5s截帧一次
retallImgintN选择返回视频截帧图片的等级,可取值:
0:返回风险等级为非pass的图片
1:返回所有风险等级的图片
默认为0
retallAudiointN选择返回视频音频片段的等级(每10秒一个音频片段)
可取值:
0:返回风险等级为非pass的音频片段
1:返回所有风险等级的音频片段
默认为0
videoNamestringN视频名称
用于后台界面展示,建议传入
tokenIdstringN客户端用户账号唯一标识
用于用户行为分析,建议传入用户UID
最长40位
channelstringN数据场景
取值需要与数美协商
ipstringN客户端IP,该参数用于IP维度的用户行为分析,同时可用于比对数美IP黑库

请求示例#

{
"accessKey":"xxxxx",
"imgType":"XX",
"audioType":"XX",
"subtitleType":"XX",
"btId":"xxxx",
"data":{
"url":"xxxx",
"detectFrequency":1,
"videoName":"数美智能视频识别",
"ip":"112.51.63.128",
"tokenId":"username"
}
}