# security.mediaCheckAsync

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

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

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

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

应用场景举例：

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

调用方式：

HTTPS 调用
云调用

# 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	详细检测结果