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

前提条件

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

背景信息

证据转存目前只支持视频、语音对象的检测(参见相关检测接口)。本文所述转存文件特指机审结果为违规(返回suggestion=block)或疑似(返回suggestion=review)的被检测视频、语音。
证据转存默认关闭,若需使用,您必须开启并配置视频证据转存、语音证据转存。
  • 开启视频证据转存后,机审结果违规、疑似的视频文件(含视频流)和视频截帧图片会转存到您配置的Bucket中。
  • 开启语音证据转存后,机审结果违规、疑似的语音文件(含语音流)和语音分片会转存到您配置的Bucket中。

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

操作步骤

  1. 登录云盾内容安全控制台
  2. 在左侧导航栏,单击设置 > 内容检测API
  3. 单击证据转存页签,并根据需要开启视频证据转存语音证据转存,完成相关配置。
    说明 如果您是初次登录,则需要根据页面提示完成OSS授权,授予内容安全对对象存储服务的读写权限(复用当前OSS违规检测的授权)。如果已经完成授权,则直接进入配置页面。
    证据转存
    配置项 说明
    转存Bucket 用来存储证据文件的OSS存储空间。
    转存目录 用户传递目录。所有证据文件按照转存规则存放在指定的用户传递目录下。更多信息,请参见转存规则说明
    说明 若指定的目录在转存Bucket中不存在,则会自动创建。
    访问链接有效期 证据文件转存后生成的访问链接的有效期,取值范围:300~3600(秒)。
  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秒的语音片段。

相关检测接口