使用内容检测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秒的语音片段。

相关检测接口