Porn Detection Event Notification

Recent Pages

Porn Detection Event Notification

Last updated: 2022-03-21 10:40:18

Live porn detection takes screenshots of live streams according to the screencapturing template, saves them to COS, and leverages Tencent Cloud’s Image Moderation System to identify problematic images. A porn detection callback provides you with porn detection details, including the category, priority, and screencapturing time of problematic images. To receive porn detection callbacks, you need to configure a server address in the callback template and bind the template to your push domain name. If porn detection is enabled for a stream, the CSS backend will send information about suspicious images to the server address you configured.

This document describes the parameters in callback message notifications sent by Tencent Cloud CSS after a porn detection callback event is triggered.

Notes

You need to understand how to configure callbacks and how you will receive messages via Tencent Cloud CSS before reading this document. For more information, see How to Receive Event Notification.
By default, only questionable results of porn detection will be called back.
We recommend you use the type of an image to determine whether it is pornographic. As the detection results are not 100% accurate and there may be false positives or false negatives, you can confirm them manually if necessary.

Screencapturing Event Parameters

Event type parameters

Event Type	Parameter Value
Live porn detection	event_type = 317

Common callback parameters

Parameter	Type	Description
t	int64	Expiration time, which is the Unix timestamp when the event notification signature expires. The default validity period of a message notification from Tencent Cloud is 10 minutes. If the time specified by the `t` value in a message notification has elapsed, then this notification is considered invalid, thereby preventing network replay attacks. The format of `t` is a decimal Unix timestamp, i.e., the number of seconds that have elapsed since 00:00:00 (UTC/GMT time), January 1, 1970.
sign	string	Event notification security signature sign = MD5(key + t). Note: Tencent Cloud concatenates the encryption key and `t`, calculates the `sign` value through MD5, and places it in the notification message. When your backend server receives the notification message, it can confirm whether the `sign` is correct based on the same algorithm and then determine whether the message is indeed from the Tencent Cloud backend.

Note：

You can set the callback key in Event Center > Live Stream Callback, which is used for authentication. We recommend you set this field to ensure data security.

Callback message parameters

Parameter	Required	Data Type	Description
streamId	No	String	Stream name
channelId	No	String	Channel ID
img	Yes	String	Link to the alerted image
type	Yes	Array	Categories of negative labels with the highest priority in the detection result. For details, see the description of `label`.
score	Yes	Array	Scores of `type`
ocrMsg	No	String	OCR result (if any)
suggestion	Yes	String	Suggestion. Valid values: Block Review Pass
label	Yes	String	Negative label with the highest priority in the detection result (`LabelResults`). This is the moderation result suggested by the model. We recommend you handle different types of violations and suggestions based on your business needs.
subLabel	Yes	String	Sub-label under the negative label with the highest priority in the detection result, such as porn - sexual acts. If no content is sub-labeled, this parameter will be empty.
labelResults	No	Array of LabelResult	Negative label hit details of the category model, including the detected porn content, ads, terrorism content, and politically sensitive content Note: This field may return `null`, indicating that no valid values can be obtained.
objectResults	No	Array of ObjectResult	Detection result of the object model, including label name, hit score, coordinates, scenario, and suggested operation regarding objects, advertising logos, QR codes, etc. For details, see the description of the data structure of `ObjectResults`. Note: This field may return `null`, indicating that no valid values can be obtained.
ocrResults	No	Array of OcrResult	OCR result, including text coordinates, recognized text, suggested operation, etc. For details, see the description of the data structure of `OcrResults`. Note: This field may return `null`, indicating that no valid values can be obtained.
libResults	No	Array of LibResult	Blocklist/Allowlist moderation result
screenshotTime	Yes	Number	Screenshot time
sendTime	Yes	Number	Time when the request was sent, in Unix timestamp format
stream_param	No	String	Push parameters
app	No	String	Push domain name
appid	No	Number	Application ID
appname	No	String	Push path

LabelResult

Hit result of the category model

Parameter	Type	Description
Scene	String	Scenario identified by the model, such as advertising, pornographic, and harmful
Suggestion	String	Operation suggested by the system for the current negative label. We recommend you handle different types of violations and suggestions based on your business needs. Returned values: Block Review Pass
label	String	Negative label in the detection result
SubLabel	String	Sub-label name
Score	Integer	Hit score of the label model
Details	Array of LabelDetailItem	Sub-label hit details of the category model

LabelDetailItem

Sub-label hit details of the category model

Parameter	Type	Description
Id	Integer	ID
Name	String	Sub-label name
Score	Integer	Sub-label score. Value range: 0-100

ObjectResult

Object detection result

Parameter	Type	Description
Scene	String	Object scenario identified, such as QR code, logo, and OCR
Suggestion	String	Operation suggested by the system for the current negative label. We recommend you handle different types of violations and suggestions based on your business needs. Returned values: Block Review Pass
label	String	Negative label in the detection result
SubLabel	String	Sub-label name
Score	Integer	Sub-label hit score of the scenario model. Value range: 0-100
Names	Array of String	List of object names
Details	Array of ObjectDetail	Object detection details

ObjectDetail

Object detection details. When the detection scenario is object, advertising logo, or QR code, it returns the label name, label value, label score, and location information of the detection frame.

