使用内容检测API时,若您希望留存机审结果为违规、疑似的被检测文件,您可以开启证据转存功能。证据转存与阿里云对象存储OSS配合使用,支持将视频、语音检测中识别到的违规、疑似文件转存到您指定的OSS存储空间,并返回转存文件的OSS URL链接。本文介绍了开启和配置使用证据转存的操作方法。

前提条件

已开通对象存储OSS,并创建存储空间(bucket)用来转存证据文件。更多信息,请参见开通OSS服务创建存储空间

背景信息

证据转存目前只支持视频、语音对象的检测(参见相关检测接口)。本文所述转存文件特指机审结果为违规(返回suggestion=block)、疑似(返回suggestion=review)的被检测视频、语音。

证据转存默认关闭,若需使用,您必须开启并配置视频证据转存、语音证据转存。
  • 开启视频证据转存后,机审结果违规、疑似的视频文件(含视频流)和视频截帧图片会转存到您配置的bucket中。
  • 开启语音证据转存后,机审结果违规、疑似的语音文件(含语音流)、语音分片会转存到您配置的bucket中。

证据文件转存到OSS存储空间后,OSS为其生成公网可访问的URL链接。您可以在相关API检测请求的返回参数中获取OSS URL链接。链接有效期在300秒到86400秒之间,您可以根据需要自行设置。

操作步骤

  1. 登录云盾内容安全控制台
  2. 前往设置 > 内容检测API页面,并打开证据转存页签。
    如果您是初次登录,则需要根据页面提示完成OSS授权,授予内容安全对对象存储服务的读写权限(复用当前OSS违规检测的授权)。如果已经授权过,则直接进入配置页面。证据转存
  3. 证据转存页签,根据需要选择开启视频证据转存语音证据转存,并完成相关配置。配置描述如下。
    配置项 说明
    转存bucket 用来存储证据文件的OSS存储空间。
    转存目录 用户传递目录。所有证据文件按照转存规则存放在指定的用户传递目录下。更多信息,请参见转存规则说明
    说明 若指定的目录在转存bucket中不存在,则会自动创建。
    访问链接有效期 证据文件转存后生成的访问链接的有效期,取值范围:3600~604800(秒)。
  4. 单击保存
    成功配置证据转存。在下次调用视频审核、语音反垃圾检测(参见相关检测接口)并检测出违规或者可疑的视频、语音内容时,您将在返回参数(视频审核对应extras.newUrl、语音反垃圾对应new_url)中查看转存文件的OSS URL链接;您也可以前往OSS控制台,在转存bucket中查看转存文件。

转存规则说明

表 1. 视频转存规则
文件类型 存放目录 命名规则
视频文件 ${bucket}/${用户传递目录}/video/${suggestion}/${taskId}/${视频名称.后缀} 转存的视频文件以原视频文件名称命名。
视频截帧 ${bucket}/${用户传递目录}/video/${suggestion}/${taskId}/frames/${截帧图片名.后缀} 转存的截帧图片以截帧的时间点命名。例如00_01_02,表示00时01分02秒的截帧。
视频流 ${bucket}/${用户传递目录}/video/${suggestion}/${taskId}/${视频流名称.后缀} 转存的视频流以开始检测时间命名。例如20190102_12_02_03.wav,表示2019年01月02号12时02分03秒开始检测的视频流。
表 2. 语音转存规则
文件类型 存放目录 命名规则
语音文件 ${bucket}/${用户传递目录}/audio/${suggestion}/${taskId}/${语音名称.后缀} 转存的语音文件以原语音文件名称命名。
语音分片 ${bucket}/${用户传递目录}/audio/${suggestion}/${taskId}/slice/${语音分片名.后缀} 转存的语音分片以语音开始和结束时间命名。例如00_01_02-00_10_13.mp3,表示语音中从00时01分02秒到00时10分13秒的语音片段。

相关检测接口