4.2 图像审核
4.2.3 图像内容审核(异步批量)
4.2.3.2 处理结果查询
功能介绍
查询批量图片内容审核任务的结果,任务成功执行时会返回每张图片的详细审核结 果,单张图片的失败,不会导致任务失败。
说明
任务最长保留时间为30分钟,过期后会被清理掉。建议在任务提交后,每30s进行一次周期查 询。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/{project_id}/moderation/image/batch
表4-36 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 用户的project_id
登陆华为云 -> 用户中心 -> 我 的凭证 -> api凭证 即可查看对 应区域的项目ID。
表4-37 Query 参数
参数 是否必选 参数类型 描述
job_id 是 String 任务标识。
请求参数
表4-38 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取(响应消息头中 X-Subject-Token的值)。
响应参数
状态码: 200
表4-39 响应 Body 参数
参数 参数类型 描述
result CheckResult ResultBody object
调用成功时表示调用结果。
调用失败时无此字段。
表4-40 CheckResultResultBody
参数 参数类型 描述
job_id String 任务标识。
status String 任务状态。
created:已创建 running:正在处理 finish:已完成 failed:处理失败
create_time String 任务创建的时间。例如:2018-01-02T15:03:04Z update_time String 任务最近更新的时间。例如:
2018-01-02T15:03:04Z items Array of
CheckResultI temsBody objects
图片内容检测的结果列表。
表4-41 CheckResultItemsBody
参数 参数类型 描述
url String 图片的URL路径。
suggestion String 请参见suggestion字段说明。
detail ImageDetecti onResultDeta il object
请参见detail字段说明。
category_sug Map<String,St 具体每个场景的检测结果。
表4-42 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-43 politics
参数 参数类型 描述
confidence Float 置信度,取值范围 0-1。
label String 对应的政治人物信息。
face_detail face_detail
object 涉政场景中的人物面部信息。
表4-44 face_detail
参数 参数类型 描述
h Integer 人脸区域高度。
w Integer 人脸区域宽度。
x Integer 人脸区域左上角到y轴距离。
y Integer 人脸区域左上角到x轴距离。
表4-45 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:正常 – qr_code:二维码 – politics:涉政 – porn:涉黄
参数 参数类型 描述
– ad:广告 – abuse:辱骂
– contraband:违禁品 – 其他自定义黑库名称
表4-46 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-47 响应 Body 参数
参数 参数类型 描述
error_code String 调用失败时的错误码,具体请参见错误码。
调用成功时无此字段。
error_msg String 调用失败时的错误信息。
请求示例
GET https://{endpoint}/v2/{project_id}/moderation/image/batch?job_id={job_id}
响应示例
状态码: 200 成功响应示例
{ "result" : {
"job_id" : "44d93b70-db01-4f96-a618-2a79c964c4b2", "status" : "finish",
"create_time" : "2018-01-02T15:03:04Z", "update_time" : "2018-01-02T15:03:04Z", "items" : [ {
"url" : "https://obs-test-llg.obs.myhuaweicloud.com/terrorism", "suggestion" : "pass",
"url" : "https://obs-test-llg.obs.myhuaweicloud.com/clarity-detect", "suggestion" : "pass",
{ "error_code" : "AIS.0005",
"error_msg" : "The service does not exist."
}
状态码
状态码 描述
状态码 描述
400 失败响应示例。
错误码
请参见错误码。