数美融媒体内容审核API接口文档#


版权所有 翻版必究


检测提交接口#

接口说明#

该接口为融媒体检测提交接口,支持http协议接口调用,目前仅支持异步返回

请求URL#

集群名称url
硅谷集群http://api-media-gg.fengkongcloud.com/media/v1
上海集群http://api-media-sh.fengkongcloud.com/media/v1

检测数据要求#

请求体限制:所有请求参数大小总和不能超过10M

文本要求#

  • 文本限制:单次请求\<10000字符,字段长度超过10000字符,会提示参数错误

图片要求#

  • 图片支持类型:URL
  • 图片支持格式:jpg,jpeg,png,webp,gif,tiff,tif,heif
  • 图片大小: 单张30M,像素不低于20px*20px,不超过6000px*6000px,建议图片像素不小于256px*256px,像素过低会影响识别效果
  • 图片下载:下载时间限制为5秒内,如果下载时间超过5秒,接口检测失败
  • 截帧说明:数美自动将GIF图、长图(长宽比大于4的图片)截帧过检,GIF图,长图均按照实际截图张数进行计费

音频文件要求#

  • 音频支持类型:URL
  • 音频支持格式:wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flac、alac、wavpack、silk_v3等
  • 音频大小: 音频文件大小不超过550M
  • 音频时长: 时长小于5小时

视频文件要求#

  • 视频支持类型:URL
  • 视频支持格式:AVI、FLV、MP4、MPG、WMV、MOV、WMA、RMVB、m3u8等
  • 视频大小:视频文件大小不超过300M
  • 视频时长: 时长小于2小时

文档要求#

  • 文档支持类型:URL
  • 文档支持格式: DOCX、PDF、DOC、XLS、XLSX、PPT、PPTX、PPS、PPSX、XLTX、XLTM、XLSB、TXT
  • 文档大小:单文档\<500M,文本长度限制50w字,图片张数限制500张

请求参数#

名称类型是否必填说明
accessKeystringY公司秘钥,联系数美提供
appIdstringY用于区分应用,需要联系数美服务开通,请使用数美单独提供的传值为准
eventIdstringY用于区分场景数据,需要联系数美服务开通,请使用数美单独提供的传值为准
datajson_objectY请求数据
callbackstringY回调地址,用于接受审核结果
passThroughjson_objectN透传字段

data里包含的内容

名称类型是否必填说明
btIdstringY作品Id
tokenIdstringN用户账号
contentsjson_arrayY检测数据,类型为text时最多传入20条文本内容,每条最长10000字符;类型为image时最多传入50张图片url,每张最长512字符;类型为audio时最多传入5条语音url,每条最长512字符;类型为video时最多传入5条音视频url,每条最长512字符;类型为file时最多传入10个文档url,每个最长512字符如果有一条不满足触发报错
detectFrequencyfloatN截帧频率间隔,单位为秒,取值范围为0.5~60s;如不传递默认5s截帧一次
advancedFrequencyjson_objectN高级截帧间隔,单位为秒,此项填写,默认截帧策略失效,参数配置如{"durationPoints":[300,600],"frequencies":[1,5,10]}含义为:视频文件时长≤300s ——选用1s一截帧300s\<视频文件时长≤600s ——选用5s一截帧视频文件时长>600s ——选用10s一截帧
returnVideoAllImgintN选择返回视频截帧图片的等级:0:返回风险等级为非pass的图片;1:返回所有风险等级的图片。默认为1
returnVideoAllAudiointN选择返回视频音频片段的等级:0:返回风险等级为非pass的音频片段1:返回所有风险等级的音频片段默认为1
returnAudioAllTextintN可选值如下(默认为1):
0:返回风险片段识别结果
1:返回所有片段识别结果
该参数仅用于控制片段识别结果的返回, 不影响整体识别结果的返回。
当选择"返回所有片段识别结果"时,片段识别结果中包含riskLevel为PASS、REVIEW和REJECT的片段识别结果;当选择"返回风险片段识别结果"时,片段识别结果中仅包含riskLevel为REVIEW和REJECT的片段识别结果;片段识别结果对应响应中的audioDetail字段。

data 中,advancedFrequency的内容如下

请求参数名类型参数说明传入说明规范
durationPointsfloat64[]视频时长区间分割非必传参数用于规定视频文件支持动态截帧频率的时长区间,数组最多为5个
frequenciesfloat64[]视频时长区间对应的截帧频率非必传参数可设置范围为0.5~60秒,数组最多6个说明:frequencies数组设置的个数需要比durationPoints数组个数多1个,传错或传空报错返回1902

