新建转码任务
功能描述
新建转码任务可以将视频转码，并在转码过程中压制水印、内容质检、视频截图等。视频转码前需要配置转码模板，具体请参见新建转码模板。
请求URI
POST /v1/{project_id}/transcodings
请求参数
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
input |
源文件存储地址。 |
M |
|
output |
转码后的视频文件存储地址。 |
M |
|
trans_template_id |
Long[] |
转码模板ID，数组，每一路转码输出对应一个转码配置模板ID，最多支持9个模板id
多个转码模板中如下参数可变，其他都必须一致：
|
M |
watermarks |
图片水印参数，数组，最多支持20个成员。 |
O |
|
priority |
Int32 |
任务优先级。
取值如下：
默认值：6。 |
O |
audit |
内容质检参数。 |
O |
|
subtitle |
字幕参数。 |
O |
|
output_filenames |
String [] |
输出文件名称，每一路转码输出对应一个名称，需要与转一模板ID数组的顺序对应。
|
O |
encryption |
视频加密控制参数。 |
O |
|
thumbnail |
截图信息。 |
O |
|
video_process |
视频处理参数。 |
O |
|
audio_process |
音频处理参数。 |
O |
|
quality_enhance |
画质增强参数。 |
O |
|
digital_watermark |
数字水印属性。 |
O |
|
crop |
截取前多少秒进行转码。 |
O |
|
audio_track |
音轨参数。 |
O |
说明：
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
bucket |
String |
OBS的桶名称。 |
M |
location |
String |
桶所在的区域名， 如“华北-北京1”的区域名为“cn-north-1” |
M |
object |
String |
文件的存储路径。
|
M |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
position |
Int32 |
内容质检位置。
取值如下：
|
M |
index |
Int32 |
转码模板ID索引。此索引必须为TransPresetID中的一个。 对应的是第几路的校验，比如一进六出，需要对第4路检查，就输入3。
说明：
|
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
subtitle_type |
Int32 |
字幕类型（bitmap）。
取值如下：
|
O |
input |
字幕文件地址，仅支持SRT格式字幕。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
key |
String |
内容加密秘钥, base64Binary。 |
M |
url |
String |
秘钥获取服务的地址。 |
M |
iv |
String |
初始向量，base64Binary，随机数。 |
O |
algorithm |
String |
加密算法。
取值如下：
默认值：AES-128-CBC |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
out |
截图输出路径，若不设置，则与转码视频文件的输出地址相同。 |
O |
|
params |
截图参数。 |
M |
|
tar |
Integer |
是否压缩抽帧图片生成tar包。
取值如下：
默认值：1。 |
O |
名称 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
type |
String |
采样类型。
取值如下：
默认值：“TIME”。 |
M |
time |
Integer |
根据时间间隔采样时的时间间隔值。 默认值：12. 单位：秒。 |
O |
format |
Integer |
截图文件格式，当前只支持jpg。
取值如下：
默认值：1。 |
O |
aspect_ratio |
Integer |
纵横比，图像缩放方式）。
取值如下：
|
O |
width |
Integer |
截图宽度，需小于视频宽度且符合标准配置。 |
O |
height |
Integer |
截图高度，需小于视频高度且符合标准配置。 |
O |
max_length |
Integer |
截图长边尺寸（单位：像素），需小于视频长边。 短边尺寸按照该尺寸与原始视频像素等比缩放计算。 默认值：480。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
profile |
enum |
取值如下：
|
M |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
type |
Integer |
音轨选取方式。
取值如下：
默认值：0。 |
M |
left |
Integer |
选取左声道所在的音轨编号。 |
O |
right |
Integer |
选取右声道所在的音轨编号。 |
O |
参数 |
类型 |
说明 |
必选项（M）/可选项（O） |
|---|---|---|---|
rotate |
Integer |
视频顺时针旋转角度。
取值如下：
默认值：0 |
M |
参数 |
类型 |
说明 |
必选项（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": "/VOD/output/huawei09.jpg"
}
},
"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" }
错误码
错误码请参见错误码。
