业务接口:/green/video/asyncscan,表示视频异步检测。
视频异步检测接口的调用逻辑如下图所示。
场景
描述
检测结果分类
视频智能鉴黄
检测视频中是否包含色情内容。
正常、色情
视频暴恐涉政
检测视频中是否包含暴恐涉政内容。
正常、暴恐涉政
视频不良场景
检测视频中是否包含不良场景。
正常、不良场景(例如黑屏、白屏)
视频logo
检测视频中是否包含特定的logo。
正常、logo
视频图文违规
视频语音违规
检测视频中的语音内容是否包含违规信息。
默认识别语言为中文。如果您需要识别英文内容,请联系商务经理。
如果您对时效性要求不高,推荐您开启近线检测模式(offline),近线检测模式会在您提交任务的24小时内开始检测。
名称
类型
是否必选
示例值
bizType
String
否
default
live
Boolean
false
是否直播。取值:
offline
是否近线检测模式。
该参数仅适用于视频文件检测,视频流检测无需传入该参数。
scenes
StringArray
是
["porn"]
指定视频检测场景。取值:
audioScenes
["antispam"]
指定视频语音检测场景,唯一取值:antispam,表示语音反垃圾。
不传入该参数时仅检测视频图像内容;如果传入该参数,则在检测视频中图像的同时,对视频中语音进行检测。
如果需要检测视频语音,则不支持通过上传视频截帧序列的方式(即在task中传入frames)进行检测,您必须传入视频或视频流的URL地址(即在task中传入url)进行检测。
callback
检测结果回调通知您的URL,支持使用HTTP和HTTPS协议的地址。该字段为空时,您必须定时轮询检测结果。
callback接口必须支持POST方法、UTF-8编码的传输数据,以及表单参数checksum和content。内容安全按照以下规则和格式设置checksum和content,调用您的callback接口返回检测结果。
您的服务端callback接口收到内容安全推送的结果后,如果返回的HTTP状态码为200,则表示接收成功,其他的HTTP状态码均视为接收失败。接收失败时,内容安全将最多重复推送16次检测结果,直到接收成功。重复推送16次后仍未接收成功,则不再推送,建议您检查callback接口的状态。
seed
abc****
随机字符串,该值用于回调通知请求中的签名。
由英文字母、数字、下划线(_)组成,不超过64个字符。由您自定义,用于在接收到内容安全的回调通知时校验请求由阿里云内容安全服务发起。
当使用callback时,该字段必须提供。
tasks
JSONArray
clientInfo
JSONObject
{"userId":"12023****","userNick":"Mike","userType":"others"}
服务器会把全局的clientInfo和此处独立的clientInfo合并。
独立的clientInfo优先级更高。
dataId
videoId****
检测对象对应的数据ID。
由大小写英文字母、数字、下划线(_)、短划线(-)、英文句号(.)组成,不超过128个字符,可以用于唯一标识您的业务数据。
liveId
liveId****
视频直播流的ID。
该参数用于视频直播任务去重,防止重复检测,如果传递该参数,会根据uid+bizType+liveId判断是否存在检测中的直播任务。如果存在,就直接返回已存在的直播检测taskId,不发起新的任务。
url
检测对象的URL。
frames和url二选一。传入url字段后将按照传视频URL的方式计费。
frames
framePrefix
截帧地址的前缀,与frame.url一起组成截帧的完整地址。视频截帧的完整地址格式为framePrefix+frame.url。
interval
Integer
1
视频截帧间隔,单位为秒,取值范围:1~600。默认值为1秒。
maxFrames
200
视频截帧的URL,与framePrefix一起组成截帧的完整地址。视频截帧的完整地址格式为framePrefix+frame.url。
offset
10
taskId
taskId****
检测任务的ID。
如果在检测请求参数中传入了dataId,则此处返回对应的dataId。
请求示例
正常返回示例
{"code":200,"msg":"OK","requestId":"requestID****","data":[{"dataId":"videoId****","taskId":"taskId****"}]}(视频异步检测结果查询)使用说明业务接口:/green/video/results,表示查询视频异步检测结果。
本接口的单用户QPS限制为50次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
body
["taskId****","taskId****"]
要查询的检测任务的taskId列表。数组中的元素个数不超过100个。
您在提交检测任务后,可以从返回数据中获取检测任务的taskId。
code
错误码,和HTTP状态码一致。
msg
OK
请求信息的响应信息。
results
audioScanResults
scene
porn
视频检测场景,和调用请求中的场景对应。取值:
label
视频检测结果的分类。不同检测场景的结果分类不同,具体如下:
sublabel
如果检测场景包含智能鉴黄(porn)和暴恐涉政(terrorism),则该字段可以返回检测结果的细分类标签。
该字段默认不会返回。如果有需要,请加入钉群(钉群号:35573806),联系产品技术专家进行咨询。
suggestion
block
建议您执行的后续操作。取值:
rate
Float
99.2
置信度分数,取值范围:0(表示置信度最低)~100(表示置信度最高)。
如果suggestion为pass,则置信度越高,表示内容正常的可能性越高;如果suggestion为review或block,则置信度越高,表示内容违规的可能性越高。
建议您参考suggestion和label(或者部分接口返回的sublabel)结果用于内容违规判定。
hintWordsInfo
只有图文违规(ad)场景会返回该结果。
logoData
只有视频logo(logo)场景会返回该结果。
sfaceData
只有视频暴恐涉政(terrorism)场景会返回该结果。
视频截帧的地址。
50
视频截帧的检测结果分类。不同检测场景的结果分类不同,具体如下:
99.1
置信度分数,取值范围:0~100,置信度越高表示检测结果的可信度越高。建议您不要在业务中使用该分数。
antispam
视频语音检测场景,唯一取值:antispam,表示语音反垃圾。
customized
视频语音的检测结果分类。不同检测场景的结果分类不同,具体如下:
99.91
details
startTime
24
endTime
60
text
计算机
语音转换成文本的结果。
normal
该句语音的检测结果分类。取值:
keyword
开启
如果命中了用户自定义关键词,返回命中的关键词。
libName
人工
如果命中了用户自定义关键词,返回关键词所在词库。
type
TV
识别出的logo类型,取值为TV(台标)。
name
***台
识别出的logo名称。
x
140
以图片左上角为坐标原点,logo区域左上角到y轴距离,单位:像素。
y
68
以图片左上角为坐标原点,logo区域左上角到x轴距离,单位:像素。