contents里包含的内容

名称类型是否必填说明
dataTypestringY数据类型,可能取值:
text:文本
image:图片
audio:音频文件
video:视频文件
file:文档
contentstringY检测数据类型是文本时传入原始文本数据,检测数据类型是其他时传入数据url
dataIdstringN作品Id,用于查询作品
btIdstringY数据唯一标识,用于查询历史记录,注意:重复会报错
txtTypestringN文本和文档中文本检测风险类型,可选值:TEXTRISK。dataType为text或者file时必传
audioTypestringN音频和视频中音频部分检测风险类型,可选值:
PORN:色情识别
AD:广告识别
POLITICAL:涉政识别
ABUSE:辱骂识别
MOAN:娇喘识别
ANTHEN:国歌识别
AUDIOPOLITICAL:一号领导人声纹识别
NONE不审核视频中的音频,并且不支持传入音频文件审核
如需做组合识别,通过下划线连接即可,例如POLITICAL_PORN_MOAN涉政、色情和娇喘识别dataType为audio或video时必传
imgTypestringN图片、文档中图片和视频文件中截帧检测风险类型,可选值:POLITICS:涉政识别
PORN:色情识别
AD:广告识别
LOGO:水印logo识别
BEHAVIOR:不良场景识别,支持吸烟、喝酒、赌博、吸毒、避孕套和无意义画面
OCR:图片中的OCR文字识别
VIOLENCE:暴恐识别
如果需要识别多个功能,通过下划线连接,如 POLITICS_AD 用于涉政和广告组合识别dataType为image、video或file时必传
imageBusinessTypestringN图片业务标签
可选值:见附录如果需要多个识别功能,通过下划线连接,该字段和imgType必须选择一个传入
audioBusinessTypestringN可选值:音频业务标签的一、二、三级标签
GENDER:性别识别
AGE:年龄识别
TIMBRE:音色识别
SING:唱歌识别
LANGUAGE:语种识别
VOICE:人声属性
AUDIOSCENE:声音场景,如果需要多个识别功能,通过下划线连接,该字段和audioType必须选择一个传入
fileFormatstringN要检测的文档格式,传入数据为文档时必传,可选值:
DOCX
PDF
DOC
XLS
XLSX
PPT
PPTX
PPS
PPSX
XLTX
XLTM
XLSB
XLSM
TXT
CSV
EPUB
若fileFormat与文档实际格式不一致,则返回报错参数错误

响应参数#

名称类型是否必填说明
codeintY返回码
messagestringY返回码描述
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存

异步回调结果#

接口说明#

任务审核中所有数据审核完成后,数美会将人工审核结果或者异步机器检测结果推送给客户,保证客户最快的获取结果,需客户在调用检测接口时设置回调地址callback参数,客户方需保证回调接收接口的可用性和稳定性,确保能正常接收推送过来的结果数据。推送策略:当用户收到推送结果,并返回HTTP状态码为200时,表示推送成功;否则系统将重复推送,推送5次,每次间隔20s。

机器检测结果#

名称类型是否必填说明
btIdstringY任务Id
requestIdstringY流水号
riskLevelstringY可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
resultTypeintY0:机审,1:人审
detailsjson_objectY风险详情
passThroughjson_objectN透传字段

details的内容是:

名称类型是否必填说明
textsjson_arrayY文本审核结果,如果没有传入,则为空
imagesjson_arrayY图片审核结果,如果没有传入,则为空
audiosjson_arrayY音频文件审核结果,如果没有传入,则为空
videosjson_arrayY视频文件审核结果,如果没有传入,则为空
filesjson_arrayY文档审核结果,如果没有传入,则为空

texts 里每个元素的内容

参数名称类型参数说明是否必返规范
codeint返回码Y见响应码参数说明
messagestring返回码描述Y见响应码参数说明
requestIdstring该条数据任务的唯一标识Y本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
dataIdstring作品IdN和传入的dataId对应
btIdstring文本唯一标识Y和传入的btId对应
riskLevelstring处置建议Y可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
riskLabel1string一级风险标签Y一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string二级风险标签Y二级风险标签,当riskLevel为PASS时为空
riskLabel3string三级风险标签Y三级风险标签,当riskLevel为PASS时为空
riskDescriptionstring风险原因Y当riskLevel为PASS时为"正常"
disposaljson_object处置结果N最外层的三级标签做映射之后的值放入disposal中,当未开启公司标签映射 或 未配置标签映射时不返回该字段
riskDetailjson_object风险详情Y风险详情,详见riskDetail参数

