# security.mediaCheckAsync

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

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

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

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

应用场景举例:

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

调用方式:

# HTTPS 调用

# 请求地址

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
appid string 小程序的appid
trace_id string 任务id
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
   }
}

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

# 云调用

云调用是微信云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

# 接口方法

openapi.security.mediaCheckAsync

需在 config.json 中配置 security.mediaCheckAsync API 的权限,详情

# 请求参数

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

# 返回值

# Object

返回的 JSON 数据包

属性 类型 说明
traceId 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
appid string 小程序的appid
traceId string 任务id
version number 可用于区分接口版本
result object 综合结果
detail array 详细检测结果

# 异常

# Object

抛出的异常

属性 类型 说明
errCode number 错误码
errMsg string 错误信息

errCode 的合法值

说明 最低版本

# Object

异步检测结果在 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 详细检测结果