# security.mediaCheckAsync-v1

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

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

应用场景举例：

语音风险识别：社交类用户发表的语音内容检测；
图片智能鉴黄：涉及拍照的工具类应用(如美拍，识图类应用)用户拍照上传检测；电商类商品上架图片检测；媒体类用户文章里的图片检测等；
敏感人脸识别：用户头像；媒体类用户文章里的图片检测；社交类用户上传的图片检测等。 频率限制：单个 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
media_type	number	是	1:音频;2:图片

# 返回值

# 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 '{ "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
}

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