文档首页 > > API参考> 视频内容分析API> 视频人物分析>

创建视频人物分析作业

创建视频人物分析作业

分享
更新时间:2021/02/01 GMT+08:00

功能介绍

该API用于创建视频人物分析的作业,对视频中出现的政治人物、名人明星等进行识别分析并预警视频中的敏感内容,帮助您快速定位处理,降低业务违规风险。

  • 支持扩展名为avi、wmv、mpg、mpeg、mp4、mov、m4v、mkv的视频文件。
  • 不支持OBS桶上经过KMS加密后的视频。
  • 单个视频大小不能超过4GB。
  • 从指定的URL地址中读取视频数据时,视频大小不能超过1GB。
  • 视频中人脸分辨率不低于40*40。
  • 支持人脸俯仰角15度、侧脸30度。
  • 同时检测的人脸不大于20个。
  • 支持的区域:北京一、北京四。

URI

  • URI格式
    POST /v2/{project_id}/services/video-celebrity-recognition/tasks
  • 参数说明

    名称

    是否必选

    类型

    说明

    project_id

    String

    服务所在区域对应的项目ID,获取方法请参见获取项目ID

请求消息

  • 请求样例
    POST /v2/6204a5bd270343b5885144cf9c8c158d/services/video-celebrity-recognition/tasks  
     {  
         "name": "task-est",  
         "description": "description",  
         "input": {  
                "type": "obs",  
                "data": [  
                       {  
                        "bucket": "obs-iva",  
                        "path": "input/demo.mp4"  
                       }  
                ]  
         },  
         "output": {  
                "obs": {  
                       "bucket": "obs-iva",  
                       "path": "output/"  
                }  
         },  
        "service_version":"1.0"  
     }
  • 请求参数说明

    参数名称

    是否为必选

    类型

    描述信息

    name

    String

    作业名称,只能由中文、字母(a~zA~Z)、数字(0~9)、中划线(-)、下划线(_)组成,长度范围为[1,100]。

    description

    String

    作业描述信息,最大长度为500字符长度。

    input

    Object

    视频数据的输入列表,目前视频人物分析支持以下输入类型:
    • obs:从华为云OBS中读取视频数据,视频大小不能超过4GB。不支持OBS桶上经过KMS加密后的视频。
    • url:从指定的URL地址中读取视频数据,视频大小不能超过1GB。目前支持OBS的URL,且需要设置该URL对匿名用户可读取权限,设置方法请参见桶的访问权限

    详细参数定义参见task.input(任务输入参数)

    service_version

    String

    功能版本填为“1.0”

    output

    Object

    结果数据的输出列表,目前视频人物分析支持以下输出类型:
    • obs:将结果输出到您指定的OBS桶中。
    • hosting:结果将托管到服务侧的OBS,该OBS路径由服务指定,您可以通过调用查询单个作业API获取该路径。

    详细参数定义见task.output(任务输出参数)

响应消息

  • 响应样例
    [    
       {      "id": "f18320e61e4c4dc685aa2dfc22a28dc5"   }  
    ]
  • 参数说明

    参数名称

    类型

    描述信息

    id

    String

    作业ID。

视频分析结果

  • 视频分析结果在用户输入的output路径下,以json文件的方式保存,结果文件内容示例如下:
    "frames": [
            {
                "url": "obs-dushubao/wxh_hjx/videopolitics/est/shijiuda30min.mp4.capture/3018.jpg",
                "offset": "00:02:00",
                "result": [
                    {
                        "label": "习近平",
                        "confidence": 0.6001852750778198,
                        "face_detail": {
                            "h": 71,
                            "w": 50,
                            "x": 302,
                            "y": 167
                        }
                    },
                    {
                        "label": "江泽民",
                        "confidence": 0.7005537152290344,
                        "face_detail": {
                            "h": 61,
                            "w": 48,
                            "x": 420,
                            "y": 247
                        }
                    }
                ]
            },
    ]
  • 结果文件的字段说明

    字段

    描述信息

    frames

    视频帧的识别结果。

    url

    视频帧的保存路径。

    offset

    识别的时间点。

    result

    检测出的名人信息。

    label

    检测出的人物名称。

    confidence

    结果置信度。

    face_detail

    人物面部区域信息,单位为像素:
    • h:区域高度
    • w:区域宽度
    • x:区域左上角的x坐标
    • y:区域左上角的y坐标

返回值

  • 正常

    201

  • 异常

    返回值

    说明

    400 Bad Request

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

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区论坛频道来与我们联系探讨

智能客服提问云社区提问