图像内容审核（V2）
功能介绍
分析并识别用户上传的图像内容是否有敏感内容（如涉及暴恐元素、涉黄内容等），并将识别结果返回给用户。
URI
POST /v2/{project_id}/moderation/image
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
url |
否 |
String |
与image二选一。 图片的URL路径，目前支持：
说明：
接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。 |
image |
否 |
String |
与url二选一。 图片文件Base64编码字符串。要求base64编码后大小不超过10M。 支持JPEG/PNG/BMP/WEBP/GIF格式。 |
moderation_rule |
否 |
String |
图像审核规则名称，默认使用default规则。
说明：
审核规则的创建和使用请参见配置审核规则。 |
categories |
否 |
Array of strings |
检测场景。可添加的检测场景如下：
可通过配置上述场景，来完对应场景元素的检测。
说明：
每个检测场景的检测次数会分类统计。 |
threshold |
否 |
Float |
结果过滤门限，只有置信度不低于此门限的结果才会呈现在detail的列表中，取值范围 0-1，当未设置此值时各个检测场景会使用各自的默认值。 无特殊需求直接不传此参数或像示例中一样值设为空字符串即可。
说明：
|
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
ImageDetectionResultBody object |
调用成功时表示调用结果。 调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
detail |
ImageDetectionResultDetail object |
针对选定的每个检测场景列出结果列表，porn为涉黄检测结果。如果检测场景中的最高置信度也未达到threshold则结果列表为空。 |
suggestion |
String |
审核结果是否通过。
说明：
|
category_suggestions |
Map<String,String> |
每个场景的检测结果。
说明：
目前本服务不会保存客户的调用结果。 |
参数 |
参数类型 |
描述 |
|---|---|---|
porn |
Array of ImageDetectionResultSimpleDetail objects |
涉黄检测结果。 |
参数 |
参数类型 |
描述 |
|---|---|---|
confidence |
Float |
置信度，取值范围 0-1。 |
label |
String |
每个检测结果的标签化说明。 porn：label为对应的涉黄分类（涉黄、性感等）信息。
|
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
fail_category |
String |
当包含多个场景时，调用失败的场景。 |
请求示例
- 方式一：使用图片的BASE64编码，识别用户上传的图像内容是否有敏感内容，检测场景为涉黄，图像审核规则为默认规则。
POST https://{endpoint}/v2/{project_id}/moderation/image { "categories" : [ "porn" ], "moderation_rule" : "default", "url" : "", "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAA...", "threshold" : "" } - 方式二：使用图片的url，识别用户上传的图像内容是否有敏感内容，检测场景为涉黄，图像审核规则为默认规则。
POST https://{endpoint}/v2/{project_id}/moderation/image { "categories" : [ "porn"], "moderation_rule" : "default", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "image" : "", "threshold" : "" }
响应示例
状态码： 200
成功响应示例
{
"result" : {
"detail" : {
"porn" : [ {
"confidence" : 0.7315528178215026,
"label" : "xxx"
}, {
"confidence" : 0.26844718217849733,
"label" : "yyy"
} ]
},
"suggestion" : "block",
"category_suggestions" : {
"porn" : "review"
}
}
}
状态码： 400
失败响应示例
{
"error_code" : "AIS.0402",
"error_msg" : "The image format is not supported."
}
状态码
状态码 |
描述 |
|---|---|
200 |
成功响应示例。 |
400 |
失败响应示例。 |
错误码
请参见错误码。
