音频内容检测

最近更新时间:2019-10-11 14:22:29

1. 接口描述

接口请求域名: cms.tencentcloudapi.com 。

音频内容检测(Audio Moderation, AM)服务使用了波形分析、声纹分析等技术,能识别涉黄、涉政、涉恐等违规音频,同时支持用户配置音频黑库,打击自定义的违规内容。


接口返回值说明:调用本接口有两个返回值,一个是同步返回值,一个是识别完成后的异步回调返回值。

音频识别结果存在于异步回调返回值中,异步回调返回值明细:

参数名 类型 描述
SeqID String 请求seqId唯一标识
EvilFlag Integer 是否恶意:0正常,1可疑(Homology模块下:0未匹配到,1恶意,2白样本)
EvilType Integer 恶意类型:100正常,20001政治,20002色情,20007谩骂
Duration Integer 音频时长(单位:毫秒)
PornDetect AudioDetectData 音频智能鉴黄
PolityDetect AudioDetectData 音频涉政识别
CurseDetect AudioDetectData 音频谩骂识别
CustomizedDetect AudioDetectData 自定义识别
Homology AudioDetectData 相似度识别

AudioDetectData

参数名 类型 描述
HitFlag Integer 0正常,1可疑
Score Integer 判断分值
EvilType Integer 恶意类型:100正常,20001政治,20002色情,20007谩骂
Keywords Array of String 关键词明细
StartTime Array of String 恶意开始时间(Homology、CustomizedDetect无此字段)
EndTime Array of String 恶意结束时间(Homology、CustomizedDetect无此字段)
SeedUrl String 命中的种子URL

默认接口请求频率限制:50次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:AudioModeration
Version String 公共参数,本接口取值:2019-03-21
Region String 公共参数,详见产品支持的 地域列表
CallbackUrl String 回调URL,音频识别结果将以POST请求方式发送到此地址
FileContent String 音频内容的base64
FileMD5 String 音频文件的MD5值
FileUrl String 音频内容Url ,其中FileUrl和FileContent二选一

3. 输出参数

参数名称 类型 描述
BusinessCode Integer 业务返回码
60001:成功请求回调任务
Data Array of String 识别返回结果
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 音频内容异步回调

回调CallbackUrl示例

输入示例

https://cms.tencentcloudapi.com/?Action=AudioModeration
&FileUrl="http://xxx.mp3"
&CallbackUrl="http://xxx"
&FileContent=字符串型
&FileMD5=字符串型
&<公共请求参数>

输出示例

{
  "SeqID": "da061a9e-5d40-4609-8d04-5d198cef97f3",
  "Action": "AudioModeration",
  "BusinessCode": 0,
  "Data": {
    "EvilFlag": 1,
    "EvilType": 20002,
    "FileUrl": "http://xxx.mp3",
    "MD5": "fdc8148fb615b1fa272cd3aa33f34024",
    "Duration": 14762,
    "PornDetect": {
      "HitFlag": 1,
      "Score": 55,
      "EvilType": 20002,
      "Keywords": [
        ""
      ],
      "StartTime": [
        "1800"
      ],
      "EndTime": [
        "13980"
      ],
      "SeedUrl": ""
    },
    "PolityDetect": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": [
        ""
      ],
      "StartTime": [
        ""
      ],
      "EndTime": [
        ""
      ],
      "SeedUrl": ""
    },
    "CurseDetect": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": [
        ""
      ],
      "StartTime": [
        ""
      ],
      "EndTime": [
        ""
      ],
      "SeedUrl": ""
    },
    "CustomizedDetect": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": [
        ""
      ],
      "SeedUrl": ""
    },
    "Homology": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": null,
      "SeedUrl": ""
    }
  }
}

示例2 音频内容检测

BusinessCode;60001 标识请求异步任务成功

输入示例

https://cms.tencentcloudapi.com/?Action=AudioModeration
&FileUrl="http://xxx.mp3"
&CallbackUrl="http://xxx"
&FileContent=字符串型
&FileMD5=字符串型
&<公共请求参数>

输出示例

{
  "Response": {
    "RequestId": "9c4c7dec-b618-4a38-bd87-d9f03ce0950f",
    "Data": null,
    "BusinessCode": 60001
  },
  "retcode": 0,
  "retmsg": "AsyncModerationTask"
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InternalError 内部错误
InvalidParameter.ParameterError 参数不可用
InvalidParameterValue.ErrFileContent FileContent不可用:需Base64编码
MissingParameter.ErrFileUrl FileUrl或FileContent都为空
ResourceNotFound.ErrDowdownTimeOut 文件链接下载超时
ResourceUnavailable.ErrAudioTimeOut 音频识别服务超时
UnauthorizedOperation.ErrAuth 鉴权失败
UnauthorizedOperation.Unauthorized 未开通权限