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

新建转码任务

分享
更新时间: 2019/08/13 14:06

功能描述

新建转码任务可以将视频转码,并在转码过程中压制水印、内容质检、视频截图等。视频转码前需要配置转码模板,具体请参见新建转码模板

待转码的音视频需要存储在与媒体处理服务同区域的OBS桶中,且该OBS桶已授权。

请求URI

POST /v1/{project_id}/transcodings

请求参数

表1 请求参数说明

参数

类型

说明

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

input

file_addr object

源文件存储地址。

M

output

file_addr object

转码后的视频文件存储地址。

M

trans_template_id

Array of integers

转码模板ID,数组,每一路转码输出对应一个转码配置模板ID,最多支持9个模板id

多个转码模板中如下参数可变,其他都必须一致:
  • 视频 bitrate,height,width。
  • 音频 bitrate。

M

watermarks

Array of Watermark objects

图片水印参数,数组,最多支持20个成员。

O

priority

Integer

任务优先级。

取值如下:
  • 9:表示高优先级。
  • 6:表示中优先级。

默认值:6。

O

audit

Array of Audit objects

内容质检参数。

O

subtitle

Array of Subtitle objects

字幕参数。

O

output_filenames

Array of strings

输出文件名称,每一路转码输出对应一个名称,需要与转一模板ID数组的顺序对应。

  • 若设置该参数,表示输出文件按该参数命名;
  • 若不设置该参数,表述输出文件按默认方式命名。

O

encryption

Encryption object

视频加密控制参数。

O

thumbnail

Thumbnail object

截图信息。

O

video_process

VideoProcess object

视频处理参数。

O

audio_process

AudioProcess object

音频处理参数。

O

quality_enhance

QualityEnhance object

画质增强参数。

O

digital_watermark

DigitalWatermark object

数字水印属性。

O

crop

Crop object

截取前多少秒进行转码。

O

audio_track

AudioTrack object

音轨参数。

O

说明:

设置截图参数后,视频转码后会输出转码后的视频和对应的截图文件。

但是截图时仅支持按照标准分辨率设置的转码模板进行转码,即trans_template_id对应模板的width/height参数仅限于表2中的4种。

表2 标准分辨率

画质

分辨率

全高清1080p

1920*1080

高清720p

1280*720

标清480p

854*480

流畅270p

480*270

表3 file_addr参数说明

参数

类型

说明

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

bucket

String

OBS的桶名称。

M

location

String

桶所在的区域名, 如“华北-北京1”的区域名为“cn-north-1”

M

object

String

文件的存储路径。

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

M

表4 Watermark参数说明

参数

类型

说明

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

input

file_addr object

水印图片存储地址。

M

template_id

String

水印模板。

M

表5 Audit参数说明

参数

类型

说明

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

position

Integer

内容质检位置。

取值如下:
  • 1:原始片源检查。
  • 2:转码后片源检查,转码后的片源分辨率必须为720p及以上,且格式需与原始片源一致。

M

index

Integer

转码模板ID索引。此索引必须为TransPresetID中的一个。

对应的是第几路的校验,比如一进六出,需要对第4路检查,就输入3。

说明:
  • 如对原片源质检,此字段不填。
  • 原始码率和转码后的码率都必须是1280*720及之上。
  • 若对转码后片源检测,必须和原始分辨率一致。

O

表6 Subtitle参数说明

参数

类型

说明

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

subtitle_type

Integer

字幕类型(bitmap)。

取值如下:
  • 0:不嵌入字幕。
  • 1:外部字幕文件嵌入视频流

O

input

file_addr object

字幕文件存储地址,仅支持SRT格式字幕。

O

表7 Encryption参数说明

参数

类型

说明

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

hls_encrypt

HlsEncrypt object

hls视频加密控制参数

O

表8 HlsEncryp参数说明

参数

类型

说明

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

key

String

内容加密秘钥, base64Binary。

M

url

String

秘钥获取服务的地址。

M

iv

String

初始向量,base64Binary,随机数。

O

algorithm

String

加密算法。

取值如下:
  • AES-128-CTR
  • AES-128-CBC

默认值:AES-128-CBC

O

表9 Thumbnail参数说明

参数

类型

说明

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

out

file_addr object

截图输出路径,若不设置,则与转码视频文件的输出地址相同。

O

params

thumbnail_param object

截图参数。

M

tar

Integer

是否压缩抽帧图片生成tar包。

取值如下:
  • 0:压缩
  • 1:不压缩

默认值:1。

O

表10 thumbnail_param参数说明

名称

类型

说明

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

type

String

采样类型。

取值如下:
  • “TIME”:根据时间间隔采样截图。
  • “DOTS” : 指定时间点截图

默认值:“TIME”。

M

time

Integer

采样截图的时间间隔值。

默认值:12

单位:秒

O

start_time

Integer

采样类型为“TIME”模式的开始时间,和“time”配合使用。默认值:0

单位:秒。

O

duration

Integer

