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

新建转封装任务

分享
更新时间: 2019/12/06 GMT+08:00

功能描述

创建转封装任务,转换音视频文件的格式,但不改变其分辨率和码率。

待转封装的媒资文件需要存储在与媒体处理服务同区域的OBS桶中,且该OBS桶已授权。

请求URI

POST /v1/{project_id}/remux

请求参数

表1 请求参数

参数

类型

说明

必选项(M)/可选项(O)

input

FileAddress object

源文件信息。

M

output

FileAddress object

输出文件信息。

M

output_param

RemuxOutputParam object

输出参数。

M

表2 FileAddress参数说明

参数名

类型

说明

必选项(M)/可选项(O)

location

String

OBS桶所在区域。

M

bucket

String

OBS桶名。

M

object

String

文件的存储路径。

  • 当用于“input”时,需要指定到具体对象。
  • 当用于“output”时,只需指定到转码结果期望存放的路径。

M

file_name

String

文件名,仅用于“output”输出。

  • 当指定了此参数时,输出的对象名为“object/file_name”
  • 当不指定此参数时,输出的对象名为“object/xxx”,其中xxx由系统指定。

O

表3 RemuxOutputParam参数说明

参数名

类型

说明

必选项(M)/可选项(O)

format

String

输出格式。

取值如下:
  • HLS
  • MP4

M

segment_duration

Integer

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

取值范围:[2,10]。

默认值: 5。

单位:秒。

O

请求样例

POST /v1/{project_id}/remux
{
	"input": {
	           "bucket": "obs-gg",
	           "location": "cn-north-7",
	           "object": "1/Shoushu_FLV.flv"
	},
	"output": {
	           "bucket": "obs-gg",
	           "location": "cn-north-7",
	           "object": "1/output1",
	           "file_name": "ouput.m3u8"
	},
	"output_param": {
	    "format":"HLS",
	    "segment_duration": 7
	}
} 

返回参数

  • 处理成功时返回
    表4 处理成功返回参数说明

    参数

    类型

    说明

    task_id

    Integer

    任务ID。

  • 处理失败时返回
    表5 处理失败返回参数说明

    参数

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误描述。

返回样例

  • 处理成功返回(201 Created)
    {
      "task_id": 57
    }
  • 处理失败返回(500 Internal Server Error)
    {
      "error_code": "MPC.10002",
      "error_msg": "NoSuchBucket"
    }

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

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

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区