视频内容检测

最近更新时间:2019-08-15 23:22:40

1. 接口描述

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

视频内容检测(Video Moderation, VM)服务能识别涉黄、涉政、涉恐等违规视频,同时支持用户配置视频黑库,打击自定义的违规内容。


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

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

参数名 类型 描述
SeqID String 请求seqId唯一标识
EvilFlag Integer 是否恶意:0正常,1可疑(Homology模块下:0未匹配到,1恶意,2白样本)
EvilType Integer 恶意类型:100正常,20001政治,20002色情
Duration Integer 视频时长(单位:秒)
PornDetect 视频智能鉴黄
PolityDetect 视频涉政识别
Homology 相似度识别
HitFlag Integer 0正常,1可疑
Score Integer 判断分值
SeedUrl String 命中的种子URL

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

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:VideoModeration
Version String 公共参数,本接口取值:2019-03-21
Region String 公共参数,详见产品支持的 地域列表
CallbackUrl String 回调Url
FileMD5 String 视频文件MD5
FileContent String 视频内容base64
FileUrl String 视频内容Url,其中FileUrl与FileContent二选一

3. 输出参数

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

4. 示例

示例1 视频内容异步回调

回调CallbackUrl示例

输入示例

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

输出示例

{
  "SeqID": "9c4c7dec-b618-4a38-bd87-d9f03ce0950f",
  "Action": "VideoModeration",
  "Data": {
    "EvilFlag": 0,
    "EvilType": 100,
    "FileUrl": "https://test-1254417591.cos.ap-chengdu.myqcloud.com/video/video_test.mp4",
    "MD5": "eb410ca7d529d53b95b592ebf08f7035",
    "Duration": 12,
    "PornDetect": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": null,
      "SeedUrl": ""
    },
    "PolityDetect": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": null,
      "SeedUrl": ""
    },
    "Homology": {
      "HitFlag": 0,
      "Score": 0,
      "EvilType": 100,
      "Keywords": null,
      "SeedUrl": ""
    }
  }
}

示例2 视频内容检测

BusinessCode;60001 表示请求异步任务成功

输入示例

https://cms.tencentcloudapi.com/?Action=VideoModeration
&FileUrl="http://xxxxxxx/201904183.mp4"
&FileMD5="F977DE3031487AB6283245F19D3383A6"
&CallbackUrl="http://127.0.0.1:12345/result"
&FileContent=字符串型
&<公共请求参数>

输出示例

{
  "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.ErrVideoTimeOut 视频识别服务超时
UnauthorizedOperation.ErrAuth 鉴权失败
UnauthorizedOperation.Unauthorized 未开通权限