其中,disposal的内容如下:

参数名称类型参数说明是否必返规范
riskLevelstring处置建议N可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
riskLabel1string映射后一级风险标签N一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string映射后二级风险标签N二级风险标签,当riskLevel为PASS时为空
riskLabel3string映射后三级风险标签N二级风险标签,当riskLevel为PASS时为空
riskDescriptionstring映射后风险原因N当riskLevel为PASS时为"正常"
riskDetailjson_object映射后风险详情N风险详情

其中,riskDetail的内容如下:

参数名称类型参数说明是否必返规范
matchedListsjson_array辅助信息N命中的客户自定义名单列表。详见matchedLists参数
riskSegmentsjson_array辅助信息,高风险内容片段检测文本包含涉政、暴恐、违禁、广告法等风险内容的时候存在N详见riskSegments参数

riskDetail中,matchedLists数组每个元素的内容如下:

参数名称类型参数说明是否必返规范
namestring辅助信息N命中的名单名称
wordsjson_array辅助信息N命中的敏感词数组。详见words参数

matchedLists中,words数组每个元素的内容如下:

参数名称类型参数说明是否必返规范
wordstring辅助信息N命中的敏感词
positionint_array辅助信息N敏感词所在位置

riskDetail中,riskSegments的内容如下:

参数名称类型参数说明是否必返规范
segmentstring辅助信息N高风险内容片段
positionint_array辅助信息N高风险内容片段所在位置

images 里每个元素的内容

参数名称参数类型参数说明是否必返规范
codeint返回码Y见响应码参数说明
messagestring返回码描述Y见响应码参数说明
requestIdstring该条数据任务的唯一标识Y本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
dataIdstring作品IdN和传入的dataId对应
btIdstring单条数据唯一标识Y和传入的btId对应
riskLevelstring处置建议Y可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
riskLabel1string一级风险标签Y一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string二级风险标签Y当riskLevel为PASS时为空
riskLabel3string三级风险标签Y当riskLevel为PASS时为空
riskDescriptionstring风险原因Y当riskLevel为PASS时为正常
disposaljson_object处置结果N最外层的三级标签做映射之后的值放入disposal中,当未开启公司标签映射 或 未配置标签映射时不返回该字段
riskDetailjson_object风险详情Y详见riskDetail参数

其中,disposal的内容如下:

参数名称类型参数说明是否必返规范
riskLevelstring处置建议N可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
riskLabel1string映射后一级风险标签N一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string映射后二级风险标签N二级风险标签,当riskLevel为PASS时为空
riskLabel3string映射后三级风险标签N二级风险标签,当riskLevel为PASS时为空
riskDescriptionstring映射后风险原因N当riskLevel为PASS时为"正常"
riskDetailjson_object映射后风险详情N风险详情

其中,riskDetail结构如下:

参数名称参数类型参数说明是否必返规范
facesjson_array返回图片中涉政人物的名称及位置信息N
face_numint人脸数量N
personsjson_array仅当命中人像-多人时,数组元素会有多个,最多10个N
person_numint人像数量N有且仅有人像-多人下返回
objectsjson_array返回图片中物品或标志二维码的位置信息N数组仅会有一个元素
ocrTextjson_object返回图片中违规文字相关信息,当请求参数type字段包含IMGTEXTRISK和ADVERT时存在N
riskSourceint标识资源哪里违规Y标识风险结果的来源:
1000:无风险
1001:文字风险
1002:视觉图片风险

riskDetail中,faces数组每个元素的内容如下:

参数名称参数类型参数说明是否必返规范
idstring人物编号N图片同一个位置下的人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个ID
namestring人物名称N能识别的公众人物名称
locationint_array人物位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567]
207代表的是左上角的x坐标
522代表左上角的y坐标
340代表的是右下角的x坐标
567代表的是右下角的y坐标
N
face_ratiofloat人脸占比N
probabilityfloat置信度,可选值在0~1之间,值越大,可信度越高N0~1之间的浮点数

riskDetail中,objects数组每个元素的内容如下:

参数名称参数类型参数说明是否必返规范
idstring编号,保证同一个位置下的物品在不同标签下的编号相同N
namestring标识名称N
locationint_array标识位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567]
207代表的是左上角的x坐标
522代表左上角的y坐标
340代表的是右下角的x坐标
567代表的是右下角的y坐标
N
probabilityfloat置信度,可选值在0~1之间,值越大,可信度越高N0~1之间的浮点数
qrContentstring二维码的url信息N仅当命中二维码相关标签时返回

