新建转码任务
功能描述
新建转码任务可以将视频转码，并在转码过程中压制水印、内容质检、视频截图等。视频转码前需要配置转码模板，具体请参见新建转码模板。
待转码的音视频需要存储在与媒体处理服务同区域的OBS桶中，且该OBS桶已授权。
请求URI
POST /v1/{project_id}/transcodings
请求参数
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
input |
file_addr object |
源文件存储地址。 |
M |
output |
file_addr object |
转码后的视频文件存储地址。 |
M |
trans_template_id |
Array of integers |
转码模板ID，数组，每一路转码输出对应一个转码配置模板ID，最多支持9个模板id
多个转码模板中如下参数可变，其他都必须一致：
|
M |
watermarks |
Array of Watermark objects |
图片水印参数，数组，最多支持20个成员。 |
O |
priority |
Integer |
任务优先级。
取值如下：
默认值：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 |
说明：
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
bucket |
String |
OBS的桶名称。 |
M |
location |
String |
桶所在的区域名， 如“华北-北京1”的区域名为“cn-north-1” |
M |
object |
String |
文件的存储路径。
|
M |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
input |
file_addr object |
水印图片存储地址。 |
M |
template_id |
String |
水印模板。 |
M |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
position |
Integer |
内容质检位置。
取值如下：
|
M |
index |
Integer |
转码模板ID索引。此索引必须为TransPresetID中的一个。 对应的是第几路的校验，比如一进六出，需要对第4路检查，就输入3。
说明：
|
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
subtitle_type |
Integer |
字幕类型（bitmap）。
取值如下：
|
O |
input |
file_addr object |
字幕文件存储地址，仅支持SRT格式字幕。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
key |
String |
内容加密秘钥, base64Binary。 |
M |
url |
String |
秘钥获取服务的地址。 |
M |
iv |
String |
初始向量，base64Binary，随机数。 |
O |
algorithm |
String |
加密算法。
取值如下：
默认值：AES-128-CBC |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
out |
file_addr object |
截图输出路径，若不设置，则与转码视频文件的输出地址相同。 |
O |
params |
thumbnail_param object |
截图参数。 |
M |
tar |
Integer |
是否压缩抽帧图片生成tar包。
取值如下：
默认值：1。 |
O |
名称 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
type |
String |
采样类型。
取值如下：
默认值：“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。 |
O |
aspect_ratio |
Integer |
纵横比，图像缩放方式）。
取值如下：
|
O |
width |
Integer |
截图宽度，需小于视频宽度且符合标准配置。 |
O |
height |
Integer |
截图高度，需小于视频高度且符合标准配置。 |
O |
max_length |
Integer |
截图长边尺寸（单位：像素），需小于视频长边。 短边尺寸按照该尺寸与原始视频像素等比缩放计算。 默认值：480。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
profile |
String |
取值如下：
|
M |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
type |
Integer |
音轨选取方式。
取值如下：
默认值：0。 |
M |
left |
Integer |
选取左声道所在的音轨编号。 |
O |
right |
Integer |
选取右声道所在的音轨编号。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
rotate |
Integer |
视频顺时针旋转角度。
取值如下：
默认值：0 |
M |
adaptation |
String |
长短边自适应控制字段。 取值如下：
默认值：SHORT |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
volume |
String |
音量调整方式。 取值如下：
|
O |
volume_expr |
Integer |
音量调整幅值，“volume”为“dynamic”时，该参数有效。 取值范围：[-15,15]。 单位：dB。 |
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" }
错误码
错误码请参见错误码。
