# 图片内容安全识别

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

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

# 接口说明

图片审核接口能够识别游戏领域常见的违规内容,例如:色情,低俗软色情、血腥、恐怖、恶心不适、营销引流广告,辱骂以及违法违规,帮助构建健康的游戏环境。

  • 违法违规图片识别
  • 色情图片识别
  • 低俗软色情图片识别
  • 血腥、恐怖、恶心不适图片识别
  • 营销引流广告图片识别
  • 辱骂图片识别

# 应用场景

  • 用户头像检测
  • 公屏聊天图片检测
  • 游戏素材类检测
  • 资料类图片检测
  • 社区类图片检测
  • 其它图片检测场景

# 注意事项

  • 版本说明: 原1.0和2.0内容安全接口【点击查看】适配通用场景,小游戏建议使用游戏专用场景内容安全接口(本接口适配游戏场景标准,新增低俗软色情、血腥、恐怖、恶心不适、营销引流等图片识别能力);
  • 频率限制: 单个AppID调用上限为2千/分钟,20万/天,单个文件不超过10M,特殊情况可申请上调;
  • 请求耗时: 接口同步返回,一般耗时在3s内,建议设置超时5s;
  • 图片下载: 传入的图片链接需要保证可以被检测服务器下载;
  • 资料头像: 资料场景的头像图片建议定期请求一次,当接口能力更新后可以召回历史头像;
  • 数据范围: 所有在微信端展示的数据,都建议请求本接口,包括小游戏用户产生的内容,以及其它渠道产生但会在微信端曝光的内容;

# 调用方式

# HTTPS 调用

# 请求地址

POST https://api.weixin.qq.com/wxa/game/content_spam/media_check_sync?access_token=ACCESS_TOKEN

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证
openid string 用户的openid
version number 接口版本号,固定值2
scene number 场景枚举值:1资料;2评论;3论坛;4社交日志;5聊天;
media_url string 检测的图片url,支持图片格式包括jpg, jepg, png等
media_type number 媒体类型: 固定填2图片

# 返回参数

属性 类型说明
errcode number 错误码
errmsg string 错误信息
trace_id string 唯一请求标识,标记单次请求
result object 综合结果
属性 类型 说明
suggest string 有risky(拦截)、pass(通过)、review(可疑)三种值
label number 命中标签枚举值:100正常;10001营销广告;20001时政;20002色情;20003辱骂;20006违法犯罪;20012低俗;21000其他
detail array<object> 详细检测结果
属性 类型 说明
strategy string 策略类型
errcode number 错误码,仅当该值为0时,该项结果有效
suggest string 有risky(拦截)、pass(通过)、review(可疑)三种值
label number 命中标签枚举值:100正常;10001营销广告;20001时政;20002色情;20003辱骂;20006违法犯罪;20012低俗;21000其他
prob number 0-100,代表置信度,越高代表越有可能属于当前返回的标签(label)

# https请求数据示例

{
  "openid": "OPENID",
  "scene": 1,
  "version": 2,
  "media_type": 2,
  "media_url": "https://res.wx.qq.com/wxdoc/dist/assets/img/3-3.9b4ebdf8.png"
}

# https返回结果示例

{
  "errcode": 0,
  "errmsg": "ok",
  "trace_id": "54bf091a-821t3794-237p1237",
  "result": {
    "suggest": "pass",
    "label": 100
  },
  "detail": [
    {
      "strategy": "minigame_content_model",
      "errcode": 0,
      "suggest": "pass",
      "label": 100,
      "prob": 90
    }
  ]
}

# errcode说明

错误值 说明
0 成功
40001 access_token 无效或不为最新获取的 access_token,请开发者确认access_token的有效性
40003 不合法的 OpenID ,请开发者确认 OpenID 的有效性
40129 场景值错误(目前支持场景:1资料;2评论;3论坛;4社交日志;5聊天;)
43104 appid与openid不匹配
43002 方法调用错误,请用post方法调用
44002 POST 的数据包为空。post请求body参数不能为空
47001 解析 JSON/XML 内容错误;post 数据中参数缺失;检查修正后重试。
750030 版本号错误
750031 该游戏不支持,联系小游戏侧配置
750032 每分钟调用超过上限,有需求可联系小游戏侧修改
750033 每日调用超过上限,有需求可联系小游戏侧修改
other 系统错误

# 云调用

云调用是微信云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用 出入参和HTTPS调用相同,调用方式可查看云调用说明文档

# 接口方法

openapi.wxa.game.contentSpam.mediaCheckSync

# 云调用请求数据示例

const cloud = require('wx-server-sdk')
cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.wxa.game.contentSpam.mediaCheckSync({
        "openid": "OPENID",
        "scene": 1,
        "version": 2,
        "media_type": 2,
        "media_url": "https://res.wx.qq.com/wxdoc/dist/assets/img/3-3.9b4ebdf8.png"
      })
    return result
  } catch (err) {
    return err
  }
}

# 云调用返回结果示例

{
  "errcode": 0,
  "errmsg": "ok",
  "trace_id": "54bf091a-821t3794-237p1237",
  "result": {
    "suggest": "pass",
    "label": 100
  },
  "detail": [
    {
      "strategy": "minigame_content_model",
      "errcode": 0,
      "suggest": "pass",
      "label": 100,
      "prob": 90
    }
  ]
}

调用过程中如遇到问题,点击咨询小助手