使用内容检测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_urldata.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}/${图片名称.后缀} 转存的图片文件以原图片文件名称命名。

相关检测接口