提交媒体处理任务。
接口说明
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ice:SubmitMediaConvertJob |
none |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
幂等性校验 Key。保证请求幂等性。 |
86f8e525-9d73-4dac-88aa-7aa4e950c00a |
| Config |
string |
是 |
转码任务配置，详情请参见 MediaConvertJobConfig 。 |
{ "Inputs": [ { "InputFile": { "Type": "OSS", "Media": "http://**.oss-cn-shanghai.aliyuncs.com/input/**/60min.mp4" } } ], "OutputGroups": [ { "GroupConfig": { "Type": "File", "OutputFileBase": { "Type": "OSS", "Media": "http://**.oss-cn-shanghai.aliyuncs.com/output/**/" } }, "Outputs": [ { "OutputFile": "hd.mp4", "TemplateId": "S00000001-200030" }, { "OutputFile": "sd.mp4", "TemplateId": "S00000001-200020" } ] } ] } |
| UserData |
string |
否 |
用户数据。 |
{"videoId":"abcd"} |
| PipelineId |
string |
否 |
管道 ID 。 |
e197ecfb103e4849922b054d3032f954 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
提交媒体转码任务结果。 |
||
| RequestId |
string |
请求 ID。 |
******11-DB8D-4A9A-875B-275798****** |
| Job |
object |
媒体转码任务。 |
|
| RequestId |
string |
请求 ID |
A2129C9F-CE95-58B5-B8C1-07758FF6C86F |
| ClientToken |
string |
创建媒体转码任务请求的幂等参数 |
FB7F25E9-AD9B-1603-8AF6-F1E42DF2E706 |
| JobId |
string |
媒体转码任务 ID。 |
****20b48fb04483915d4f2cd8ac**** |
| Config |
object |
媒体转码任务配置。 |
|
| Inputs |
array |
媒体转码任务输入列表 |
|
| MediaConvertInput |
媒体转码任务输入。 |
[{\"Src\":{\"Type\":\"MAP_SERVICE\",\"DataId\":\"479f6c63f66dcc1a9a09420fee32cbdf\",\"ZoomLevel\":18},\"Idx\":1}] |
|
| Outputs |
array |
媒体转码输出配置列表 |
|
| MediaConvertOutput |
媒体转码任务输出配置 |
[] |
|
| OutputGroups |
array |
媒体转码任务输出组配置列表 |
|
| MediaConvertOutputGroup |
媒体转码任务输出组配置。 |
||
| JobName |
string |
任务名称。 |
Name |
| PipelineId |
string |
管道 ID。 |
***48a4edf410b908aecd91fc3b*** |
| UserData |
string |
用户数据。 |
{"videoId":"abcd"} |
| Code |
string |
媒体转码任务失败时错误码，执行失败时返回。 |
InvalidParameter.ResourceContentBad |
| Message |
string |
媒体转码任务失败的详细信息，转码失败时返回。 |
The resource operated InputFile is bad |
| State |
string |
媒体转码任务状态：
|
Success |
| OutputDetails |
array |
媒体转码输出结果列表。 |
|
| MediaConvertOutputDetail |
媒体转码输出结果。 |
||
| OutputGroupDetails |
array |
媒体转码输出组结果列表。 |
|
| MediaConvertOutputGroupDetail |
媒体转码输出组结果。 |
示例
正常返回示例
JSON格式
{
"RequestId": "******11-DB8D-4A9A-875B-275798******",
"Job": {
"RequestId": "A2129C9F-CE95-58B5-B8C1-07758FF6C86F",
"ClientToken": "FB7F25E9-AD9B-1603-8AF6-F1E42DF2E706",
"JobId": "****20b48fb04483915d4f2cd8ac****",
"Config": {
"Inputs": [
{
"Name": "InputVideo",
"InputFile": {
"Type": "OSS",
"Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
}
}
],
"Outputs": [
{
"OutputFile": {
"Type": "OSS",
"Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
},
"Priority": 6,
"OverrideParams": "{}",
"Features": "{}",
"TemplateId": "****96e8864746a0b6f3****",
"Name": "output-video"
}
],
"OutputGroups": [
{
"GroupConfig": {
"OutputFileBase": {
"Type": "OSS",
"Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
},
"ManifestName": "manifest",
"Type": "Hls"
},
"Outputs": [
{
"Priority": 6,
"OverrideParams": "{}",
"Features": "{}",
"OutputFileName": "720p.mp4",
"TemplateId": "****96e8864746a0b6f3****\n",
"Name": "group-output"
}
],
"Name": "hls-group"
}
],
"JobName": "Name"
},
"PipelineId": "***48a4edf410b908aecd91fc3b***",
"UserData": "{\"videoId\":\"abcd\"}",
"Code": "InvalidParameter.ResourceContentBad",
"Message": "The resource operated InputFile is bad",
"State": "Success",
"OutputDetails": [
{
"Status": "Success",
"TaskId": "******4215e042b3966ca5441e******",
"Message": "The resource operated InputFile is bad\n",
"FinishTime": "2024-12-07T13:01:07Z",
"CreateTime": "2024-12-07T06:06:58Z",
"Code": "InvalidParameter.ResourceContentBad\n",
"Name": "720P-mp4",
"Result": {
"OutputFile": {
"Type": "OSS",
"Media": "oss://bucket/path/to/video.mp4\n",
"Url": "oss://bucket/path/to/video.mp4"
},
"OutFileMeta": {
"VideoStreamInfoList": [
{
"Rotate": "0",
"Codec_tag": "0x001b",
"Sar": "478:477",
"Start_time": "1.473556",
"Fps": "25.0",
"Index": "0",
"Duration": "403.039989",
"Lang": "cn",
"Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"PixFmt": "yuv420p",
"Bit_rate": "888.563",
"Profile": "High",
"Has_b_frames": "2",
"Codec_time_base": "1/50",
"Dar": "16:9",
"Avg_fps": "25.0",
"Codec_tag_string": "[27][0][0][0]",
"Codec_name": "h264",
"Height": "478",
"Level": "31",
"Time_base": "1/90000",
"Width": "848",
"NumFrames": "10040"
}
],
"AudioStreamInfoList": [
{
"CodecTag": "0x000f",
"CodecTimeBase": "1/44100",
"ChannelLayout": "stereo",
"StartTime": "1.473556",
"Index": "1",
"Duration": "403.039989",
"Lang": "cn",
"SampleFmt": "fltp",
"CodecName": "aac",
"Bitrate": "0.f",
"Channels": "2",
"Timebase": "1/90000",
"CodecTagString": "[15][0][0][0]",
"SampleRate": "44100",
"CodecLongName": "AAC (Advanced Audio Coding)"
}
],
"FileBasicInfo": {
"FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
"FileStatus": "Normal",
"MediaId": "9066406c306771f0bfa35107e0c90102",
"FileType": "source_file",
"FileName": "file.m3u8",
"Region": "cn-shanghai",
"FormatName": "hls,applehttp",
"Duration": "403.039999",
"Height": "478",
"Bitrate": "888.563",
"Width": "848",
"FileSize": "31737"
}
}
}
}
],
"OutputGroupDetails": [
{
"Status": "Success",
"TaskId": "******22dad741d086a50325f9******",
"Message": "The resource operated \"InputFile\" is bad",
"FinishTime": "2025-03-21T01:48:41Z\n",
"CreateTime": "2025-03-21T01:48:41Z",
"Outputs": [
{
"Status": "Success",
"TaskId": "******4215e042b3966ca5441e******",
"Message": "The resource operated InputFile is bad\n",
"FinishTime": "2024-12-07T13:01:07Z",
"CreateTime": "2024-12-07T06:06:58Z",
"Code": "InvalidParameter.ResourceContentBad\n",
"Name": "720P-mp4",
"Result": {
"OutputFile": {
"Type": "OSS",
"Media": "oss://bucket/path/to/video.mp4\n",
"Url": "oss://bucket/path/to/video.mp4"
},
"OutFileMeta": {
"VideoStreamInfoList": [
{
"Rotate": "0",
"Codec_tag": "0x001b",
"Sar": "478:477",
"Start_time": "1.473556",
"Fps": "25.0",
"Index": "0",
"Duration": "403.039989",
"Lang": "cn",
"Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"PixFmt": "yuv420p",
"Bit_rate": "888.563",
"Profile": "High",
"Has_b_frames": "2",
"Codec_time_base": "1/50",
"Dar": "16:9",
"Avg_fps": "25.0",
"Codec_tag_string": "[27][0][0][0]",
"Codec_name": "h264",
"Height": "478",
"Level": "31",
"Time_base": "1/90000",
"Width": "848",
"NumFrames": "10040"
}
],
"AudioStreamInfoList": [
{
"CodecTag": "0x000f",
"CodecTimeBase": "1/44100",
"ChannelLayout": "stereo",
"StartTime": "1.473556",
"Index": "1",
"Duration": "403.039989",
"Lang": "cn",
"SampleFmt": "fltp",
"CodecName": "aac",
"Bitrate": "0.f",
"Channels": "2",
"Timebase": "1/90000",
"CodecTagString": "[15][0][0][0]",
"SampleRate": "44100",
"CodecLongName": "AAC (Advanced Audio Coding)"
}
],
"FileBasicInfo": {
"FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
"FileStatus": "Normal",
"MediaId": "9066406c306771f0bfa35107e0c90102",
"FileType": "source_file",
"FileName": "file.m3u8",
"Region": "cn-shanghai",
"FormatName": "hls,applehttp",
"Duration": "403.039999",
"Height": "478",
"Bitrate": "888.563",
"Width": "848",
"FileSize": "31737"
}
}
}
}
],
"Code": "InvalidParameter.ResourceContentBad",
"Name": "hls-group"
}
]
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。