文档首页 > > API参考> 转封装接口> 新建转封装任务

新建转封装任务

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

功能介绍

创建转封装任务,转换音视频文件的格式,但不改变其分辨率和码率。 待转封装的媒资文件需要存储在与媒体处理服务同区域的OBS桶中,且该OBS桶已授权。

调试

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

URI

POST /v1/{project_id}/remux

表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

output_param

RemuxOutputParam object

输出参数。

表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指定。

表5 RemuxOutputParam

参数

是否必选

参数类型

描述

format

String

输出格式。

segment_duration

Integer

分片时长,仅当“format”为“HLS”时有效。

取值范围:[2,10]。

默认值: 5。

单位:秒。

响应参数

状态码为 200 时:

表6 响应Body参数

参数

参数类型

描述

task_id

String

任务ID

status

String

任务状态

create_time

String

任务创建时间

output

ObsObjInfo object

输出文件信息

output_file_name

String

解析文件名称

description

String

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

metadata

MetaData object

视频文件元数据

表7 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指定。

表8 MetaData

参数

参数类型

描述

size

Long

文件大小。

duration_ms

Double

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

duration

Long

视频时长。单位:秒。

format

String

文件封装格式。

bitrate

Integer

总码率。

video

Array of VideoInfo objects

视频流元数据。

audio

Array of AudioInfo objects

音频流元数据。

表9 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

表10 AudioInfo

参数

参数类型

描述

codec

String

音频编码格式

sample

Integer

音频采样率

channels

Integer

音频信道

bitrate

Integer

音频码率,单位: kbit/s

bitrate_bps

Long

音频码率,单位: bit/s

状态码为 400 时:

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

POST https://{endpoint}/v1/{project_id}/remux
{
    "input": {
               "bucket": "lihaiou-01",
               "location": "region1",
               "object": "input/test.flv"
    },
    "output": {
               "bucket": "lihaiou-01",
               "location": "region1",
               "object": "output/",
               "file_name" : "test.m3u8"
    },
    "output_param": {
        "format":"HLS",
        "segment_duration": 7
    }
}

响应示例

状态码

状态码

描述

200

新建转封装任务成功。

400

新建转封装任务失败。

错误码

请参见错误码

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问