security.mediaCheckAsync

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

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

1.0 版本接口文档【点击查看】

应用场景举例:

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

请求地址

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

请求参数

属性 类型 默认值 必填 说明
access_token / cloudbase_access_token string 接口调用凭证
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
openid string 用户的openid(用户需在近两小时访问过小程序)
scene number 场景枚举值(1 资料;2 评论;3 论坛;4 社交日志)

返回值

Object

返回的 JSON 数据包

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

errcode 的合法值

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

Object

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

属性 类型 说明
ToUserName string 小程序的username
FromUserName string 平台推送服务UserName
CreateTime number 发送时间
MsgType string 默认为:Event
Event string 默认为:wxa_media_check
isrisky number 检测结果,0:暂未检测到风险,1:风险
extra_info_json string 附加信息,默认为空
appid string 小程序的appid
trace_id string 任务id
status_code number 默认为:0,4294966288(-1008)为链接无法下载
version number 可用于区分接口版本
result object 综合结果
detail array 详细检测结果

调用示例

curl -d '{"openid": "OPENID", "scene": 1, "version":2, "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_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
   }
}

调用过程中如遇到问题,可在官方社区发帖交流。