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

前提条件

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

背景信息

证据转存目前只支持视频、语音、图片对象的检测（请参见相关检测接口）。本文所述转存文件特指机审结果为违规（返回suggestion=block）、疑似（返回suggestion=review）或正常（返回suggestion=pass）的被检测视频、语音或者图片。
证据转存默认关闭，若需使用，您必须开启并配置视频证据转存、语音证据转存或者图片证据转存。
  • 开启视频证据转存后，机审结果违规、疑似、正常的视频文件（含视频流）和视频截帧图片会转存到您配置的Bucket中。
  • 开启语音证据转存后，机审结果违规、疑似、正常的语音文件（含语音流）和语音分片会转存到您配置的Bucket中。
  • 开启图片证据转存后，机审结果违规、疑似、正常的图片文件会转存到您配置的Bucket中。
说明 开启证据转存后，会产生OSS存储费用，费用随您的内容数量波动，具体存储费用，请参见对象存储OSS价格信息。

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

操作步骤

  1. 登录云盾内容安全控制台。
  2. 在左侧导航栏，单击设置 > 内容检测API。
  3. 单击证据转存页签，并根据需要开启视频证据转存、语音证据转存或图片证据转存，完成相关配置。
    说明 如果您是初次登录，则需要根据页面提示完成OSS授权，授予内容安全对对象存储服务的读写权限（复用当前OSS违规检测的授权）。如果已经完成授权，则直接进入配置页面。
    证据转存
    配置项 说明
    转存Bucket 用来存储证据文件的OSS存储空间。
    转存目录 用户传递目录。所有证据文件按照转存规则存放在指定的用户传递目录下。更多信息，请参见转存规则说明。
    说明 若指定的目录在转存Bucket中不存在，则会自动创建。
    访问链接有效期 证据文件转存后生成的访问链接的有效期，取值范围：300～3600（秒）。
    转存范围 目前支持以下三种转存范围：
    • 机器识别违规：转存机器识别的违规内容。
    • 机器识别疑似：转存机器识别的疑似违规内容。
    • 机器识别正常：转存机器识别的正常内容。
  4. 单击保存。
    成功配置证据转存后，在下次调用视频审核、语音反垃圾检测、图片审核（请参见相关检测接口）并检测出违规、可疑或者正常的视频、语音或图片内容时，您将在返回参数（视频审核对应data.extras.newUrl、语音反垃圾对应data.new_url和data.result.details.url和图片审核对应data.storedUrl）中查看转存文件的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秒的语音片段。
表 3. 图片转存规则
文件类型 存放目录 命名规则
图片文件 ${bucket}/${用户传递目录}/image/${suggestion}/${taskId}/${图片名称.后缀} 转存的图片文件以原图片文件名称命名。

相关检测接口