Text Moderation

Updated at: Mar 17, 2020 GMT+08:00

Function

This API analyzes and identifies whether the uploaded text contains pornographic elements or politically sensitive words, and returns the result to you.

Prerequisites

Before using Text Moderation, you need to apply for the service and complete authentication. For details, see Getting Started with Moderation (Text).

URI

URI format

POST /v1.0/moderation/text

Request Message

Table 1 describes the request parameters.

**Table 1** Request parameters
Parameter	Mandatory	Type	Description
items	Yes	Array	Indicates the items to be checked. Currently, only one item can be checked each time.
text	Yes	String	Indicates the text to be checked. The encoding format is UTF-8. A maximum of 5,000 characters is allowed. If the number of characters to be checked exceeds the upper limit, only the first 5,000 characters will be checked.
type	No	String	Indicates the text type. The default value is content. Currently, only the content type is supported.
categories	No	Array	Indicates the detection scenario. Currently, the following scenarios are supported: Default scenarios: politics: indicates sensitive political information detection. porn: indicates pornographic information detection. ad: indicates advertisement detection. abuse: indicates offensive content detection. contraband: indicates contraband information detection. flood: indicates spamming detection. User-defined scenario: custom blacklist dictionary NOTE: For details about how to create and use a custom dictionary, see Configuring a Custom Dictionary. The custom whitelist dictionary cannot be used in the flood scenario.

Response Message

Table 2 describes the response parameters.

**Table 2** Response parameters
Parameter	Type	Description
result	Object	Indicates the calling result when the API is successfully called. This parameter is not included when the API fails to be called.
detail	Object	Indicates details about the returned check result. Possible values are as follows: politics: indicates a list of politically sensitive words. porn: indicates a list of pornographic words. ad: indicates a list of sensitive advertisement words. abuse: indicates a list of offensive words. contraband: indicates a list of words related to contraband. flood: indicates spamming content. NOTE: The spamming content contains a maximum of 200 characters.
suggestion	String	Indicates whether the check is passed. block: indicates that sensitive information is detected and the information fails to pass the check. pass: indicates that no sensitive information is detected and the information passes the check. review: indicates that the text needs to be manually reviewed.
error_code	String	Indicates the error code when the API fails to be called. For details, see Error Code. This parameter is not included when the API is successfully called.
error_msg	String	Indicates the error message when the API fails to be called. This parameter is not included when the API is successfully called.

Examples

Example request

POST https://moderation.ap-southeast-1.myhuaweicloud.com/v1.0/moderation/text
    
Request Header:      
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
Request Body:
{
   "categories":["ad","politics","abuse","porn","contraband","flood"],
   "items":[
      {
          "text": "6666666666",
          "type": "content"
      }
    ]
}

Example successful response

{
    "result": {
        "detail": {
            "flood": "6666666666"
        },
        "suggestion": "block"
    }
}

Example failed response

{
    "error_code": "AIS.0005",
    "error_msg": "The service does not exist."
}

Status Code

Normal
200

Abnormal

Return Value	Description
400	The request cannot be understood by the server due to malformed syntax. The client should not repeat the request without modifications. The request parameter is incorrect.
401	The request requires user authentication.
403	No operation permission.
404	The server has not found anything matching the Request-URI.
500	The server encountered an unexpected condition which prevented it from fulfilling the request.

Parent topic: Moderation (Text)

Last Article: Moderation (Text)

Next Article: Moderation (Image)

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

huaweicloud

hotSearch