4.2 图像审核
4.2.2 图像内容审核（批量）
状态码
状态码 描述
200 成功响应示例。
400 失败响应示例。
错误码
请参见错误码。
4.2.2 图像内容审核（批量）
功能介绍
分析并识别用户上传的图像内容是否有敏感内容（如涉及政治人物、暴恐元素、涉黄 内容等），并将识别结果返回给用户。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/moderation/image/batch
表4-19 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 用户的project_id
登陆华为云 -> 用户中心 -> 我 的凭证 -> api凭证 即可查看对 应区域的项目ID。
请求参数
表4-20 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
表4-21 请求 Body 参数
参数 是否必选 参数类型 描述
urls 是 Array of
strings 图片的URL路径，目前支持：
● 公网HTTP/HTTPS URL
● 华为云OBS提供的URL，使 用OBS数据需要进行授权。
包括对服务授权、临时授 权、匿名公开授权。详请参 见配置OBS访问权限。
说明图片的URL路径列表最多支持10个 URL地址。接口响应时间依赖图片 的下载时间，如果图片下载时间过 长，会返回接口调用失败。请保证 被审核图片所在的存储服务稳定可 靠，建议您使用华为云OBS存储。
参数 是否必选 参数类型 描述 categories 否 Array of
strings 检测场景：
● politics：是否涉及政治人物 的检测。
● terrorism：是否包含涉政暴 恐元素的检测。
● porn：是否包含涉黄内容元 素的检测。
● ad：是否包含广告图文的检 测。
● all：包含politics、terrorism 和porn三种场景的检测。
可通过配置上述场景，来完对应 场景元素的检测。
为空或无此参数表示politics和 terrorism都检测，但不包含 porn场景。
说明
每个检测场景的检测次数会分类统 计。
枚举值：
● politics
● terrorism
● porn
● ad
● all
参数 是否必选 参数类型 描述
threshold 否 Double 结果过滤门限，只有置信度不低 于此门限的结果才会呈现在 detail的列表中，取值范围 0-1，当未设置此值时各个检测 场景会使用各自的默认值。
politics检测场景的默认值为 0.95。
terrorism检测场景的默认值为 0。
ad检测场景的默认值为0。
无特殊需求直接不传此参数或像 示例中一样值设为空字符串即 可。
说明
● 如果检测场景中的最高置信度 也未达到threshold，则结果列 表为空；反之threshold过小，
则会使结果列表中内容过多。
● threshold参数不支持porn场景 筛选。
● threshold参数不会对响应中的 suggestion产生影响。
最小值：0 最大值：1
响应参数
状态码： 200
表4-22 响应 Body 参数
参数 参数类型 描述
result Array of ImageBatch ModerationR esultBody objects
调用成功时表示调用结果。 调用失败时无此字 段。
表4-23 ImageBatchModerationResultBody
参数 参数类型 描述
url String 图片的URL路径。
参数 参数类型 描述
suggestion String 请参见suggestion字段说明。
detail ImageDetecti onResultDeta il object
请参见detail字段说明。
category_sug
gestions Object 具体每个场景的检测结果。
block：包含敏感信息，不通过 pass：不包含敏感信息，通过 review：需要人工复检
表4-24 ImageDetectionResultDetail
参数 参数类型 描述
politics Array of politics objects
涉政敏感人物检测结果。
porn Array of ImageDetecti onResultSim pleDetail objects
涉黄检测结果。
terrorism Array of ImageDetecti onResultSim pleDetail objects
涉政、暴恐检测结果。
ad Array of ImageDetecti onResultAdD etail objects
广告检测结果。
表4-25 politics
参数 参数类型 描述
confidence Float 置信度，取值范围 0-1。
label String 对应的政治人物信息。
face_detail face_detail 涉政场景中的人物面部信息。
表4-26 face_detail
参数 参数类型 描述
h Integer 人脸区域高度。
w Integer 人脸区域宽度。
x Integer 人脸区域左上角到y轴距离。
y Integer 人脸区域左上角到x轴距离。
表4-27 ImageDetectionResultSimpleDetail
参数 参数类型 描述
confidence Float 置信度，取值范围 0-1。
参数 参数类型 描述
label String 每个检测结果的标签化说明：
terrorism：label为对应的涉政暴恐元素信息。
● 涉政暴恐场景当前支持label列表如下：
– normal：正常 – knife：刀 – gun：枪 – fire：火灾 – bloody ：血腥
– terrorist：暴恐组织及标志 – fascist：法西斯组织及标志 – cult：邪教组织及标志
– negative_politics ：涉政负面组织及标志 – negative_political_events：涉政负面事件
及标志
– special_characters ：特殊文字 – kidnap：绑架
– corpse：尸体 – riot：暴乱事件 – parade ：游行示威
– sensitive_landmarks：敏感地标 – military_weapon：军事武器 – army：警察部队
– positive_politics：涉政正面组织及标志 – crowd：人群聚集
porn：label为对应的涉黄分类（涉黄、性感等）
信息。
● 鉴黄场景当前支持label列表如下：
– normal：正常 – porn：色情 – sexy：性感
ad：label为对应的广告识别结果信息。
● 广告场景当前支持label列表如下：
– normal：正常 – ad：广告
● 图文审核场景当前支持label列表如下：
– normal：正常
参数 参数类型 描述
– ad：广告 – abuse：辱骂
– contraband：违禁品 – 其他自定义黑库名称
表4-28 ImageDetectionResultAdDetail
参数 参数类型 描述
confidence Float 置信度，取值范围 0-1。
label String ad：label为对应的广告识别结果信息
● 广告场景当前支持label列表如下：
– normal：正常 – ad：广告
● 图文审核场景当前支持label列表如下：
– normal：正常 – qr_code：二维码 – politics：涉政 – porn：涉黄 – ad：广告 – abuse：辱骂
– contraband：违禁品 – 其他自定义黑库名称 hit_contexts Array of
strings 图文审核场景命中的文本列表。
状态码： 400
表4-29 响应 Body 参数
参数 参数类型 描述
error_code String 调用失败时的错误码，具体请参见错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
调用成功时无此字段。
fail_category String 当包含多个场景时，失败场景。
请求示例
图像内容检测（批量）
POST https://{endpoint}/v2/{project_id}/moderation/image/batch
{ "urls" : [ "https://bucketname.obs.myhwclouds.com/ObjectName1", "https://
bucketname.obs.myhwclouds.com/ObjectName2" ], "categories" : [ "politics", "terrorism", "porn" ], "threshold" : ""
}
响应示例
状态码： 200 成功响应示例
{ "result" : [ {
"url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName1", "suggestion" : "block",
"detail" : {
{ "error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 描述
200 成功响应示例。
400 失败响应示例。
错误码
请参见错误码。