查询视频内容审核作业
功能介绍
查询视频审核作业处理状态与结果，并将识别结果返回给用户。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/{project_id}/moderation/video/jobs/{job_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
|
job_id |
是 |
String |
创建作业成功时，接口返回的job_id。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
本次请求的唯一标识，用于问题排查，建议保存。 |
|
job_id |
String |
作业id。 |
|
status |
String |
作业状态，可取值有：
|
|
request_params |
request_params object |
作业创建参数。 |
|
create_time |
String |
作业创建时间。 |
|
update_time |
String |
作业更新时间。 |
|
result |
result object |
作业审核结果，当作业状态为succeeded时存在。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
data object |
创建作业时传的data参数。 |
|
event_type |
String |
创建作业时传的event_type参数。 |
|
image_categories |
Array of strings |
创建作业时传的image_categories参数。 |
|
audio_categories |
Array of strings |
创建作业时传的audio_categories参数。 |
|
callback |
String |
创建作业时传的callback参数。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
创建作业时传的url参数。 |
|
frame_interval |
Integer |
创建作业时传的frame_interval参数，默认为5秒截取一帧。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
suggestion |
String |
视频审核结果是否通过。
|
|
image_detail |
Array of image_detail objects |
图像审核详情。 |
|
audio_detail |
Array of audio_detail objects |
音频审核详情。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
suggestion |
String |
图像审核结果是否通过。
|
|
category |
String |
检测结果的一级标签。 支持category列表如下：
|
|
ocr_text |
String |
图文审核检测出的文本，只有在category参数配置image_text且检测出文本时展示该字段。 |
|
time |
Float |
截帧在视频文件中的时间，单位为秒。 |
|
detail |
Array of detail objects |
图像帧审核详情。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
confidence |
Float |
置信度，可选值在0-1之间，值越大，可信度越高。 |
|
category |
String |
检测结果的一级标签。 支持category列表如下：
|
|
suggestion |
String |
审核结果是否通过。
|
|
label |
String |
识别的详细标签。 |
|
face_location |
face_location object |
人物位置信息。 |
|
qr_location |
qr_location object |
二维码位置信息。 |
|
qr_content |
String |
图片中二维码指向的链接，当请求参数categories中包含image_text时存在。 |
|
segments |
Array of segments objects |
image_text场景下命中的文本片段。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
top_left_x |
Integer |
检测出人脸的左上角横坐标。 |
|
top_left_y |
Integer |
检测出人脸的左上角纵坐标。 |
|
bottom_right_x |
Integer |
检测出人脸的右下角横坐标。 |
|
bottom_right_y |
Integer |
检测出人脸的右下角纵坐标。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
top_left_x |
Integer |
检测出的二维码左上角横坐标。 |
|
top_left_y |
Integer |
检测出的二维码左上角纵坐标。 |
|
bottom_right_x |
Integer |
检测出的二维码右下角横坐标。 |
|
bottom_right_y |
Integer |
检测出的二维码右下角纵坐标。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
suggestion |
String |
音频片段审核结果是否通过。
|
|
label |
String |
音频片段检测标签，选取detail中置信度最大的标签，可取值如下：
|
|
audio_text |
String |
音频片段文本内容。 |
|
end_time |
Float |
音频片段结束时间。 |
|
start_time |
Float |
音频片段开始时间。 |
|
detail |
Array of detail objects |
音频片段审核详情。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
confidence |
Float |
风险置信度。 |
|
label |
String |
风险标签。 |
|
suggestion |
String |
审核处理建议。
|
|
segments |
Array of segments objects |
命中的风险片段信息列表，如果命中语义算法模型，则该字段不会存在。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
segment |
String |
命中的风险片段。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
|
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
GET https://{endpoint}/v3/{project_id}/moderation/video/jobs/{job_id}
响应示例
状态码： 200
成功响应示例
{
"request_id" : "xxxx",
"job_id" : "xxx",
"status" : "succeeded",
"request_params" : {
"data" : {
"url" : "xxxx",
"frame_interval" : 5
},
"event_type" : "default",
"image_categories" : [ "porn", "terrorism", "image_text" ],
"audio_categories" : [ "porn", "ad", "moan", "abuse" ],
"callback" : "xxx"
},
"create_time" : "2022-07-30T08:57:11.011Z",
"update_time" : "2022-07-30T08:57:14.014Z",
"result" : {
"suggestion" : "block",
"image_detail" : [ {
"suggestion" : "block",
"category" : "porn",
"ocr_text" : "123",
"time" : 0,
"detail" : [ {
"confidence" : 0.676015138626099,
"category" : "porn",
"suggestion" : "block",
"label" : "pornography"
}, {
"confidence" : 0.666015138626099,
"category" : "porn",
"suggestion" : "review",
"label" : "sexy_female"
}, {
"confidence" : 0.666015138626099,
"category" : "xxx",
"suggestion" : "block",
"label" : "leader"
}, {
"confidence" : 0.691423773765564,
"category" : "xxx",
"suggestion" : "block",
"face_location" : {
"top_left_x" : 12,
"top_left_y" : 13,
"bottom_right_x" : 200,
"bottom_right_y" : 240
},
"label" : "leader"
}, {
"confidence" : 0.691423773765564,
"category" : "porn",
"suggestion" : "block",
"face_location" : {
"top_left_x" : 12,
"top_left_y" : 13,
"bottom_right_x" : 100,
"bottom_right_y" : 2000
},
"label" : "leader"
}, {
"confidence" : 0.891423773765564,
"category" : "image_text",
"suggestion" : "block",
"label" : "qr_code"
}, {
"confidence" : 0.891423773765564,
"category" : "image_text",
"suggestion" : "block",
"label" : "qr_code",
"qr_content" : "xxxxxxxxx",
"qr_location" : {
"top_left_x" : 12,
"top_left_y" : 13,
"bottom_right_x" : 100,
"bottom_right_y" : 2000
}
}, {
"confidence" : 0.891423773765564,
"category" : "image_text",
"suggestion" : "block",
"label" : "porn",
"segments" : [ {
"segment" : "xxx"
}, {
"segment" : "xx"
} ]
} ]
} ],
"audio_detail" : [ {
"suggestion" : "block",
"label" : "porn",
"audio_text" : "xxxxx",
"end_time" : 10,
"start_time" : 0,
"detail" : [ {
"confidence" : 0.999117187582349,
"label" : "porn",
"suggestion" : "block",
"segments" : [ {
"segment" : "xxx"
} ]
}, {
"confidence" : 0.885117187582349,
"label" : "porn",
"suggestion" : "block"
} ]
} ]
}
}
状态码： 400
失败响应示例
{
"error_code" : "AIS.0030",
"error_msg" : "Job not found"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功时返回作业状态和结果。 |
|
400 |
查询失败时返回错误原因。 |
