# security.imgSecCheck

Call this API at the server side. For more information, see Server API.

This API supports Cloud Calls. The WeChat DevTools version must be 1.02.1904090 or later (download the latest stable version here), and the wx-server-sdk version must be 0.4.0 or later.

Checks whether a picture contains illegal or infringing content.

Use Cases:

  1. Intelligent detection of porn pictures: Detects photos taken by camera-related apps (for example, Mei Pai and photo recognition applications) and uploaded by users, pictures of e-commerce commodities, and pictures in media articles.
  2. Recognition of sensitive faces: Detects profile photos, pictures in media articles, and photos uploaded by social network users. Frequency limit: Each AppID can be called for a maximum of 2000 times per minute and 200,000 times per day.* (Maximum picture size: 1 MB

Calling methods:

# HTTPS Call

# Request Address

POST https://api.weixin.qq.com/wxa/img_sec_check?access_token=ACCESS_TOKEN

# Request Parameters

Attribute Type Default Required Description
access_token string Yes Credentials to call API
media FormData Yes The image files to be detected. PNG, JPEG, JPG, and GIF files not larger than 750x1334 pixels are supported.

# Return Value

# Object

JSON data package that is returned

Property Type Description
errcode number Error code
errMsg string Error message

Valid values of errcode

Value Description Minimum Version
0 Proper content
87014 The picture contains illegal or infringing content.

Valid values of errMsg

Value Description Minimum Version
"ok" Proper content
"risky content" The picture contains illegal or infringing content.

# Calling Example

curl -F media=@test.jpg 'https://api.weixin.qq.com/wxa/img_sec_check?access_token=ACCESS_TOKEN'

# Cloud Call

Cloud call is a capability provided by Mini Program·Cloud Base that allows you to call WeChat APIs in a cloud function. It must be used via wx-server-sdk in the cloud function.

# API Calling Method

openapi.security.imgSecCheck

You need to configure the permissions for the security.imgSecCheck API via config.json. Details

# Request Parameters

Attribute Type Default Required Description
media FormData Yes The data of the media file

media is composed as follows

Property Type Default Required Description
contentType string Yes The data type. It is MIME type.
value Buffer Yes The file buffer

# Return Value

# Object

JSON data package that is returned

Attribute Type Description
errCode number Error code
errMsg string Error message

Valid values of errCode

Value Description Minimum Version
0 Succeeded

# Exceptions

# Object

Thrown Exceptions

Property Type Description
errCode number Error code
errMsg string Error message

Valid values of errCode

Value Description Minimum Version
87014 The picture contains illegal or infringing content.

Valid values of errMsg

Value Description Minimum Version
"ok" Proper content
"risky content" The picture contains illegal or infringing content.

# SDK Calling Example

// cloud = require('wx-server-sdk')
// ...
// The method returns Promise
cloud.openapi.security.imgSecCheck({
  media: {
    contentType: 'image/png',
    value: Buffer
  }
})