采样类型为“TIME”模式的持续时间,和“time”“start_time”配合使用,表示从视频文件的第“start_time”开始,持续时间为“duration”,每间隔“time”生成一张截图。

取值范围:[数字,ToEND]
说明:

“数字”:大于等0,若“duration”设置为0,则从截图生成时间为“start_time”到视频结束。

“ToEND”:表示“start_time”到视频结束的持续时长。

默认值:ToEND

单位:秒

O

dots

Array of integers

指定时间截图时的时间点数组。

O

format

Integer

截图文件格式,当前只支持jpg。

取值如下:
  • 1 : jpg。

默认值:1。

O

aspect_ratio

Integer

纵横比,图像缩放方式)。

取值如下:
  • 0:自适应(保持原有宽高比)。
  • 1:16:9。

O

width

Integer

截图宽度,需小于视频宽度且符合标准配置

O

height

Integer

截图高度,需小于视频高度且符合标准配置

O

max_length

Integer

截图长边尺寸(单位:像素),需小于视频长边。

短边尺寸按照该尺寸与原始视频像素等比缩放计算。

默认值:480。

O

表11 DigitalWatermark参数说明

参数

类型

说明

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

profile

String

取值如下:
  • ROBUST:水印鲁棒性最高。
  • MEDIUM:水印鲁棒性和视频质量折中。
  • QUALITY :视频质量最好。

M

表12 Crop参数说明

参数

类型

说明

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

duration

Integer

截取的视频时长,从0秒开始算起。

默认值:0。

单位:秒。

M

表13 AudioTrack参数说明

参数

类型

说明

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

type

Integer

音轨选取方式。

取值如下:
  • 0:表示默认选取。
  • 1:表示手动选择。

默认值:0。

M

left

Integer

选取左声道所在的音轨编号。

O

right

Integer

选取右声道所在的音轨编号。

O

表14 VideoProcess参数说明

参数

类型

说明

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

rotate

Integer

视频顺时针旋转角度。

取值如下:
  • 0:表示不旋转
  • 1:表示顺时针旋转90度
  • 2:表示顺时针旋转180度
  • 3:表示顺时针旋转270度

默认值:0

M

adaptation

String

长短边自适应控制字段。

取值如下:

  • SHORT:表示短边自适应
  • LONG:表示长边自适应
  • NONE:表示不自适应

默认值:SHORT

O

表15 AudioProcess参数说明

参数

类型

说明

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

volume

String

音量调整方式。

取值如下:

  • auto:表示自动调整音量。
  • dynamic:表示人为调整,需设定音量调整幅值。

O

volume_expr

Integer

音量调整幅值,“volume”“dynamic”时,该参数有效。

取值范围:[-15,15]。

单位:dB。

O

表16 QualityEnhance参数说明

参数

类型

说明

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

normal_enhance

String

针对一般质量、无明显问题的普通片源,通过增强、锐化等技术明显提升主观效果。单纯该处理操作前后,分辨率、帧率等参数不发生变化。i

取值如下:

  • normal

O

说明:

在转码过程中截图仅支持截取按照标准配置尺寸的图片,若需要自定义截图尺寸,请使用新建截图任务接口。

请求样例

POST /v1/{project_id}/transcodings

{
"input": {
           "bucket": "example-bucket",
           "location": "cn-north-1",
           "object": "/VOD/input/sample.MP4"
},
"output": {
           "bucket": "example-bucket",
           "location": "cn-north-1",
           "object": "/VOD/output/"
},
"trans_template_id":[1002,1003,1004,1005],
"watermarks": [{
	"input": {
		"bucket": "example-bucket",
		"location": "cn-north-1",
		"object": "meipai.jpg"
	},
	"template_id":242
}],
"priority":"9",
"audit":{
	"position":2,
         "index":2
},
"subtitle":{
	"subtitle_type":1,
	"input": {
	        "bucket": "bucket,
		"location": "cn-north-1",
	        "object": "subtitle.srt"
		}
},
"output_filenames":["test","test2","test3","test4"],
"encryption": {
	"hls_encrypt": {
		"key": "aigPLJhffXBNnERs",
		"url": "https://vod.cn-north-1.myhuaweicloud.com/encrypt/getkey",
		"iv":"yCmE666N3YAq30SN",
                "algorithm":"AES-128-CTR"
             }	
},
"thumbnail": {
    "out":{
           "bucket": "example-bucket",
           "location": "cn-north-1",
           "object": "/VOD/output/"
        },
    "tar" : 1,
    "params": {
        "type":"TIME"
         "time":2,
        "format":1,
        "aspect_ratio":1,
        "max_length":480
    }
}
} 

返回参数

  • 创建成功时返回
    表17 创建成功返回参数说明

    参数

    类型

    说明

    task_id

    Integer

    任务ID。

  • 创建失败时返回
    表18 创建失败返回参数说明

    参数

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误描述。

返回样例

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

错误码

错误码请参见错误码

如果您喜欢这篇文档,您还可以:

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区