1、接口描述

分析并识别上传的图像内容是否有敏感内容（如涉及暴恐元素、涉黄内容等），并将识别结果返回。

2、请求方法

POST

3、接口要求

只支持中文图像内容审核。

4、请求URL

广州资源池：https://moderation.cn-gdgz1.ctyun.cn/v3/{project_id}/moderation/image

苏州资源池：https://content-security-analysis.cn-jssz1.ctyun.cn/v3/{project_id}/moderation/image

5、请求参数

请求头header参数

请求体body参数

表image_text_config

6、请求代码示例

使用图片的URL编码，分析并识别用户上传的图像内容是否有敏感内容，事件类型为头像，检测场景为涉黄，暴恐。

curl --location --globoff 'https://moderation.cn-gdgz1.ctyun.cn/v3/{project_id}/moderation/image' \
--header 'X-Auth-Token: XXXXXX' \
--header 'Content-Type: application/json;charset=utf8' \
--data'{
"event_type" : "head_image",
"url" : "http://club2.autoimg.cn/album/g26/M05/9D/FF/userphotos/2022/08/08/07/500_ChsEdmLwSaKAO3IGAAUykD3c3jA252.jpg",
"categories" : [ "porn", "terrorism" ],
"image_text_config" : {
"black_glossary_names" : [ "test" ]
}
}'

7、返回值说明

请求成功返回响应参数

表result

表details

表face_location

表qr_location

表segments

请求失败返回响应参数

8、返回值示例

请求成功返回值示例

{
"request_id" : "53f9719c3730d1169e47403d5c8a9473",
"result" : {
"category" : "porn",
"details" : [ {
"category" : "porn",
"confidence" : 0.9934315,
"label" : "sexy_female",
"suggestion" : "review"
}, {
"category" : "porn",
"confidence" : 0.99798274,
"label" : "intimacy",
"suggestion" : "review"
} ],
"suggestion" : "review"
}
}

请求失败返回值示例

{
"error_code" : "AIS.0402",
"error_msg" : "The image format is not supported."
}

获取token示例：

获取用户的AK和SK，作用范围为项目"cn-jssz1"，通过用户名、账号名、密码方式获取Token，用户名、账号名查询路径：进入内容审核（经典版）管理控制台，在控制中心页面，鼠标移动至到右上角的用户名上，在下拉列表中单击“我的凭证”即可查询到。

广州4项目名称：cn-gdgz1

苏州项目名称：cn-jssz1

POST https://iam.cn-jssz1.ctyun.cn/v3/auth/tokens  （所有局点均使用此URL地址）

{
    "auth": {
        "identity": {
            "password": {
                "user": {
                    "name": "IAMUser",          //IAM用户名
                    "password": "IAMPassword",  //IAM用户密码
                    "domain": {
                        "name": "IAMDomain"     //IAM用户所属账号名
                    }
                }
            },
            "methods": [
                "password"
            ]
        },
        "scope": {
            "project": {
                "name": "cn-jssz1"   //根据局点选取相应项目名称
            }
        }
    }
}

状态码为201时：请求成功。

响应Header参数（获取到的Token）：
X-Subject-Token:MIIatAYJKoZIhvcNAQcCoIIapTCCGqECAQExDTALB...

9、状态码

10、错误码说明

11、配置自定义词库V3

在使用文本审核/图像审核时，支持用户配置自定义白名单词库和自定义黑名单词库，来帮助客户过滤和检测指定文本内容。

说明：配置自定义词库后，需要用户自行维护。

背景信息

• 配置自定义词库需要先开通文本内容审核服务。
• 配置后可以使用自定义词库。
• 一个账户最多支持创建10个自定义词库。

创建自定义词库

说明：白名单词库的处理建议选择“通过”，黑名单词库的处理建议选择“违规”或“疑似”。

1. 登录内容审核（经典版）服务管理控制台。

2. 在左侧菜单栏中选择“设置>自定义词库“，在“自定义词库 V3”页面单击“创建词库“按钮，会弹出“创建词库“窗口。

3. 在窗口中填写参数后单击“确定“，完成词库的创建。

   • 名称：长度小于50个字符，只能包含字母、数字、中划线和下划线。
   • 处理建议：有“通过、违规、疑似”三种选则，选择“通过”则为白名单词库，选择“违规、疑似”则为黑名单词库。
   • 使用场景：选择需要的使用场景，目前包括（涉政、暴恐、色情、违禁、辱骂、广告、自定义、正常）。
   • 匹配方式：原文匹配。
   • 描述：对此词库的描述。

   说明：词库名称不支持修改。

4. 创建好后，在列表页面单击操作列的“管理”，即可增加关键词。

修改或删除自定义词库

1. 登录内容审核（经典版）服务管理控制台。
2. 在左侧菜单栏中选择“设置>自定义词库“，在“自定义词库 V3”页面。
   • 单击目标词库操作列的“管理“，修改目标关键词内容，单击“确定“完成修改。
   • 单击目标词库操作列的“删除“，删除目标关键词内容，单击“确定“完成删除。

说明：删除操作不可恢复，请谨慎操作。