# 音视频内容安全识别

调试工具

接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

mediaCheckAsync

# 功能描述

本接口用于异步校验图片/音频是否含有违法违规内容。

  • 1.0 版本异步接口文档【点击查看】, 1.0 版本同步接口文档【点击查看】,1.0版本在2021年9月1日停止更新,请尽快更新至2.0

  • 应用场景举例:

  1. 语音风险识别:社交类用户发表的语音内容检测;
  2. 图片智能鉴黄:涉及拍照的工具类应用(如美拍,识图类应用)用户拍照上传检测;电商类商品上架图片检测;媒体类用户文章里的图片检测等;
  3. 敏感人脸识别:用户头像;媒体类用户文章里的图片检测;社交类用户上传的图片检测等。 频率限制:单个 appId 调用上限为 2000 次/分钟,200,000 次/天;文件大小限制:单个文件大小不超过10M

# 注意事项

media_type 需要准确填写 url 对应的多媒体类型,media_url 需要保证可以被检测服务器下载

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/media_check_async?access_token=ACCESS_TOKEN 

# 云调用

  • 出入参和HTTPS调用相同,调用方式可查看云调用说明文档

  • 接口方法为: openapi.security.mediaCheckAsync

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:18

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
media_url string 要检测的图片或音频的url,支持图片格式包括jpg, jepg, png, bmp, gif(取首帧),支持的音频格式包括mp3, aac, ac3, wma, flac, vorbis, opus, wav
media_type number 1:音频;2:图片
version number 接口版本号,2.0版本为固定值2
scene number 场景枚举值(1 资料;2 评论;3 论坛;4 社交日志)
openid string 用户的openid(用户需在近两小时访问过小程序)

# 返回参数

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
trace_id string 唯一请求标识,标记单次请求,用于匹配异步推送结果

# 其他说明

# 异步检测结果推送

异步检测结果在 30 分钟内会推送到你的消息接收服务器。点击查看消息接收服务器配置
返回的 JSON 数据包

属性 类型 说明
ToUserName string 小程序的username
FromUserName string 平台推送服务UserName
CreateTime number 发送时间
MsgType string 默认为:event
Event string 默认为:wxa_media_check
appid string 小程序的appid
trace_id string 任务id
version number 可用于区分接口版本
result object 综合结果
detail array 详细检测结果

result为综合结果,包含的属性有

属性 类型 说明
suggest string 建议,有risky、pass、review三种值
label number 命中标签枚举值,100 正常;20001 时政;20002 色情;20006 违法犯罪;21000 其他

detail为详细检测结果,包含的属性有

属性 类型 说明
strategy string 策略类型
errcode number 错误码,仅当该值为0时,该项结果有效
suggest string 建议,有risky、pass、review三种值
label number 命中标签枚举值,100 正常;20001 时政;20002 色情;20006 违法犯罪;21000 其他
prob number 0-100,代表置信度,越高代表越有可能属于当前返回的标签(label)

# 异步检测结果推送示例

{
   "ToUserName": "gh_9df7d78a1234",
   "FromUserName": "o4_t144jTUSEoxydysUA2E234_tc",
   "CreateTime": 1626959646,
   "MsgType": "event",
   "Event": "wxa_media_check",
   "appid": "wx8f16a5be77871234",
   "trace_id": "60f96f1d-3845297a-1976a3ae",
   "version": 2,
   "detail": [{
        "strategy": "content_model",
        "errcode": 0,
        "suggest": "pass",
        "label": 100,
        "prob": 90
   }],
   "errcode": 0,
   "errmsg": "ok",
   "result": {
        "suggest": "pass",
        "label": 100
   }
}

# 调用示例

示例说明: HTTPS调用

# 请求数据示例


{"openid": "OPENID", 
"scene": 1, 
"version":2, "media_url":"https://developers.weixin.qq.com/miniprogram/assets/images/head_global_z_@all.png","media_type":2 
} 

# 返回数据示例


{
   "errcode"  : 0,
   "errmsg"   : "ok",
   "trace_id" : "60f96f1d-3845297a-1976a3ae"
} 

# 错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试
40001 invalid credential  access_token isinvalid or not latest access_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性
40003 invalid openid 不合法的 OpenID ,请开发者确认 OpenID 的有效性
40004 invalid media type media type错误(目前支持多媒体类型 1 音频;2 图片)
43104 The openid does not match the appid appid与 openid 不匹配
44991 reach max api minute frequence 超出接口每分钟调用限制
45009 reach max api daily quota limit 超出接口每日调用限制
61010 code is expired 用户访问记录超时(用户未在近两小时访问小程序)