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
}
调用过程中如遇到问题,可在官方社区发帖交流。