提交视频审核任务

最近更新时间：2021-12-21 14:49:11

前往 GitHub 编辑 我的收藏

本页目录：

功能描述

本接口用于提交一个视频审核任务。视频审核功能为异步任务方式，您可以通过提交视频审核任务审核您的视频文件，然后通过查询视频审核任务接口查询审核结果。

该接口支持情况如下：

支持对视频文件进行自动检测，从 OCR 文本识别、物体检测（实体、广告台标、二维码等）、图像识别及音频审核四个维度，通过深度学习技术，识别视频中的违规内容。
支持设置回调地址 Callback 获取检测结果，或通过查询视频审核任务结果接口主动轮询获取审核结果详情。
支持识别多种违规场景，包括：色情、违法、广告等场景。
支持根据不同的业务场景配置自定义的审核策略。
支持用户自定义配置黑白图片库，打击自定义违规内容。

费用说明

视频的审核分为视频画面审核、视频截帧、视频声音审核，其中：

视频画面审核：基于视频截帧能力，通过视频截帧将视频截取为多张图片进行审核，审核费用与图片审核一致。
视频截帧：会产生相应的视频截帧费用。
视频声音审核：将视频声音分离出来进行音频审核，审核费用与音频审核一致。
每个审核场景单独计费，例如您选择审核涉黄、广告两种场景，则审核1个视频，计2次审核费用。
调用接口会产生图片审核费用、音频审核费用和 COS 读请求费用。
如果音频文件属于 COS 上的低频存储类型，调用审核会产生 COS 低频数据取回费用。
不支持审核 COS 上的归档存储类型和深度归档存储类型的音频，如果需要审核此类型音频，请先恢复归档文件。

限制说明

视频文件大小支持：文件 < 5GB。
视频文件支持格式：flv、mkv、mp4 、rmvb、avi、wmv、3gp、mov、m3u8、m4v 等。
视频文件支持的访问方式：腾讯云对象存储。
支持用户配置审核视频画面或视频声音。

请求

请求示例

POST /video/auditing HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

<body>

说明：

Authorization: Auth String（详情请参见请求签名文档）。

请求头

此接口仅使用公共请求头部，详情请参见公共请求头部文档。

请求体

该请求操作的实现需要有如下请求体。

<Request>
  <Input>
    <Object></Object>
  </Input>
  <Conf>
    <DetectType>Porn,Ads</DetectType>
    <Snapshot>
        <Mode>Interval</Mode>
        <TimeInterval></TimeInterval>
        <Count></Count>
    </Snapshot>
    <Callback></Callback>
    <BizType></BizType>
    <DetectContent></DetectContent>
  </Conf>
</Request>

具体的数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Request	无	视频审核的具体配置项。	Container	是

Container 类型 Request 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Input	Request	需要审核的视频。	Container	是
Conf	Request	审核规则配置。	Container	是

Container 类型 Input 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Object	Request.Input	当前 COS 存储桶中的视频文件名称，例如在目录 test 中的文件 video.mp4，则文件名称为 test/video.mp4。	String	是
Url	Request.Input	视频文件的链接地址，例如 http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/test.mp4。Object 和 Url 只能选择其中一种。	String	否

Container 类型 Conf 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
BizType	Request.Conf	审核策略，不带审核策略时使用默认策略。	String	否
DetectType	Request.Conf	审核的场景类型，有效值：Porn（涉黄）、Ads（广告），可以传入多种类型，不同类型以逗号分隔，例如：Porn,Ads。	String	否
Snapshot	Request.Conf	视频画面的审核通过视频截帧能力截取出一定量的截图，通过对截图逐一审核而实现的，该参数用于指定视频截帧的配置。	Container	是
Callback	Request.Conf	回调地址，以`http://`或者`https://`开头的地址。	String	否
CallbackVersion	Request.Conf	回调内容的结构，有效值：Simple（回调内容包含基本信息）、Detail（回调内容包含详细信息）。默认为 Simple。	String	否
DetectContent	Request.Conf	用于指定是否审核视频声音，当值为0时：表示只审核视频画面截图；值为1时：表示同时审核视频画面截图和视频声音。默认值为0。	Integer	否

Container 类型 Snapshot 的具体数据描述如下：

节点名称（关键字）	父节点	描述	类型	是否必选
Mode	Request.Conf.Snapshot	截帧模式。Interval 表示间隔模式；Average 表示平均模式；Fps 表示固定帧率模式。 Interval 模式：TimeInterval，Count 参数生效。当设置 Count，未设置 TimeInterval 时，表示截取所有帧，共 Count 张图片。 Average 模式：Count 参数生效。表示整个视频，按平均间隔截取共 Count 张图片。 Fps 模式：TimeInterval 表示每秒截取多少帧，Count 表示共截取多少帧。	String	否
Count	Request.Conf.Snapshot	视频截帧数量，范围为(0, 10000]。	String	是
TimeInterval	Request.Conf.Snapshot	视频截帧频率，范围为(0, 60]，单位为秒，支持 float 格式，执行精度精确到毫秒。	Float	否

响应

响应头

此接口仅返回公共响应头部，详情请参见公共响应头部文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

<Response>
    <JobsDetail>
      <JobId></JobId>
      <State></State>
      <CreationTime></CreationTime>
    </JobsDetail>
</Response>

具体的数据内容如下：

节点名称（关键字）	父节点	描述	类型
Response	无	视频审核返回的具体响应内容。	Container

Container 节点 Response 的内容：

节点名称（关键字）	父节点	描述	类型
JobsDetail	Response	视频审核任务的详细信息。	Container

Container 节点 JobsDetail 的内容：

节点名称（关键字）	父节点	描述	类型
JobId	Response.JobsDetail	本次视频审核任务的 ID。	String
State	Response.JobsDetail	视频审核任务的状态，值为 Submitted（已提交审核）、Snapshoting（视频截帧中）、Success（审核成功）、Failed（审核失败）、Auditing（审核中）其中一个。	String
CreationTime	Response.JobsDetail	视频审核任务的创建时间。	String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见错误码文档。

实际案例

请求

POST /video/auditing HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host: examplebucket-1250000000.ci.ap-beijing.myqcloud.com
Content-Length: 166
Content-Type: application/xml

<Request>
  <Input>
    <Object>a.mp4</Object>
  </Input>
  <Conf>
    <DetectType>Porn,Ads</DetectType>
    <Snapshot>
        <Mode>Interval</Mode>
        <TimeInterval>50</TimeInterval>
        <Count>100</Count>
    </Snapshot>
    <Callback>http://callback.com/</Callback>
    <BizType>b81d45f94b91a683255e9a9506f45a11</BizType>
    <DetectContent>1</DetectContent>
  </Conf>
</Request>

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 230
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
  <JobsDetail>
    <JobId>vab1ca9fc8a3ed11ea834c525400863904</JobId>
    <State>Submitted</State>
    <CreationTime>2021-08-07T12:12:12+0800</CreationTime>
  </JobsDetail>
</Response>

上一篇: 请求签名下一篇: 查询视频审核任务结果