security.mediaCheckAsync

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

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

应用场景举例:

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

请求地址

  1. 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)为链接无法下载

调用示例

  1. 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 需要保证可以被检测服务器下载

接口返回示例

  1. {
  2. "errcode" : 0,
  3. "errmsg" : "ok",
  4. "trace_id" : "967e945cd8a3e458f3c74dcb886068e9"
  5. }

异步检测结果推送示例

  1. {
  2. "ToUserName" : "gh_38cc49f9733b",
  3. "FromUserName" : "oH1fu0FdHqpToe2T6gBj0WyB8iS1",
  4. "CreateTime" : 1552465698,
  5. "MsgType" : "event",
  6. "Event" : "wxa_media_check",
  7. "isrisky" : 0,
  8. "extra_info_json" : "",
  9. "appid" : "wxd8c59133dfcbfc71",
  10. "trace_id" : "967e945cd8a3e458f3c74dcb886068e9",
  11. "status_code" : 0
  12. }