微信小程序 mediaCheckAsync
security.mediaCheckAsync
本接口应在服务器端调用，详细说明参见服务端API。
异步校验图片/音频是否含有违法违规内容。
应用场景举例：
- 语音风险识别：社交类用户发表的语音内容检测；
- 图片智能鉴黄：涉及拍照的工具类应用(如美拍，识图类应用)用户拍照上传检测；电商类商品上架图片检测；媒体类用户文章里的图片检测等；
- 敏感人脸识别：用户头像；媒体类用户文章里的图片检测；社交类用户上传的图片检测等。 频率限制：单个 appId 调用上限为 2000 次/分钟，200,000 次/天；文件大小限制：单个文件大小不超过10M
请求地址
POST https://api.weixin.qq.com/wxa/media_check_async?access_token=ACCESS_TOKEN
请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| media_url | string | 是 | 要检测的多媒体url | |
| media_type | number | 是 | 1:音频;2:图片 |
返回值
Object
返回的 JSON 数据包
| 属性 | 类型 | 说明 |
|---|---|---|
| trace_id | string | 任务id，用于匹配异步推送结果 |
| 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)为链接无法下载 |
调用示例
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
}
调用过程中如遇到问题，可在珊瑚安全社区发帖交流。