riskDetail中,persons数组每个元素的内容如下:

参数名称参数类型参数说明是否必返规范
idstring编号,保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个IDN
person_ratiostring人像在图中的占比N
locationint_array人像位置坐标N
probabilityfloat置信度,可选值在0~1之间,值越大,可信度越高N0~1之间的浮点数

riskDetail中,ocrText的内容如下:

参数名称参数类型参数说明是否必返
textstring识别出的文字Y
matchedListsjson_array命中的客户自定义名单列表,matchedLists数组每个元素的内容见上文matchedLists说明N
riskSegmentsjson_array高风险片段内容,检测图片包含涉政、暴恐、违禁、广告法等风险内容的时候存在,riskSegments的每个元素的详细内容见上文riskSegments说明N

audios 里每个元素的内容

参数名类型参数说明是否必返规范
codeint状态码Y见响应码参数说明
messagestring返回码描述Y见响应码参数说明
requestIdstring该条数据任务的唯一标识Y本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
dataIdstring作品IdN和传入的dataId对应
btIdstring单条数据唯一标识Y和传入的btId对应
riskLevelstring当前事件的处置建议Y返回值:
PASS:正常内容,建议直接放行
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
audioTextstring整段音频转译文本结果Y
audioTimeint整段音频的音频时长Y单位秒
audioDetailjson_array音频片段信息Y回调的音频片段信息,详见audioDetail参数

其中,audioDetail详细内容如下:

参数名类型参数说明是否必返规范
requestIdstring音频片段请求唯一标识Y
audioStarttimefloat音频片段起始时间Y相对音频开始的时间距离,单位是秒
audioEndtimefloat音频片段结束时间Y相对音频开始的时间距离,单位是秒
audioUrlstring音频片段链接Ymp3格式
riskLevelstring音频片段识别结果Y可能返回值:
PASS:正常内容,建议直接放行
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
riskLabel1string一级风险标签Y
riskLabel2string二级风险标签Y
riskLabel3string三级风险标签Y
riskDescriptionstring风险原因Y仅供人了解风险原因时作为参考,程序请勿依赖该参数的值做逻辑处理
riskDetailjson_object风险详情N详见riskDetail参数

其中,riskDetail详细内容如下:

参数名类型参数说明是否必返规范
audioTextstring音频转译文本的结果N
matchedListsjson_array命中的客户自定义名单信息N命中客户自定义名单时返回,matchedLists数组每个元素的内容见上文matchedLists说明
riskSegmentsjson_array高风险内容片段N在涉政、暴恐、违禁、竞品、广告法等功能的时候存在,riskSegments的每个元素的详细内容见上文riskSegments说明

videos 里的每个元素的内容

参数名类型参数说明是否必返规范
codeint状态码Y见响应码参数说明
messagestring返回码描述Y见响应码参数说明
requestIdstring该条数据任务的唯一标识Y本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
dataIdstring作品IdN和传入的dataId对应
btIdstring视频唯一标识Y和传入的btId对应
riskLevelstring风险级别,code为1100时存在Y返回值:
PASS:正常内容,建议直接放行
REVIEW:可疑内容,建议人工审核
REJECT:违规内容,建议直接拦截
frameDetailjson_array风险详情N有风险片段或returnAllImg=1时返回,详见frameDetail说明
audioDetailjson_array音频片段信息N有风险片段或returnAllAudio=1时返回,详见audioDetail说明

其中,frameDetail数组中每个成员的具体内容如下:

参数名类型参数说明是否必返规范
timefloat截帧在视频文件中的时间,单位为秒Y截帧图片相对视频文件的时间
requestIdstring当前截帧片段的唯一标识Y
imgUrlstring当前截帧的URLY
imgTextstring截帧图片OCR文本内容N截帧图片OCR文字识别,识别类型包含OCR时会有
riskLevelstring当前截帧的处置建议YPASS:正常内容
REVIEW:可疑内容
REJECT:违规内容
riskLabel1string各个一级标签之间是并列的关系,当riskLevel为PASS时返回normalY一级标签
riskLabel2string二级标签归属于一级标签,当riskLevel为PASS时为空Y二级标签
riskLabel3string三级标签归属于二级标签,当riskLevel为PASS时为空Y三级标签
riskDescriptionstring标签解释Y对于命中用户自定义名单时返回:命中自定义名单;当riskLevel为PASS时返回:正常;其他情况展现形式为一级标签:二级标签:三级标签的中文名
disposaljson_object处置结果N最外层的三级标签做映射之后的值放入disposal中,当未开启公司标签映射 或 未配置标签映射时不返回该字段
riskDetailjson_object风险详情信息Y详见images里的riskDetail内容
auxInfojson_object辅助信息Y一些辅助信息放在这里,详见auxInfo说明

