提交音频审核任务

最近更新时间：2021-12-21 15:47:12

前往 GitHub 编辑 我的收藏

本页目录：

功能描述

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

该接口支持情况如下：

支持对音频文件进行自动检测，从 ASR 语音文本识别、色情呻吟两个维度，通过深度学习技术识别音频中的违规内容。
支持设置回调地址 Callback 获取检测结果，或通过查询音频审核任务结果接口主动轮询获取审核结果详情。
支持识别多种违规场景，包括：色情、违法、广告等场景。
支持根据不同的业务场景配置自定义的审核策略。

费用说明

每个审核场景单独计费，例如您选择审核涉黄、广告两种场景，则审核1个音频，计2次审核费用。
调用接口会产生音频审核费用和 COS 读请求费用。
如果音频属于 COS 上的低频存储类型，调用审核会产生 COS 低频数据取回费用。
不支持审核 COS 上的归档存储类型和深度归档存储类型的音频，如果需要审核此类型音频，请先恢复归档文件。

限制说明

音频文件大小支持：文件 < 600MB。
音频文件时长支持：< 3小时。
音频码率类型支持：128Kbps - 256Kbps。
音频文件支持格式：mp3、wav、aac、flac、amr、3gp、m4a、wma、ogg、ape。
音频文件支持的访问方式：音频文件链接、腾讯云对象存储。
音频文件内容语言支持：普通话、英语、粤语。
当输入为视频文件时，支持分离视频文件音轨，并对音频内容进行独立审核。

请求

请求示例

POST /audio/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>
        <Url></Url>
    </Input>
    <Conf>
        <DetectType>Porn,Ads</DetectType>
        <Callback></Callback>
        <BizType></BizType>
    </Conf>
</Request>

具体的数据描述如下：

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

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

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

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

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

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

节点名称（关键字）	父节点	描述	类型	是否必选
BizType	Request.Conf	审核策略，不填写则使用默认策略。可在控制台进行配置，详情请参见设置公共审核策略。	String	否
DetectType	Request.Conf	审核的场景类型，有效值：Porn（涉黄）、Ads（广告）、Illegal（违法）、Abuse（谩骂），可以传入多种类型，不同类型以逗号分隔，例如：Porn,Ads。	String	否
Callback	Request.Conf	审核结果以回调形式发送至您的回调地址，支持以 `http://` 或者 `https://` 开头的地址，例如：`http://www.callback.com`。	String	否
CallbackVersion	Request.Conf	回调内容的结构，有效值：Simple（回调内容包含基本信息）、Detail（回调内容包含详细信息）。默认为 Simple。	string	否

响应

响应头

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

响应体

该响应体返回为 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（已提交审核）、Success（审核成功）、Failed（审核失败）、Auditing（审核中）其中一个。	String
CreationTime	Response.JobsDetail	音频审核任务的创建时间。	String

错误码

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

实际案例

请求

POST /audio/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>
        <Callback>http://callback.com/</Callback>
    </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>2019-07-07T12:12:12+0800</CreationTime>
    </JobsDetail>
</Response>

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