AI Guardrails:Text Moderation 2.0 Multilingual PLUS Service

Step 1: Activate the service

Go to Activate Service and activate Text Moderation 2.0.

After activation, billing starts automatically when you make API calls.

Step 2: Grant permissions to a RAM user

Before integrating the SDK or API, grant API access to a Resource Access Management (RAM) user. You can create an AccessKey pair for an Alibaba Cloud account or a RAM user. You must use an AccessKey pair to complete identity verification when you call an Alibaba Cloud API.

1. Log on to the RAM console as a RAM administrator.

2. Create a RAM user. For details, see Create a RAM user.

3. Grant the AliyunYundunGreenWebFullAccess system policy to the RAM user. For details, see Grant permissions to a RAM user.

4. Create an AccessKey pair for the RAM user. For details, see Obtain an AccessKey pair.

Step 3: Install the SDK and configure your endpoint

Choose the endpoint for your region. For the full SDK integration guide, see Integration guide.

The UK (London) region uses the Singapore console configuration. The US (Silicon Valley) and Germany (Frankfurt) regions use the US (Virginia) console configuration.

Usage notes

For details on constructing HTTP requests, see Request structure. For SDK examples, see Integration guide.

Request parameters

ServiceParameters fields

Response parameters

Data fields

Result fields

CustomizedHit fields

Examples

Request

{
    "Service": "text_multilingual_pro_global",
    "ServiceParameters": {
        "content": "testing content",
        "dataId": "text0424****"
    }
}

Response: system policy hit

{
    "Code": 200,
    "Data": {
        "Result": [
            {
                "Label": "political_entity",
                "Description": "Suspected political entity",
                "Confidence": 100.0,
                "RiskWords": "Word A,Word B,Word C"
            },
            {
                "Label": "political_figure",
                "Description": "Suspected political figure",
                "Confidence": 100.0,
                "RiskWords": "Word A,Word B,Word C"
            }
        ],
        "RiskLevel": "high",
        "DetectedLanguage": "en",
        "TranslatedContent": "Translated text content",
        "DataId": "text0424****"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Response: custom keyword library hit

{
    "Code": 200,
    "Data": {
        "Result": [
            {
                "Description": "Hit a custom library",
                "CustomizedHit": [
                    {
                        "LibName": "Custom library name 1",
                        "KeyWords": "Custom keyword"
                    }
                ],
                "Confidence": 100,
                "Label": "customized"
            }
        ],
        "RiskLevel": "high",
        "DataId": "text0424****"
    },
    "Message": "OK",
    "RequestId": "AAAAAA-BBBB-CCCCC-DDDD-EEEEEEEE****"
}

Status codes