-

security.mediaCheckAsync

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

异步校验图片/音频是否含有违法违规内容。

应用场景举例:

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

请求地址

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

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
media_urlstring要检测的多媒体url
media_typenumber1:音频;2:图片

返回值

Object

返回的 JSON 数据包

属性类型说明
trace_idstring任务id,用于匹配异步推送结果
errcodenumber错误码
errmsgstring错误信息

errcode 的合法值

说明最低版本
0检测请求已接收

Object

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

属性类型说明
ToUserNamestring小程序的username
FromUserNamestring平台推送服务UserName
CreateTimenumber发送时间
MsgTypestring默认为:Event
Eventstring默认为:wxa_media_check
isriskynumber检测结果,0:暂未检测到风险,1:风险
extra_info_jsonstring附加信息,默认为空
appidstring小程序的appid
trace_idstring任务id
status_codenumber默认为:0,4294966288(-1008)为链接无法下载

调用示例

curl -d '{ "media_url":"https://developers.weixin.qq.com/miniprogram/assets/images/head_global_z_@all.png","media_type":2 }' 'https://api.weixin.qq.com/wxa/media_check_async?access_token=ACCESS_TOKEN'

注意

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

接口返回示例

{
   "errcode"  : 0,
   "errmsg"   : "ok",
   "trace_id" : "967e945cd8a3e458f3c74dcb886068e9"
}

异步检测结果推送示例

{
   "ToUserName"      : "gh_38cc49f9733b",
   "FromUserName"    : "oH1fu0FdHqpToe2T6gBj0WyB8iS1",
   "CreateTime"      : 1552465698,
   "MsgType"         : "event",
   "Event"           : "wxa_media_check",
   "isrisky"         : 0,
   "extra_info_json" : "",
   "appid"           : "wxd8c59133dfcbfc71",
   "trace_id"        : "967e945cd8a3e458f3c74dcb886068e9",
   "status_code"     : 0
}

调用过程中如遇到问题,可在珊瑚安全社区发帖交流。