# 图片内容安全识别

本接口应在服务器端调用，详细说明参见服务端 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

# 请求参数 - Query

属性	类型	必填	说明
access_token / cloudbase_access_token	string		是

# 请求参数 - Body

属性	类型	必填	说明
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
    }
  ]
}

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