メディア処理ジョブを送信します。
操作説明
これは非同期 API です。タスクを送信すると、API はすぐにタスク ID を返し、タスクをキューに入れてバックグラウンドで処理します。最終結果はコールバックで返されますが、メディアトランスコーディングタスクのクエリ API を呼び出してタスクのステータスをポーリングすることもできます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ice:SubmitMediaConvertJob |
none |
*All Resource
|
なし | なし |
リクエスト構文
POST HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するためにクライアントが生成したトークンです。 |
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 |
出力グループ結果です。 |
例
成功レスポンス
JSONJSON
{
"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"
}
]
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。