查询单个作业
功能介绍
该API用于查询并显示单个作业详情。
URI
- URI格式
GET /v2/{project_id}/services/video-moderation/tasks/{task_id} - 参数说明
名称
是否必选
类型
说明
project_id
是
String
项目ID。获取方法请参见获取项目ID。
task_id
是
String
作业ID。
请求消息
GET /v2/6204a5bd270343b5885144cf9c8c158d/services/video-moderation/tasks/f18320e61e4c4dc685aa2dfc22a28dc5
响应消息
- 响应示例
{ "description": "description", "service_version": "1.2", "output": { "obs": { "bucket": "obs-iva", "path": "output/" }, "hosting": { "obs": [ { "bucket": "obs-iva", "path": "hosting/f18320e61e4c4dc685aa2dfc22a28dc5/result.json" } ], "result_json_overdue_at": "2019-03-01T10:32:32Z" } }, "input": { "type": "obs", "data": [ { "bucket": "obs-iva", "path": "input/demo.mp4", "index": 0 } ] }, "created_at": "2019-03-01T10:32:12Z", "service_config": { "common": { "frame_interval": 1, "categories": "ad", "text_categories": "ad", "upload": "false", "use_ocr": "true", "use_sis": "true" } }, "name": "video-moderation-2", "id": "f18320e61e4c4dc685aa2dfc22a28dc5", "state": "SUCCEEDED", "hosting_result": { "overdueDate": "2019-03-28T10:32:32Z", "data": "{\"result\": {\"frames\": [{\"detail\": {\"ad\": [{\"confidence\": 0,\"label\": \"ad\"},{\"confidence\": 1,\"label\": \"normal\"}],\"ocr_ad\": [{\"text\": \"抢答器\"}]},\"frame_begin\": 92.0,\"frame_end\": 93.0,\"frame_img_path\": \"taskrd16xsvl/92_ad.jpg\",\"frame_suggestion\": \"block\",\"suspect_categories\": [\"ocr_ad\"]}],\"suggestion\": \"block\",\"voices\": [{\"content\": \"这个反应的抢答器，啊那么他身体上的一些不方便呢不会受到这个影响。好，请科学助理为两位戴上防干扰耳机，啊我不需要而且我觉得戴的不舒服，OK啊其实不戴耳机对我来说没有太大的干扰，我的注意力非常非常集中，除了屏幕上的这个摄像图和数字之外，我其他的看不到也听不到。\",\"detail\": {\"ad\": [\"抢答器\"]},\"voice_begin\": 92.24,\"voice_end\": 117.62,\"voice_suggestion\": \"block\"}]},\"video_path\": \"input/demo.mp4\"}", "fileSize": "329 bytes", "status": "AVAILABLE" }, "updated_at": "2019-03-02T10:32:34Z" } - 响应参数说明
参数名称
类型
描述信息
taskDetail
Object
作业详情，定义见task.detail（作业详情参数）。
结果说明
视频内容审核结果在用户输入的output路径下，以json文件的方式保存。
- 结果文件内容示例
{ "video_path": "demo.mp4", "result": { "frames": [ { "detail": { "ad": [ { "confidence": 0, "label": "ad" }, { "confidence": 1, "label": "normal" } ], "ocr_ad": [ { "text": "抢答器" } ] }, "frame_begin": 92.0, "frame_end": 93.0, "frame_img_path": "taskrd16xsvl/92_ad.jpg", "frame_suggestion": "block", "suspect_categories": [ "ocr_ad" ] } ], "voices": [ { "content": "这个反应的抢答器，啊那么他身体上的一些不方便呢不会受到这个影响。好，请科学助理为两位戴上防干扰耳机，啊我不需要而且我觉得戴的不舒服，OK啊其实不戴耳机对我来说没有太大的干扰，我的注意力非常非常集中，除了屏幕上的这个摄像图和数字之外，我其他的看不到也听不到。", "detail": { "ad": [ "抢答器" ] }, "voice_begin": 92.24, "voice_end": 117.62, "voice_suggestion": "block" } ], "suggestion": "block" } }
- 结果文件的字段说明
参数名称
描述信息
video_path
视频路径。
result
视频处理结果。
- result字段说明
参数名称
描述信息
suggestion
视频处理建议。
- review：建议人工复查。
- block：建议封禁。
- pass：审核通过。
voices
Json数组，表示语音场景问题详情，详细参数定义参见•语音场景问题片段具体字段含义。
当没有语音场景问题帧时，该数组显示为空。
frames
Json数组，表示视频问题帧详情，详细参数定义参见•视频场景问题帧具体字段含义。
当没有视频问题帧时，该数组显示为空。
- 语音场景问题片段具体字段含义
参数名称
描述信息
voice_begin
起始时间。
voice_end
结束时间。
content
语音文本内容。
detail
该片段具体情况，politics为涉政检测结果，porn为涉黄检测结果。具体字段含义参考文本内容检测API文档。
voice_suggestion
该片段处理建议。
- review：建议人工复查。
- block：建议禁止。
- 视频场景问题帧具体字段含义
参数名称
描述信息
frame_begin
起始帧位置。
单位：秒。
frame_end
结束帧位置。
单位：秒。
suspect_categories
该帧可疑的场景，其中有ocr前缀的为图片转文字后的审核结果。
frame_img_path
当该帧的frame_suggestion为review或者block时，并且创建视频作业时upload配置为true，会将当前帧作为图片保存到OBS上， frame_img_path表示图片的OBS保存地址。
detail
该帧具体情况，politics为涉政检测结果，terrorism为暴恐检测结果，porn为涉黄检测结果。具体字段含义参考图像内容检测API文档以及上述的文本内容审核API文档。
frame_suggestion
该帧处理建议。
- review：建议人工复查。
- block：建议禁止。
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误，具体返回错误码请参考错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。
