内容安全

security.imgSecCheck

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

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

应用场景举例:

  1. 图片智能鉴黄:涉及拍照的工具类应用(如美拍,识图类应用)用户拍照上传检测;电商类商品上架图片检测;媒体类用户文章里的图片检测等;

  2. 敏感人脸识别:用户头像;媒体类用户文章里的图片检测;社交类用户上传的图片检测等。 频率限制:单个 appId 调用上限为 2000 次/分钟,200,000 次/天*(图片大小限制:1M)

HTTPS 调用

请求地址

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

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'
1

security.msgSecCheck

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

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

应用场景举例:

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

调用方式:

HTTPS 调用

请求地址

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

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'
1

测试用例

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

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

security.mediaCheckAsync

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

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

应用场景举例:

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

HTTPS 调用

请求地址

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

请求参数

属性 类型 默认值 必填 说明
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'
1

注意

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