其中,disposal的内容如下:

参数名称类型参数说明是否必返规范
riskLevelstring处置建议N可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
riskLabel1string映射后一级风险标签N一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string映射后二级风险标签N二级风险标签,当riskLevel为PASS时为空
riskLabel3string映射后三级风险标签N二级风险标签,当riskLevel为PASS时为空
riskDescriptionstring映射后风险原因N当riskLevel为PASS时为"正常"
riskDetailjson_object映射后风险详情N风险详情

frameDetail中,auxInfo的内容如下:

参数名类型参数说明是否必返规范
qrContentstring截帧图片二维码链接识别N截帧图片二维码链接识别,如有需要可联系数美开启
注意:开启该功能后,只有完整,可以正常识别到的二维码才会返回且imgType传值需要包含AD
similarityfloat当前截帧图片和上一帧截帧图片的相似度Y有图片则该字段就会返回,视频文件初始第一帧将比对纯黑背景图片

其中,audioDetail数组中每个成员的具体内容如下:

参数名类型参数说明是否必返规范
requestIdstring流水号Y
audioStarttimefloat音频片段发生时间Y
audioEndtimefloat音频片段结束时间Y
audioUrlstring音频片段地址Y
audioTextstring音转文文字N识别出文本会返回
riskLevelstring当前事件的处置建议YPASS:正常内容
REVIEW:可疑内容
REJECT:违规内容
riskLabel1string各个一级标签之间是并列的关系,riskLevel为PASS时返回normalY一级标签
riskLabel2string二级标签归属于一级标签,当riskLevel为PASS时为空Y二级标签
riskLabel3string三级标签归属于二级标签,当riskLevel为PASS时为空Y三级标签
riskDescriptionstring标签解释Y格式为"一级风险标签:二级风险标签:三级风险标签"的中文名称;对于命中用户自定义名单时返回:命中自定义名单
riskDetailjson_object风险详情信息Y详见riskDetail说明

audioDetail中,riskDetail的每个元素详细内容如下:

参数名类型参数说明是否必返规范
riskSourceint风险来源Y风险来源,可选值:
1000:无风险
1001:文本风险
1002:视觉风险
1003:音频风险
audioTextstring音频转译文本的结果N
matchedListsjson_array命中的客户自定义名单信息N命中客户自定义名单时返回,其他时不存在,详见matchedLists说明
riskSegmentsjson_array高风险内容片段N在涉政、暴恐、违禁、竞品、广告法等功能的时候存在,详见riskSegments说明

files 里每个元素的内容

参数名称类型参数说明是否必返规范
codeint响应码Y见响应码参数说明
messagestring响应码说明Y见响应码参数说明
requestIdstring该条数据任务的唯一标识Y本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
dataIdstring作品IdN和传入的dataId对应
btIdstring请求标识Y和传入的btId对应
riskLevelstring处置建议Y可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截
detailjson_array风险详情Y详见detail参数

其中detail字段如下:

参数名称类型是否必选说明
descriptionstringY策略规则风险原因描述

响应码参数

codemessage
1100成功
1901QPS超限
1902参数不合法
1903服务失败
1911下载失败
9101无权限操作

人工审核结果#

名称类型是否必填说明
btIdstringY任务唯一标识
requestIdstringY请求唯一流水号
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
resultTypeintY0:机审,1:人审
detailsjson_objectY审核结果详情(需要后台配置开关,默认是关闭状态,里层的字段为空)
passThroughjson_objectN透传字段

details里面的内容(返回所有的子项审核结果)

名称类型是否必填说明
textsjson_arrayY文本审核结果,如果没有传入或者没有开启单项审核功能,则为空
imagesjson_arrayY图片审核结果,如果没有传入或者没有开启单项审核功能,则为空
audiosjson_arrayY音频文件审核结果,如果没有传入或者没有开启单项审核功能,则为空
videosjson_arrayY视频文件审核结果,如果没有传入或者没有开启单项审核功能,则为空
filesjson_arrayY文档审核结果,如果没有传入或者没有开启单项审核功能,则为空