Parameter	Type	Description
Id	Integer	ID of the object identified
Name	String	Object label identified
Value	String	Value or content of the object label identified. For example, if the label is QR code (`QrCode`), this parameter is the URL of the QR code.
Score	Integer	Hit score of the object label. Value range: 0-100. For example, `QrCode 99` indicates a high likelihood that the content is a QR code.
Location	Location	Coordinates (of the top-left corner), dimensions, and rotation of the object detection frame

Location

Coordinates and other information of the detection frame

Parameter	Type	Description
X	Float	Horizontal coordinate of the top-left corner
Y	Float	Vertical coordinate of the top-left corner
Width	Float	Width
Height	Float	Height
Rotate	Float	Rotation angle of the detection frame

OcrResult

OCR result

Parameter	Type	Description
Scene	String	Recognition scenario. Default value: OCR
Suggestion	String	Operation suggested by the system for the negative label with the highest priority. We recommend you handle different types of violations and suggestions based on your business needs. Returned values: Block Review Pass
label	String	Negative label in the detection result
SubLabel	String	Sub-label name
Score	Integer	Sub-label hit score of the scenario model. Value range: 0-100
Text	String	Text
Details	Array of OcrTextDetail	OCR details

OcrTextDetail

OCR details

Parameter	Type	Description
Text	String	Text recognized (up to 5,000 bytes)
label	String	Negative label in the detection result
Keywords	Array of String	Keywords hit under the label
Score	Integer	Hit score of the label model. Value range: 0-100
Location	Location	OCR text coordinates

LibResult

Blocklist/Allowlist result

Parameter	Type	Description
Scene	String	Scenario recognition result of the model. Default value: Similar
Suggestion	String	Operation suggested by the system. We recommend you handle different types of violations and suggestions based on your business needs. Returned values: Block Review Pass
label	String	Negative label in the detection result
SubLabel	String	Sub-label name
Score	Integer	Recognition score of the image search model. Value range: 0-100
Details	Array of LibDetail	Blocklist/Allowlist details

LibDetail

Custom list or blocklist/allowlist details

Parameter	Type	Description
Id	Integer	ID
ImageId	String	Image ID
label	String	Negative label in the detection result
Tag	String	Custom label
Score	Integer	Model recognition score. Value range: 0-100

Sample callback message

{
        "ocrMsg": "",
        "type": [1],
        "socre": 99,
        "screenshotTime": 1610640000,
        "level": 0,
        "img": "http://1.1.1.1/download/porn/test.jpg",
        "abductionRisk": [],
        "faceDetails": [],
        "sendTime": 1615859827,
        "suggestion": "Block",
        "label": "Porn",
        "subLabel": "PornHigh",
        "labelResults": [{
                "HitFlag": 0,
                "Scene": "Illegal",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }, {
                "HitFlag": 1,
                "Scene": "Porn",
                "Suggestion": "Block",
                "Label": "Porn",
                "SubLabel": "PornHigh",
                "Score": 99,
                "Details": [{
                        "Id": 0,
                        "Name": "PornHigh",
                        "Score": 99
                }, {
                        "Id": 1,
                        "Name": "WomenChest",
                        "Score": 99
                }]
        }, {
                "HitFlag": 0,
                "Scene": "Sexy",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "Terror",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Details": []
        }],
        "objectResults": [{
                "HitFlag": 0,
                "Scene": "QrCode",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "MapRecognition",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }, {
                "HitFlag": 0,
                "Scene": "PolityFace",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Names": [],
                "Details": []
        }],
        "ocrResults": [{
                "HitFlag": 0,
                "Scene": "OCR",
                "Suggestion": "Pass",
                "Label": "Normal",
                "SubLabel": "",
                "Score": 0,
                "Text": "",
                "Details": []
        }],
        "streamId": "teststream",
        "channelId": "teststream",
        "stream_param": "txSecret=40f38f69f574fd51126c421a3d96c374&txTime=5DEBEC80",
        "app": "5000.myqcloud.com",
        "appname": "live",
        "appid": 10000,
        "event_type": 317,
        "sign": "ac920c3e66**********78cf1b5de2c63",
        "t": 1615860427
}

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support

tencent cloud

Tencent Cloud Partner Network

Become a Partner

International Partner Academy

Recent Pages

Porn Detection Event Notification

Notes

Screencapturing Event Parameters

Event type parameters

Common callback parameters

Callback message parameters

LabelResult

LabelDetailItem

ObjectResult

ObjectDetail

Location

OcrResult

OcrTextDetail

LibResult

LibDetail

Sample callback message

Was this page helpful?

Was this page helpful?

About Tencent Cloud

Help & Support

User Center

Resources

tencent cloud

Become a Partner

Tencent Cloud Partner Network

Become a Partner

Training & Support

International Partner Academy

Sign Up

Log in

Recent Pages

Porn Detection Event Notification

Notes

Screencapturing Event Parameters

Event type parameters

Common callback parameters

Callback message parameters

LabelResult

LabelDetailItem

ObjectResult

ObjectDetail

Location

OcrResult

OcrTextDetail

LibResult

LibDetail

Sample callback message

Was this page helpful?

Was this page helpful?

About Tencent Cloud

Help & Support

User Center

Resources