文档首页 > > API参考> 视频解析接口> 新建视频解析任务

新建视频解析任务

分享
更新时间:2020/10/15 GMT+08:00

功能介绍

创建视频解析任务,解析视频元数据。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/extract-metadata

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必选,携带的鉴权信息。

X-Project_Id

String

使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。

X-Sdk-Date

String

使用AK/SK方式认证时必选,请求的发生时间。

表3 请求Body参数

参数

是否必选

参数类型

描述

input

ObsObjInfo object

源文件信息。

output

ObsObjInfo object

输出文件信息。

user_data

String

用户自定义数据。

sync

Integer

是否同步处理,

  • 0:排队处理

  • 1:同步处理

默认值:0

表4 ObsObjInfo

参数

是否必选

参数类型

描述

bucket

String

OBS的bucket名称。

location

String

输入OBS Bucket所在数据中心(OBS Location)。

object

String

OBS对象路径,遵守OSS Object定义。

  • 当用于指示input时,需要指定到具体对象。

  • 当用于指示output时, 只需指定到转码结果期望存放的路径。

file_name

String

文件名,仅用于转封装指定输出名称。

  • 当指定了此参数时,输出的对象名为object/file_name 。

  • 当不指定此参数时,输出的对象名为object/xxx,其中xxx由MPC指定。

响应参数

状态码为 200 时:

表5 响应Body参数

参数

参数类型

描述

task_id

String

任务ID

status

String

任务状态

create_time

String

任务创建时间

output

ObsObjInfo object

输出文件信息

output_file_name

String

解析文件名称

description

String

任务描述,如当任务异常时,此字段为异常的具体信息

metadata

MetaData object

视频文件元数据

表6 ObsObjInfo

参数

参数类型

描述

bucket

String

OBS的bucket名称。

location

String

输入OBS Bucket所在数据中心(OBS Location)。

object

String

OBS对象路径,遵守OSS Object定义。

  • 当用于指示input时,需要指定到具体对象。

  • 当用于指示output时, 只需指定到转码结果期望存放的路径。

file_name

String

文件名,仅用于转封装指定输出名称。

  • 当指定了此参数时,输出的对象名为object/file_name 。

  • 当不指定此参数时,输出的对象名为object/xxx,其中xxx由MPC指定。

表7 MetaData

参数

参数类型

描述

size

Long

文件大小。

duration_ms

Double

视频时长,带小数位显示。单位:秒。

duration

Long

视频时长。单位:秒。

format

String

文件封装格式。

bitrate

Integer

总码率。

video

Array of VideoInfo objects

视频流元数据。

audio

Array of AudioInfo objects

音频流元数据。

表8 VideoInfo

参数

参数类型

描述

width

Integer

视频宽度

height

Integer

视频高度

bitrate

Integer

视频码率,单位: kbit/s

bitrate_bps

Long

视频码率,单位: bit/s

frame_rate

Integer

帧率。

取值范围:0或[5,60],0表示自适应。

单位:帧每秒。

说明:

若设置的帧率不在取值范围内,则自动调整为0,若设置的帧率高于片源帧率,则自动调整为片源帧率。

codec

String

视频编码格式

dynamic_range

String

片源动态范围类型。

取值如下:

  • SDR

  • HDR10

  • CUVA_HDR

表9 AudioInfo

参数

参数类型

描述

codec

String

音频编码格式

sample

Integer

音频采样率

channels

Integer

音频信道

bitrate

Integer

音频码率,单位: kbit/s

bitrate_bps

Long

音频码率,单位: bit/s

状态码为 400 时:

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

POST https://{endpoint}/v1/{project_id}/extract-metadata
  {
  "input": {
             "bucket": "obs-gxh",
             "location": "region1",
             "object": "1/okFLV.flv"
  },
  "output": {
             "bucket": "obs-gxh",
             "location": "region1",
             "object": "1/output"
  },
  "sync": 0
  }

响应示例

状态码

状态码

描述

200

新建视频解析任务成功。

400

新建视频解析任务失败。

错误码

请参见错误码

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问