texts里每个元素的内容:

参数名称类型是否必填参数说明
btIdstringY文本唯一标识,和传入值一致
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
descriptionstringN风险原因,支持客户自定义二级原因配置;若存在二级原因,则通过"/"进行拼接,例如:色情/露点

images里每个元素的内容:

参数名称类型是否必填参数说明
btIdstringY数据唯一标识
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
descriptionstringN风险原因,支持客户自定义二级原因配置;若存在二级原因,则通过"/"进行拼接,例如:色情/露点

audios里每个元素的内容:

参数名称类型是否必填参数说明
btIdstringY数据唯一标识
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
audioTimeintY整段音频的音频时长,单位秒
descriptionstringN风险原因,支持客户自定义二级原因配置;若存在二级原因,则通过"/"进行拼接,例如:色情/露点
audioDetailjson_arrayN音频片段详情,见下表说明

videos里每个元素的内容:

参数名称类型是否必填参数说明
btIdstringY数据唯一标识
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
descriptionstringN风险原因,支持客户自定义二级原因配置;若存在二级原因,则通过"/"进行拼接,例如:色情/露点
auxInfojson_objectY额外信息,1100时,必返
frameDetailjson_arrayN截帧片段详情,见下表说明
audioDetailjson_arrayN音频片段详情,见下表说明

auxInfo内容 | 参数名称 | 类型 | 是否必填 | 参数说明 | | --- | --- | --- | --- | | time | int | Y | 视频时长,单位秒 |

frameDetail内容

参数名称类型是否必填参数说明
requestIdstringY唯一标识
imgUrlstringY截帧图片地址,需要人工手动勾选,否则为空
timefloatN截帧在视频文件中的时间,单位为秒
imgTextstringN截帧图片OCR文字识别,识别类型包含OCR时会有

audioDetail内容

参数名称类型是否必填参数说明
requestIdstringY唯一标识
audioUrlstringY音频片段地址,需要人工手动勾选,否则为空
audioStarttimefloatN音频片段结束时间,相对音频开始时间的距离,单位是秒
audioEndtimefloatN音频片段结束时间,相对音频开始时间的距离,单位是秒

files里每个元素的内容:

参数名称类型是否必填参数说明
btIdstringY数据唯一标识
requestIdstringY本次请求数据的唯一标识,用于问题排查和效果优化,强烈建议保存
riskLevelstringY可能返回值:
PASS:正常
REJECT:违规
descriptionstringN风险原因,支持客户自定义二级原因配置;若存在二级原因,则通过"/"进行拼接,例如:色情/露点

返回参数

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

参数名称类型是否必选说明
codeintY返回码,成功返回1100,会判断请求是否成功;非1100认为失败
messagestringY返回码详情描述

附录#

