# 图片内容安全识别 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：gamesecurity.mediaCheck 图片审核接口能够识别游戏领域常见的违规内容，例如：色情，低俗软色情、血腥、恐怖、恶心不适、营销引流广告，辱骂以及违法违规，帮助构建健康的游戏环境。 - 违法违规图片识别 - 色情图片识别 - 低俗软色情图片识别 - 血腥、恐怖、恶心不适图片识别 - 营销引流广告图片识别 - 辱骂图片识别 应用场景： - 用户头像检测 - 公屏聊天图片检测 - 游戏素材类检测 - 资料类图片检测 - 社区类图片检测 - 其他图片检测场景 ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/wxa/game/content_spam/media_check_sync?access_token=ACCESS_TOKEN ``` ### 云调用 - 调用方法：wxa.game.contentSpam.mediaCheckSync - 出入参和 HTTPS 调用相同，调用方式可查看 [云调用](/doc/oplatform/developers/dev/cloudCall.md) 说明文档。 ### 第三方调用 - 本接口不支持第三方平台调用。 ## 2. 请求参数 ### 查询参数 `Query String Parameters` ```json [ { "参数名": "access_token", "类型": "string", "必填": "是", "示例": "ACCESS_TOKEN", "说明": "接口调用凭证，可使用 [access_token](/minigame/dev/api-backend/access-token/api_getaccesstoken)" } ] ``` ### 请求体 `Request Payload` ```json [ { "参数名": "openid", "类型": "string", "必填": "是", "说明": "用户的 openid" }, { "参数名": "version", "类型": "number", "必填": "是", "说明": "接口版本号，固定值 2" }, { "参数名": "scene", "类型": "number", "必填": "是", "说明": "场景枚举值:1 资料;2 评论;3 论坛;4 社交日志;5 聊天;" }, { "参数名": "media_url", "类型": "string", "必填": "是", "说明": "检测的图片 url，支持图片格式jpg,jpeg,png,bmp,tif,tiff,webp,gif。" }, { "参数名": "media_type", "类型": "number", "必填": "是", "说明": "媒体类型: 固定填 2 图片" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "说明": "错误信息" }, { "参数名": "trace_id", "类型": "string", "说明": "唯一请求标识，标记单次请求" }, { "参数名": "result", "类型": "object", "说明": "综合结果" }, { "参数名": "detail", "类型": "objarray", "说明": "详细检测结果" } ] ``` ### Res.result `Object Payload` 综合结果 ```json [ { "参数名": "suggest", "类型": "string", "说明": "有risky(拦截)、pass(通过)三种值", "枚举": "-" }, { "参数名": "label", "类型": "number", "说明": "命中标签", "枚举": "枚举值" } ] ``` "> ### Res.detail(Array) `Object Payload` 详细检测结果 ```json [ { "参数名": "strategy", "类型": "string", "说明": "策略类型", "枚举": "-" }, { "参数名": "errcode", "类型": "number", "说明": "错误码，仅当该值为0时，该项结果有效", "枚举": "-" }, { "参数名": "suggest", "类型": "string", "说明": "有risky(拦截)、pass(通过)三种值", "枚举": "-" }, { "参数名": "label", "类型": "number", "说明": "命中标签", "枚举": "枚举值" }, { "参数名": "prob", "类型": "number", "说明": "0-100，代表置信度，越高代表越有可能属于当前返回的标签（label）", "枚举": "-" } ] ``` ## 4. 枚举信息 ### Res.result.label `Enum` 命中标签 ```json [ { "枚举值": "100", "描述": "正常" }, { "枚举值": "10001", "描述": "营销广告" }, { "枚举值": "20001", "描述": "时政" }, { "枚举值": "20002", "描述": "色情" }, { "枚举值": "20003", "描述": "辱骂" }, { "枚举值": "20006", "描述": "违法犯罪" }, { "枚举值": "20012", "描述": "低俗" }, { "枚举值": "21000", "描述": "其他" } ] ``` __label"> ### Res.detail(Array).label `Enum` 命中标签 ```json [ { "枚举值": "100", "描述": "正常" }, { "枚举值": "10001", "描述": "营销广告" }, { "枚举值": "20001", "描述": "时政" }, { "枚举值": "20002", "描述": "色情" }, { "枚举值": "20003", "描述": "辱骂" }, { "枚举值": "20006", "描述": "违法犯罪" }, { "枚举值": "20012", "描述": "低俗" }, { "枚举值": "21000", "描述": "其他" } ] ``` ## 5. 注意事项 - 版本说明: 原 1.0 和 2.0 内容安全接口[【点击查看】](api_mediacheckasync)适配通用场景，小游戏建议使用游戏专用场景内容安全接口(本接口适配游戏场景标准，新增低俗软色情、血腥、恐怖、恶心不适、营销引流等图片识别能力)； - 频率限制: 单个 AppID 调用上限为 2 千/分钟，20 万/天，单个文件不超过 10M，特殊情况可申请上调； - 请求耗时: 接口同步返回，一般耗时在 3s 内，建议设置超时 5s； - 图片下载: 传入的图片链接需要保证可以被检测服务器下载； - 资料头像: 资料场景的头像图片建议定期请求一次，当接口能力更新后可以召回历史头像； - 数据范围: 所有在微信端展示的数据，都建议请求本接口，包括小游戏用户产生的内容，以及其他渠道产生但会在微信端曝光的内容； 调用过程中如遇到问题，点击[咨询小助手](https://work.weixin.qq.com/kfid/kfcca4feec277f91616)。 ## 6. 代码示例 ### 6.1 HTTP 示例 请求示例 ```json { "openid": "OPENID", "scene": 1, "version": 2, "media_type": 2, "media_url": "https://res.wx.qq.com/wxdoc/dist/assets/img/3-3.9b4ebdf8.png" } ``` 返回示例 ```json { "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 } ] } ``` ### 6.2 云调用示例 请求示例 ```javascript 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; } }; ``` 返回示例 ```json { "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 } ] } ``` ## 7. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "0", "错误描述": "成功" }, { "错误码": "40001", "错误描述": "access_token 无效或不为最新获取的 access_token，请开发者确认 access_token 的有效性" }, { "错误码": "40003", "错误描述": "不合法的 OpenID ，请开发者确认 OpenID 的有效性" }, { "错误码": "40129", "错误描述": "场景值错误（目前支持场景:1 资料;2 评论;3 论坛;4 社交日志;5 聊天;）" }, { "错误码": "43002", "错误描述": "方法调用错误，请用 post 方法调用" }, { "错误码": "43104", "错误描述": "appid 与 openid 不匹配" }, { "错误码": "44002", "错误描述": "POST 的数据包为空。post 请求 body 参数不能为空" }, { "错误码": "47001", "错误描述": "解析 JSON/XML 内容错误;post 数据中参数缺失;检查修正后重试。" }, { "错误码": "750030", "错误描述": "版本号错误" }, { "错误码": "750031", "错误描述": "该游戏不支持，联系小游戏侧配置" }, { "错误码": "750032", "错误描述": "每分钟调用超过上限，有需求可联系小游戏侧修改" }, { "错误码": "750033", "错误描述": "每日调用超过上限，有需求可联系小游戏侧修改" }, { "错误码": "750034", "错误描述": "media_type值不合法" } ] ``` ## 8. 适用范围 本接口支持「小游戏」账号类型调用。其他账号类型如无特殊说明，均不可调用。