文档首页 > > API参考> 视频编辑API> 视频拆条>

创建视频拆条作业

创建视频拆条作业

分享
更新时间:2021/04/06 GMT+08:00

功能介绍

该API用于创建视频拆条的作业,可快速精确地把长视频分割成不同主题的片段,提高视频识别、剪辑、检索等处理的效率。

  • 支持扩展名为avi、wmv、mpg、mpeg、mp4、mov、m4v、mkv的视频文件。
  • 不支持OBS桶上经过KMS加密后的视频。
  • 单个视频大小不能超过4GB。
  • 从指定的URL地址中读取视频数据时,视频大小不能超过1GB。
  • 只支持有主持人出现的标准新闻视频。
  • 主持人人脸大于60像素。
  • 主持人出现在有效区域(去除边缘10%的区域)。
  • 同一主持人至少出现3次,每次出现持续正脸不得少于2秒。
  • 同时出现的主持人个数不大于3个。
  • 支持的区域:北京一、北京四。

URI

  • URI格式
    POST /v2/{project_id}/services/video-topic-segmentation-svc/tasks
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    String

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

请求消息

  • 请求样例1(输入类型为URL,输出类型为OBS)
    POST /v2/{project_id}/services/video-topic-segmentation-svc/task
    {
     "name": "url-obs",
     "input": {
      "type": "url",
      "data": [{
       "url": "https://obs-vcm.obs.cn-north-1.myhuaweicloud.com/videos/est_h264.mp4"
      }]
     },
     "output": {
      "obs": {
       "bucket": "obs-zuubo",
       "path": "out_put/"
      }
     },
     "service_version": "1.0"
    }
  • 请求样例2(输入类型为URL,输出类型为HOSTING)
    POST /v2/{project_id}/services/video-topic-segmentation-svc/tasks
    {
     "name": "url-hosting",
     "input": {
      "type": "url",
      "data": [{
       "url": "https://obs-vcm.obs.cn-north-1.myhuaweicloud.com/videos/est_h264.mp4"
      }]
     },
     "output": {
      "hosting": {}
     },
     "service_version": "1.0"
    }
  • 请求样例3(输入类型为OBS,输出类型为OBS)
    POST /v2/{project_id}/services/video-topic-segmentation-svc/tasks
    {
        "name": "obs-obs",
        "description": "description",
        "input": {
               "type": "obs",
               "data": [
                      {
                             "bucket": "obs-iva",
                             "path": "input/demo.mp4"
                      }
               ]
        },
        "output": {
               "obs": {
                      "bucket": "obs-iva",
                      "path": "output/"
               }
        },
       "service_version":"1.0"
    }
  • 请求样例4(输入类型为OBS,输出类型为HOSTING)
    POST /v2/{project_id}/services/video-topic-segmentation-svc/tasks
    {
     "name": "obs-hosting",
     "input": {
      "type": "obs",
      "data": [{
       "bucket": "obs-word",
       "path": "inputs/201807271900.mp4"
              }]
     },
     "output": {
      "hosting": {}
     },
     "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列表

    参数

    类型

    说明

    id

    String

    作业ID。

视频拆条结果

视频拆条结果在用户输入的output路径下,以json文件的方式保存。

  • 结果文件内容样例
    {
        "fps":25,
        "result":[
                 {
                    "frame":467,
                    "time":"00:00:18:17"
                 },
                 {
                    "frame":1374,
                    "time":"00:00:54:24"
                 }
            ]
    }
  • 字段说明

    字段

    说明

    fps

    视频帧率。

    result

    拆条结果数组。

    frame

    拆分点帧号。

    time

    拆分点时间。

返回值

  • 正常

    201

  • 异常

    返回值

    说明

    400 Bad Request

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

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问