业务标签识别类型类型说明备注
AGE人脸 - 年龄可识别未成年人
GENDER人脸 -性别
BEAUTY人脸 - 颜值
RACE人脸 - 人种如黑种人、白种人、黄种人
FACEDETECTION人脸-人脸检测如识别无人脸、真人、口罩人脸、正脸、侧脸等
FAKEFACE人脸 - 伪造人脸
FACECOMPARE人脸-人脸对比
PUBLICFIGURE人物 - 公众人物如识别知名明星、网红等
TAINTEDSTAR人物 - 劣迹人物
POSTURE人像-人像姿态如识别坐姿、跪姿等
DRESS人像 - 人像穿着如识别jk、汉服等
TEMPERAMENT人像 - 人像气质如成熟大叔、靓丽女神等
BODY人体如识别头发、眼睛、鼻子等
PICTUREFORM画面属性 - 画面类型如识别动漫、表情包等
PICTURESTRUCT画面属性-画面结构如识别宫格图、桥段图等
LOWVISION画面属性 - 画面低质如识别模糊、涂抹、马赛克等
LOWCONTNET画面属性 - 内容低质如识别点线密集、虫类密集等
LIVEPICTURE画面属性-直播画面如识别床上直播、开车直播等
SCREENSHOT画面属性 - APP截图(内容搬运)如识别朋友圈截图、聊天截图等
FITNESS场景主题-健身
CATE场景主题-美食
MUSIC场景主题-音乐
SPORTS场景主题-体育
SCENERY场景主题-自然风光如识别天空、大海、草原等
CITYVIEW场景主题-城市风光如识别街景
3CPRODUCTSLOGOLOGO - 3C电子类品牌如识别华为、小米、OPPO等LOGO
SHOPPINGAPPSLOGOLOGO - 购物比价类应用如识别拼多多等LOGO
RETOUCHAPPSLOGOLOGO - 拍摄美化类应用如识别快剪辑、秒拍等LOGO
SOCIALAPPSLOGOLOGO - 社交通讯类应用如识别微博、小红书等LOGO
PHOTOMATERIALLOGOLOGO - 素材版权类应用如识别CFP等LOGO
NEWSAPPSLOGOLOGO - 新闻阅读类应用如识别新浪、视觉中国等LOGO
ENTERTAINMENTAPPSLOGOLOGO - 影音娱乐类应用如识别抖音、快手等LOGO
SPORTSLOGOLOGO - 体育赛事如识别奥运会等LOGO
APPARELLOGOLOGO - 鞋帽服饰类品牌如识别VANS、H&M等LOGO
ACCESSORIESLOGOLOGO - 饰品首饰类品牌如识别AudemarsPiguet、Nomos等LOGO
COSMETICSLOGOLOGO - 化妆品类品牌如识别LOTTE、EyesLipsFace等LOGO
FOODLOGOLOGO - 食品类品牌如识别Starbucks、LOTTE等LOGO
AUTOTRADEAPPSLOGOLOGO - 汽车交易平台类如识别懂车帝、易车、太平洋汽车、爱卡等LOGO
VEHICLE物品-交通工具
BUILDING物品-建筑
TABLEWARE物品-餐具
FOOD物品-食物
HOMEAPPLICATION物品-家用电器
OFFICESUPPLIES物品-办公用品
FASHION物品-穿着用品
SPORTEQUIPMENT物品-运动器材
TOY物品-玩具
MAKEUP物品-化妆品
DRUGS物品-药品
PAINTING物品-绘画作品
ELECTRONIC物品-电子产品
MEDICALIMAGE物品-医疗影像
FURNITURE物品-家居用品
DAILYSUPPLIES物品-生活用品
CONSTELLATION物品-星座占卜
KITCHENWARE物品-厨房用品
KEEPSAKE物品 - 纪念品
MAMMAL动物-哺乳动物
BIRDS动物 - 鸟类
REPTILE动物-爬行动物
FISH动物-鱼
ARTHROPOD动物 - 节肢动物
COELENTERATE动物 - 腔肠动物
MOLLUSKS动物 - 软体动物
CRUSTACEAN动物 - 甲壳动物
PLANT植物
SETTING场所如识别卫生间、酒店、厨房等

示例#

上传接口请求示例:#

{
"accessKey":"xxxxxxx",
"appId":"1580843258245054465",
"callback":"https://callback/mapping",
"data":{
"btId":"1054078867_61ed6f2e801a648ea71748d0067ecb10",
"contents":[
{
"audioType":"POLITICAL_PORN_AD_MOAN_ABUSE",
"btId":"f338c6a3ce094188c5ad7379837d396e",
"content":"https://video/1054078867_5191515227_56.mp4",
"dataType":"video",
"imgType":"POLITICS_AD_PORN"
},
{
"btId":"a7b58140f37a7d5c3293233fede4fc29",
"content":"10月5日(发布)河北石家庄,来自遵纪守法的快乐!男子酒后叫,10月5日(发布)河北石家庄,来自遵纪守法的快乐!男子酒后叫",
"dataType":"text",
"txtType":"TEXTRISK"
},
{
"btId":"96273f7420ba4cd4e79f58706d8a5a90",
"content":"https://image/557155_H169_sc.jpg",
"dataType":"image",
"imgType":"POLITICS_AD_PORN"
}
],
"detectFrequency":1,
"returnAudioAllText":0,
"returnVideoAllAudio":0,
"returnVideoAllImg":0,
"tokenId":"1054078867"
},
"eventId":"201",
"passThrough":{
"ack":"T6bRheiofkGwku6gXQGi",
"taskIdImageUrMap":{
"96273f7420ba4cd4e79f58706d8a5a90":"xxxxxx"
}
}
}

上传接口返回示例:#

{
"code": 1100,
"message": "成功",
"requestId": "871fe334c04301fbfc1d2dce919383a5"
}

异步回调结果示例:#

