更新时间:2021-08-03 GMT+08:00
分享

查询单个作业

功能介绍

该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:建议禁止。

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误,具体返回错误码请参考错误码

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

close