# 内容安全

# security.imgSecCheck

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

校验一张图片是否含有违法违规内容。

应用场景举例：

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

# HTTPS 调用

# 请求地址

POST https://api.q.qq.com/api/json/security/ImgSecCheck?access_token=ACCESS_TOKEN

# content-type

multipart/form-data

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
appid	string	是	小程序 appId
media	FormData	是	要检测的图片文件，格式支持PNG、JPEG、JPG、GIF，图片尺寸不超过 750px x 1334px

# 返回值

# Object

返回的 JSON 数据包

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

# errCode 的合法值

值	说明	最低版本
0	内容正常
87014	内容含有违法违规内容

# errMsg 的合法值

值	说明	最低版本
"ok"	内容正常
"risky content"	内容含有违法违规内容

# 调用示例

curl -F media=@test.jpg 'https://api.q.qq.com/api/json/security/ImgSecCheck?access_token=ACCESS_TOKEN'

# security.msgSecCheck

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

检查一段文本是否含有违法违规内容。

应用场景举例：

用户个人资料违规文字检测；
媒体新闻类用户发表文章，评论内容检测；
游戏类用户编辑上传的素材(如答题类小游戏用户上传的问题及答案)检测等。频率限制：单个 appId 调用上限为 4000 次/分钟，2,000,000 次/天*

# 调用方式：

# HTTPS 调用

# 请求地址

POST https://api.q.qq.com/api/json/security/MsgSecCheck?access_token=ACCESS_TOKEN

# content-type

application/json

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
appid	string	是	小程序 appId
content	string	是	要检测的文本内容，长度不超过 500KB

# 返回值

# Object

返回的 JSON 数据包

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

# errCode 的合法值

值	说明	最低版本
0	内容正常
87014	内容含有违法违规内容

# errMsg 的合法值

值	说明	最低版本
"ok"	内容正常
"risky	content"内容含有违法违规内容

# 调用示例

 curl -d '{ "content":"hello world!" }' -H 'Content-type: application/json' 'https://api.q.qq.com/api/json/security/MsgSecCheck?access_token=ACCESS_TOKEN'

# 测试用例

特3456书yuuo莞6543李zxcz蒜7782法fgnv级
完2347全dfji试3726测asad感3847知qwez到

1
2

开发者可使用以上两段文本进行测试，若接口errcode返回87014(内容含有违法违规内容)，则对接成功。

# security.mediaCheckAsync

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

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

应用场景举例：

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

# HTTPS 调用

# 请求地址

 POST https://api.q.qq.com/api/json/security/MediaCheckAsync?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
appid	string	是	小程序 appId
media_url	string	是	要检测的多媒体url
media_type	string	是	1:音频;2:图片

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
trace_id	string	任务id，用于匹配异步推送结果
errCode	number	错误码
errMsg	string	错误信息

# errCode 的合法值

值	说明	最低版本
0	检测请求已接收

# Object

异步检测结果在 30 分钟内会推送到你的消息接收服务器。接收服务器需要在开发者管理端配置。返回的 JSON 数据包

属性	类型	说明
CreateTime	number	发送时间
MsgType	string	默认为：Event
Event	string	默认为：qq_media_check
isrisky	number	检测结果，0：暂未检测到风险，1：风险
extra_info_json	string	附加信息，默认为空
appid	string	小程序的appid
trace_id	string	任务id
status_code	number	默认为：0，其它为链接无法下载

# 调用示例

curl -d '{ "media_url":"https://q.qq.com/img/img-phone-2x.840592e1.png","media_type":2 }' 'https://api.q.qq.com/api/json/security/MediaCheckAsync?access_token=ACCESS_TOKEN'

# 注意

media_type 需要准确填写 url 对应的多媒体类型，media_url 需要保证可以被检测服务器下载

# 接口返回示例

{
   "errCode"  : 0,
   "errMsg"   : "ok",
   "trace_id" : "92dd97c2e90a7a25162be0764680f2ba"
}

1
2
3
4
5

# 异步检测结果推送示例

{
    "CreateTime":1575532246,
    "MsgType":"event",
    "Event":"qq_media_check",
    "isrisky":0,
    "extra_info_json":"",
    "appid":"1108291530",
    "trace_id":"92dd97c2e90a7a25162be0764680f2ba",
    "status_code":0
}

1
2
3
4
5
6
7
8
9
10