{
"btId":"1054078867_61ed6f2e801a648ea71748d0067ecb10",
"details":{
"audios":[
],
"files":[
],
"images":[
],
"texts":[
],
"videos":[
{
"btId":"f338c6a3ce094188c5ad7379837d396e",
"code":1100,
"frameDetail":[
{
"auxInfo":{
"similarity":0.63671875
},
"imgText":"星沙时报掌上星图@@咕男子酒后叫代驾送自己团家途中偶遇交警查酒驾骂大方打招呼",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v0.jpg?Expires=1699514866\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=LLOAfFq0Ii9aBbzrojeLMxuvuKA%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v0",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星图@@咕男子酒后叫代驾送自己团家途中偶遇交警查酒驾骂大方打招呼"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":0
},
{
"auxInfo":{
"similarity":0.7421875
},
"imgText":"星沙时报掌上TV:0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报IN行专HA TIME510月5日(发布时间)河北石家庄如有侵权 联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v1.jpg?Expires=1699514866\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=8DMpchD7vwYuTc%2B4CBq1voAA0gM%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v1",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上TV:0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报IN行专HA TIME510月5日(发布时间)河北石家庄如有侵权 联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":1
},
{
"auxInfo":{
"similarity":0.875
},
"imgText":"星沙时报掌上星 米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报XINGSHA TIME510月5日(发布时间)河北石家庄如有侵权 联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v3.jpg?Expires=1699514866\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=H2ZtcBLWeOl88wXTXsng4lt%2Btm4%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v3",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星 米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报XINGSHA TIME510月5日(发布时间)河北石家庄如有侵权 联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":3
},
{
"auxInfo":{
"similarity":0.734375
},
"imgText":"星沙时报掌上星0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报XING5HA TIME5如有侵权 联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v6.jpg?Expires=1699514867\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=nr%2B3BQGOj6aqIrDkLm776HiTvxs%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v6",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报XING5HA TIME5如有侵权 联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":6
},
{
"auxInfo":{
"similarity":0.6953125
},
"imgText":"星沙时报掌上星y.o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报INGSHA TIMEs如有侵权 联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v9.jpg?Expires=1699514867\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=%2Bixrpu9pU6VX4Bw%2BZbC%2BEbPukWc%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v9",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星y.o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报INGSHA TIMEs如有侵权 联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":9
},
{
"auxInfo":{
"similarity":0.62890625
},
"imgText":"星沙时报掌上星y 0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满如有侵权联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v11.jpg?Expires=1699514868\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=niYP2Ps5UEWrsVClMzcKQaWw3TQ%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v11",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星y 0米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满如有侵权联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":11
},
{
"auxInfo":{
"similarity":0.6796875
},
"imgText":"星沙时报掌上星.o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报当事人史先生:喝酒肯定是不能开车的嘛如有侵权联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v12.jpg?Expires=1699514868\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=oxS9mKa%2BZRND8OKjVEWXcHHsjrc%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v12",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星.o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报当事人史先生:喝酒肯定是不能开车的嘛如有侵权联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":12
},
{
"auxInfo":{
"similarity":0.8203125
},
"imgText":"星沙时报掌上星 o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报当事人史先生:拍这个视频如有侵权联系删除",
"imgUrl":"http://sh-oss-jan1.cn-shanghai.oss.aliyuncs.com/POST_VIDEO%2FPOST_VIDEO_IMG%2F20231010%2F5ccdcac4d3c017ba3a28e6cec6497037_v13.jpg?Expires=1699514868\u0026OSSAccessKeyId=LTAI5tLsVBxJ8nhyy5gQVW3K\u0026Signature=qAD%2BuEk8iNovLM7hl%2Fi%2BA2WMFYM%3D",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037_v13",
"riskDescription":"涉政:政治象征:公检法制服",
"riskDetail":{
"ocrText":{
"text":"星沙时报掌上星 o米咕男子酒后叫代驾送自己回家途中偶遇交警查酒驾大方打招呼底气满满星沙时报当事人史先生:拍这个视频如有侵权联系删除"
},
"riskSource":1002
},
"riskLabel1":"politics",
"riskLabel2":"zhengzhixiangzheng",
"riskLabel3":"gongjianfazhifu",
"riskLevel":"REJECT",
"time":13
}
],
"auxInfo":{"time":13},
"message":"success",
"requestId":"5ccdcac4d3c017ba3a28e6cec6497037",
"riskLevel":"REJECT"
}
]
},
"passThrough":{
"ack":"T6bRheiofkGwku6gXQGi",
"taskIdImageUrMap":{
"96273f7420ba4cd4e79f58706d8a5a90":"xxxxxx"
}
},
"requestId":"871fe334c04301fbfc1d2dce919383a5",
"resultType":0,
"riskLevel":"REJECT"
}

在线咨询