トランスコーディングジョブを送信します。ApsaraVideo Media Processing (MPS) コンソールで作成されたトランスコーディングジョブとワークフローがビジネス要件を満たせない場合、SubmitJobs 操作を呼び出してトランスコーディングジョブを送信できます。SubmitJobs 操作を呼び出す際に、必要に応じてトランスコーディングパラメーターを指定します。
操作説明
SubmitJobs は非同期操作です。トランスコーディングジョブを送信すると、ジョブは MPS キューに追加され、スケジューリングされて実行されます。応答が返された時点では、トランスコーディングジョブは完了していない可能性があります。この操作を呼び出した後、QueryJobList 操作を呼び出してジョブの結果をクエリできます。また、Message Service (MNS) のキューまたはトピックを MPS キューに関連付けて、ジョブに関する通知を受信することもできます。詳細については、「通知の受信」をご参照ください。
入力ファイルのサイズは最大 100 GB です。入力ファイルのサイズがこの制限を超えると、ジョブが失敗する可能性があります。
インテリジェントプリセットテンプレートを使用して入力ファイルをトランスコーディングする場合、まず SubmitAnalysisJob 操作を呼び出してプリセットテンプレート分析ジョブを送信する必要があります。分析ジョブが完了した後、QueryAnalysisJobList 操作を呼び出して、入力ファイルに利用可能なプリセットテンプレートを取得できます。トランスコーディングジョブを送信する際、TemplateId を利用可能なプリセットテンプレートの ID に設定します。利用可能なプリセットテンプレートにないプリセットテンプレートを指定すると、トランスコーディングジョブは失敗します。
静的プリセットテンプレートを使用して入力ファイルをトランスコーディングする場合、プリセットテンプレート分析ジョブを送信する必要はありません。
MPS で複数のアカウントを使用したい場合は、ご利用の Alibaba Cloud アカウントを使用して Resource Access Management (RAM) ユーザーを作成できます。詳細については、「RAM ユーザーの作成と権限付与」をご参照ください。トランスコーディングジョブをクエリするために使用される Alibaba Cloud アカウントが、トランスコーディングジョブを送信するために使用されたアカウントでない場合、データは返されません。
トランスコーディングに関するよくある質問については、「MPS に関するよくある質問」をご参照ください。
QPS 制限
この操作は、アカウントごとに 1 秒あたり最大 100 回呼び出すことができます。この制限を超えるリクエストは破棄され、サービスが中断されます。この操作を呼び出す際には、この制限に注意することを推奨します。詳細については、「QPS 制限」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
mts:SubmitJobs |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Input |
string |
必須 |
入力ファイルに関する情報。詳細については、「パラメーターの詳細」トピックの「Input」セクションをご参照ください。 説明
|
{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"example.flv","Referer": "用户自行在OSS控制台设置的OSS防盗链参数"} |
| Outputs |
string |
必須 |
ジョブ出力設定。詳細については、「パラメーターの詳細」トピックの「Output」セクションをご参照ください。
|
[{"OutputObject":"exampleOutput.mp4","TemplateId":"6181666213ab41b9bc21da8ff5ff****","WaterMarks":[{"InputFile":{"Bucket":"exampleBucket","Location":"oss-cn-hangzhou","Object":"image_01.png"},"WaterMarkTemplateId":"9b772ce2740d4d55876d8b542d47****"}],"UserData":"testid-001"}] |
| OutputBucket |
string |
必須 |
出力ファイルを格納する OSS バケットの名前。
|
exampleBucket |
| OutputLocation |
string |
任意 |
出力ファイルを格納する OSS バケットが存在するリージョン。
|
oss-cn-hangzhou |
| PipelineId |
string |
必須 |
MPS キューの ID。詳細については、「用語」をご参照ください。 |
dd3dae411e704030b921e52698e5**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| JobResultList |
object |
||
| JobResult |
array<object> |
生成されたトランスコーディングジョブ。 |
|
|
array<object> |
|||
| Code |
string |
ジョブの作成に失敗した場合に返されるエラーコード。ジョブが作成された場合、このパラメーターは返されません。 |
InvalidParameter.NullValue |
| Job |
object |
ジョブの詳細。ジョブの送信に失敗した場合、ジョブ ID は生成されません。 |
|
| Code |
string |
ジョブが失敗した場合に返されるエラーコード。ジョブが成功した場合、このパラメーターは返されません。 |
InternalError |
| CreationTime |
string |
ジョブが作成された時刻。 |
2014-01-10T12:00:00Z |
| FinishTime |
string |
ジョブが完了した時刻。 |
2014-01-10T12:20:00Z |
| Input |
object |
ジョブ入力に関する情報。 |
|
| Bucket |
string |
ジョブ入力が格納されている OSS バケットの名前。 |
example-bucket-**** |
| Location |
string |
ジョブ入力が格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
ジョブ入力として使用される OSS オブジェクトの名前。 |
example.flv |
| JobId |
string |
ジョブ ID。 |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| MNSMessageResult |
object |
ジョブの結果をユーザーに通知するために MNS によって送信されたメッセージ。 |
|
| ErrorCode |
string |
ジョブが失敗した場合に返されるエラーコード。ジョブが成功した場合、このパラメーターは返されません。 |
InvalidParameter.ResourceNotFound |
| ErrorMessage |
string |
ジョブが失敗した場合に返されるエラーメッセージ。ジョブが成功した場合、このパラメーターは返されません。 |
The resource operated "%s" cannot be found. |
| MessageId |
string |
ジョブが失敗した場合に返されるエラーメッセージの ID。ジョブが成功した場合、このパラメーターは返されません。 |
123 |
| Message |
string |
ジョブが失敗した場合に返されるエラーメッセージ。ジョブが成功した場合、このパラメーターは返されません。 |
The operation has failed due to some unknown error, exception or failure. |
| Output |
object |
ジョブの出力。 |
|
| AmixList |
object |
||
| Amix |
array<object> |
ミックスされたオーディオトラック。 |
|
|
object |
|||
| AmixURL |
string |
バックグラウンドミュージックとしてミックスされるオーディオトラックの URL。
|
https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3 |
| Duration |
string |
ミックスされたオーディオトラックの長さ。値は数値または時間形式です。 |
20 |
| Map |
string |
ミックスされるオーディオトラック。フォーマット:0:a:{audio_index}。例:0:a:0。 |
0:a:0 |
| MixDurMode |
string |
ミキシング時間を指定するモード。有効値:first および long。
|
long |
| Start |
string |
開始時刻。値は数値または時間形式です。例:1:25:36.240 および 32000.23。 |
0 |
| Audio |
object |
オーディオ設定。 説明
このパラメーターがリクエストで指定された場合、指定されたトランスコーディングテンプレート内の対応する設定は上書きされます。 |
|
| Bitrate |
string |
出力ファイルのオーディオビットレート。
|
128 |
| Channels |
string |
サウンドチャンネルの数。
|
6 |
| Codec |
string |
オーディオコーデック。
|
aac |
| Profile |
string |
オーディオのコーデックプロファイル。 説明
Codec の値が aac の場合、有効値は aac_low、aac_he、aac_he_v2、aac_ld、aac_eld です。 |
aac_low |
| Qscale |
string |
オーディオの品質管理レベル。 |
15 |
| Samplerate |
string |
サンプリングレート。
説明
ビデオコンテナフォーマットが FLV で、オーディオコーデックが MP3 の場合、このパラメーターの値は 32000、48000、または 96000 にはできません。オーディオコーデックが MP3 の場合、このパラメーターの値は 96000 にはできません。 |
32000 |
| Volume |
object |
ボリューム設定。 |
|
| Level |
string |
ボリューム調整範囲。
|
-20 |
| Method |
string |
ボリュームを調整するために使用されるメソッド。有効値:
|
auto |
| AudioStreamMap |
string |
オーディオストリームのシーケンス番号。
|
0:a:0 |
| Clip |
object |
クリップに関する情報。 |
|
| TimeSpan |
object |
クリップのタイムスパン。 |
|
| Duration |
string |
クリップの長さ。
|
01:00:59.999 |
| Seek |
string |
開始時刻。
|
01:59:59.999 |
| Container |
object |
コンテナフォーマット設定。 |
|
| Format |
string |
コンテナフォーマット。
|
flv |
| DeWatermark |
string |
ウォーターマークのぼかしの設定。値は JSON オブジェクトです。詳細については、「パラメーターの詳細」トピックの DeWatermark セクションをご参照ください。 |
{"0": [{"l": 10,"t": 10,"w": 10,"h": 10},{"l": 100,"t": 0.1,"w": 10,"h": 10}],"128000": [],"250000": [{"l": 0.2,"t": 0.1,"w": 0.01,"h": 0.05}]} |
| DigiWaterMark |
object |
デジタルウォーターマーク。 |
|
| Alpha |
string |
テキストまたは画像の透明度。
|
1.0 |
| InputFile |
object |
入力ファイルの詳細。 |
|
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket-**** |
| Location |
string |
入力ファイルが格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
入力ファイルとして使用される OSS オブジェクトの名前。 |
example-intput.flv |
| Type |
string |
ウォーターマークのタイプ。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。有効値:
|
Image |
| Encryption |
object |
暗号化設定。M3U8 フォーマットの出力のみがサポートされています。 |
|
| Id |
string |
暗号化 ID。 |
31fa3c9ca8134f9cec2b4b0b0f78**** |
| Key |
string |
ビデオを暗号化するために使用されるキー。 |
encryptionkey128 |
| KeyType |
string |
キー暗号化方式。キーはプレーンテキストで MPS に送信できません。キーは Base64 または Key Management Service (KMS) を使用して暗号化する必要があります。たとえば、キーが encryptionkey128 の場合、Base64("encryptionkey128") または KMS(Base64("encryptionkey128") のようなメソッドでキーを暗号化できます。 |
Base64 |
| KeyUri |
string |
キーをリクエストするために使用される URL。URL は Base64 でエンコードされます。 |
https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ |
| SkipCnt |
string |
ビデオの冒頭にある非暗号化フレームの数。これらのフレームを非暗号化のままにすることで、ビデオ再生を迅速に開始できます。 |
3 |
| Type |
string |
暗号化タイプ。hls-aes-128 のみが返される場合があります。 |
hls-aes-128 |
| M3U8NonStandardSupport |
object |
M3U8 の非標準サポート設定。値は JSON オブジェクトです。詳細については、「パラメーターの詳細」トピックの M3U8NonStandardSupport セクションをご参照ください。 |
|
| TS |
object |
TS ファイルの非標準サポート設定。値は JSON オブジェクトです。詳細については、「パラメーターの詳細」トピックの TS セクションをご参照ください。 |
|
| Md5Support |
boolean |
M3U8 ビデオで TS ファイルの MD5 値の出力がサポートされているかどうかを示します。有効値:
|
true |
| SizeSupport |
boolean |
出力 M3U8 ビデオで TS ファイルのサイズが生成されるかどうかを示します。有効値:
|
true |
| MergeConfigUrl |
string |
マージ設定ファイルの URL。MergeList と MergeConfigUrl のうち 1 つだけが有効になります。
|
`{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]} |
| MergeList |
object |
||
| Merge |
array<object> |
クリップをマージするための設定。 |
|
|
object |
|||
| Duration |
string |
クリップの長さ。
|
00000.20 |
| MergeURL |
string |
クリップの OSS URL。
|
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv |
| RoleArn |
string |
委任された権限付与に使用される RAM ロールの Alibaba Cloud リソースネーム (ARN)。 |
acs:ram:: |
| Start |
string |
クリップの開始時点。
|
00000.50 |
| MuxConfig |
object |
トランスマックス設定。このパラメーターがリクエストで指定された場合、指定されたトランスコーディングテンプレート内の対応する設定は上書きされます。 |
|
| Gif |
object |
GIF のトランスマックス設定。 |
|
| DitherMode |
string |
パレットのカラーディザリングアルゴリズム。有効値:sierra および bayer。 |
bayer |
| FinalDelay |
string |
最終フレームが一時停止する時間。単位:センチ秒。 |
0 |
| IsCustomPalette |
string |
カスタムパレットが使用されるかどうかを示します。有効値:
|
false |
| Loop |
string |
ループ回数。 |
0 |
| Segment |
object |
セグメント設定。値は JSON オブジェクトです。 |
|
| Duration |
string |
セグメントの長さ。値は整数です。単位:秒。
|
20 |
| Webp |
object |
WebP のトランスマックス設定。 |
|
| Loop |
string |
ループ回数。 |
0 |
| OpeningList |
object |
||
| Opening |
array<object> |
オープニングパート。値は JSON オブジェクトです。 |
|
|
object |
|||
| Height |
string |
オープニングパートの高さ。
|
1080 |
| Start |
string |
オープニングパートが再生されるまでの時間。値は 0 から始まります。
|
1 |
| Width |
string |
オープニングパートの幅。
|
1920 |
| openUrl |
string |
オープニングパートの OSS URL。 |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| OutSubtitleList |
object |
||
| OutSubtitle |
array<object> |
出力字幕。 |
|
|
array<object> |
|||
| Map |
string |
ビデオトラック。フォーマット: |
0:v:0 |
| Message |
string |
ジョブの作成に失敗した場合に返されるエラーメッセージ。ジョブが作成された場合、このパラメーターは返されません。 |
The specified parameter “%s” cannot be null. |
| OutSubtitleFile |
object |
出力ファイルの詳細。 |
|
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket-**** |
| Location |
string |
出力ファイルが格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
出力ファイルとして使用される OSS オブジェクトの名前。 |
example-output.flv |
| RoleArn |
string |
委任された権限付与に使用される RAM ロールの ARN。 |
acs:ram:: |
| Success |
boolean |
ジョブが作成されたかどうかを示します。有効値:
|
true |
| OutputFile |
object |
出力ファイルの詳細。 |
|
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket-**** |
| Location |
string |
出力ファイルが格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
出力ファイルとして使用される OSS オブジェクトの名前。 |
example-output.flv |
| RoleArn |
string |
委任された権限付与に使用される RAM ロールの ARN。 |
acs:ram:: |
| Priority |
string |
ジョブが追加される MPS キュー内のジョブの優先度。
|
5 |
| Properties |
object |
メディアプロパティ。 |
|
| Bitrate |
string |
ビデオのビットレート。 |
1000 |
| Duration |
string |
ビデオの長さ。 |
55 |
| FileFormat |
string |
ビデオのフォーマット。 |
QuickTime / MOV |
| FileSize |
string |
ファイルのサイズ。 |
3509895 |
| Format |
object |
フォーマット情報。 |
|
| Bitrate |
string |
合計ビットレート。 |
1000 |
| Duration |
string |
合計時間。 |
55 |
| FormatLongName |
string |
コンテナフォーマットのフルネーム。 |
QuickTime / MOV |
| FormatName |
string |
コンテナフォーマットの短縮名。有効値:mov、mp4、m4a、3gp、3g2、mj2。 |
mov |
| NumPrograms |
string |
プログラムストリームの総数。 |
0 |
| NumStreams |
string |
メディアストリームの総数。 |
2 |
| Size |
string |
ファイルのサイズ。 |
3509895 |
| StartTime |
string |
開始時刻。 |
0.000000 |
| Fps |
string |
ビデオのフレームレート。値は数値です。 |
25 |
| Height |
string |
ビデオの高さ。 |
720 |
| Streams |
object |
ストリーム情報。 |
|
| AudioStreamList |
object |
||
| AudioStream |
array<object> |
オーディオストリーム。 |
|
|
object |
|||
| Bitrate |
string |
オーディオストリームのビットレート。 |
128.806 |
| ChannelLayout |
string |
サウンドチャンネルの出力レイアウト。 |
stereo |
| Channels |
string |
サウンドチャンネルの数。 |
2 |
| CodecLongName |
string |
コーデックのフルネーム。 |
AAC (Advanced Audio Coding) |
| CodecName |
string |
コーデックの短縮名。 |
aac |
| CodecTag |
string |
コーデックのタグ。 |
0x6134706d |
| CodecTagString |
string |
コーデックのタグ文字列。 |
mp4a |
| CodecTimeBase |
string |
コーデックタイムベース。 |
1/44100 |
| Duration |
string |
オーディオストリームの長さ。 |
17.159546 |
| Index |
string |
オーディオストリームのシーケンス番号。この値は、すべてのオーディオストリームにおけるオーディオストリームの位置を示します。 |
1 |
| Lang |
string |
オーディオストリームの言語。詳細については、FFmpeg ドキュメントおよび ISO 639 をご参照ください。 |
eng |
| NumFrames |
string |
フレームの総数。 |
25 |
| SampleFmt |
string |
サンプリングフォーマット。 |
fltp |
| Samplerate |
string |
オーディオストリームのサンプリングレート。 |
44100 |
| StartTime |
string |
オーディオストリームの開始時刻。 |
0.000000 |
| Timebase |
string |
オーディオストリームのタイムベース。 |
1/44100 |
| SubtitleStreamList |
object |
||
| SubtitleStream |
array<object> |
字幕ストリーム。 |
|
|
object |
|||
| Index |
string |
字幕ストリームのシーケンス番号。この値は、すべての字幕ストリームにおける字幕ストリームの位置を示します。 |
1 |
| Lang |
string |
字幕ストリームの言語。詳細については、FFmpeg ドキュメントおよび ISO 639 をご参照ください。 |
eng |
| VideoStreamList |
object |
||
| VideoStream |
array<object> |
ビデオストリーム。 |
|
|
array<object> |
|||
| AvgFPS |
string |
ビデオストリームの平均フレームレート。 |
23.976025 |
| Bitrate |
string |
ビデオストリームのビットレート。 |
1496.46 |
| CodecLongName |
string |
コーデックのフルネーム。 |
H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 |
| CodecName |
string |
コーデックの短縮名。 |
h264 |
| CodecTag |
string |
コーデックのタグ。 |
0x31637661 |
| CodecTagString |
string |
コーデックのタグ文字列。 |
avc1 |
| CodecTimeBase |
string |
コーデックタイムベース。 |
1001/48000 |
| Dar |
string |
ビデオストリームの表示アスペクト比 (DAR)。 |
16:9 |
| Duration |
string |
ビデオストリームの長さ。 |
17.225542 |
| Fps |
string |
ビデオストリームのフレームレート。 |
23.976025 |
| HasBFrames |
string |
ビデオストリームに B フレームが含まれているかどうかを示します。 |
2 |
| Height |
string |
ビデオストリームの高さ(ピクセル単位)。 |
720 |
| Index |
string |
ビデオストリームのシーケンス番号。この値は、すべてのビデオストリームにおけるビデオストリームの位置を示します。 |
0 |
| Lang |
string |
ビデオストリームの言語。詳細については、FFmpeg ドキュメントおよび ISO 639 をご参照ください。 |
eng |
| Level |
string |
コーデックレベル。 |
51 |
| NetworkCost |
object |
消費されたネットワーク帯域幅。 |
|
| AvgBitrate |
string |
ビデオストリームの平均ビットレート。 |
100 |
| CostBandwidth |
string |
消費された最大帯域幅。 |
10 |
| PreloadTime |
string |
ビデオストリームのプリロードにかかる時間。 |
8 |
| NumFrames |
string |
フレームの総数。 |
25 |
| PixFmt |
string |
ビデオストリームのピクセルフォーマット。 |
yuv420p |
| Profile |
string |
コーデックプロファイル。 |
high |
| Sar |
string |
ビデオストリームのサンプルアスペクト比 (SAR)。 |
1:1 |
| StartTime |
string |
ビデオストリームの開始時刻。 |
0.000000 |
| Timebase |
string |
ビデオストリームのタイムベース。 |
1/24000 |
| Width |
string |
ビデオストリームの幅(ピクセル単位)。 |
1280 |
| Width |
string |
ビデオの幅。 |
1280 |
| Rotate |
string |
ビデオの回転角度(時計回り)。 |
180 |
| SubtitleConfig |
object |
字幕設定。 |
|
| ExtSubtitleList |
object |
||
| ExtSubtitle |
array<object> |
外部字幕。値は最大 4 個のオブジェクトを含む JSON 配列です。 |
|
|
array<object> |
|||
| CharEnc |
string |
外部字幕で使用される文字セット。
説明
このパラメーターを auto に設定した場合、検出された文字セットが実際の文字セットと異なる可能性があります。他の値に設定することを推奨します。 |
UTF-8 |
| FontName |
string |
外部字幕から変換されたハードコード字幕のフォント。デフォルト値:SimSun。詳細については、「フォント」をご参照ください。 |
"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" |
| Input |
object |
外部字幕として使用される OSS オブジェクト。値は JSON オブジェクトです。SRT または ASS 形式のファイルがサポートされます。 |
|
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket-**** |
| Location |
string |
入力ファイルが格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
入力ファイルとして使用される OSS オブジェクトの名前。 |
example-output.flv |
| SubtitleList |
object |
||
| Subtitle |
array<object> |
字幕。 |
|
|
object |
|||
| Map |
string |
オーディオトラック。フォーマット: |
0:a:0 |
| SuperReso |
object |
ソースビデオの解像度を使用するための設定。 |
|
| IsHalfSample |
string |
サンプリングレートに関連するパラメーターが取得されるかどうかを示します。有効値:
|
true |
| TailSlateList |
object |
||
| TailSlate |
array<object> |
エンディングパート。値は JSON オブジェクトです。 |
|
|
object |
|||
| BgColor |
string |
エンディングパートのサイズがメインパートより小さい場合に追加されるバーの色。デフォルト値:White。詳細については、「背景色」をご参照ください。 |
White |
| BlendDuration |
string |
メインパートとエンディングパート間のトランジションの持続時間。フェードトランジションが使用されます:メインパートの最終フレームがフェードアウトし、エンディングパートの最初のフレームがフェードインします。単位:秒。デフォルト値:0。 |
2 |
| Height |
string |
エンディングパートの高さ。
|
1080 |
| IsMergeAudio |
boolean |
エンディングパートの音声コンテンツをマージするかどうかを示します。有効値:
|
false |
| Start |
string |
開始時刻。 |
1 |
| TailUrl |
string |
エンディングパートの OSS URL。 |
http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv |
| Width |
string |
エンディングパートの幅。
|
1920 |
| TemplateId |
string |
トランスコーディングテンプレートの ID。 |
S00000000-000010 |
| TransConfig |
object |
一般トランスコーディング設定。 説明
このパラメーターがリクエストで指定された場合、指定されたトランスコーディングテンプレート内の対応するパラメーターは上書きされます。 |
|
| AdjDarMethod |
string |
解像度調整方法。デフォルト値:none。有効値:
|
crop |
| IsCheckAudioBitrate |
string |
オーディオビットレートをチェックするかどうかを示します。出力オーディオのビットレートが入力オーディオのビットレートより高い場合、入力ビットレートが保持され、指定されたオーディオビットレートは適用されません。このパラメーターは IsCheckAudioBitrateFail よりも優先度が低くなります。有効値:
|
false |
| IsCheckAudioBitrateFail |
string |
オーディオビットレートをチェックするかどうかを示します。このパラメーターは IsCheckAudioBitrate よりも優先度が高くなります。出力オーディオのビットレートが入力オーディオのビットレートより高い場合、オーディオのトランスコードを行わずにトランスコーディング失敗が返されます。有効値:
|
true |
| IsCheckReso |
string |
解像度をチェックするかどうかを示します。幅または高さに基づいて出力解像度が入力解像度より高い場合、入力解像度が保持されます。有効値:
|
false |
| IsCheckResoFail |
string |
解像度をチェックするかどうかを示します。このパラメーターは IsCheckReso よりも優先度が高くなります。幅または高さに基づいて出力解像度が入力解像度より高い場合、ビデオのトランスコードを行わずにトランスコーディング失敗が返されます。有効値:
|
false |
| IsCheckVideoBitrate |
string |
ビデオビットレートをチェックするかどうかを示します。出力ビデオのビットレートが入力ビデオのビットレートより高い場合、入力ビットレートが保持されます。有効値:
|
false |
| IsCheckVideoBitrateFail |
string |
ビデオビットレートをチェックするかどうかを示します。出力ビデオのビットレートが入力ビデオのビットレートより高い場合、ビデオのトランスコードを行わずにトランスコーディング失敗が返されます。このパラメーターはIsCheckVideoBitrate よりも優先度が高くなります。有効値:
|
true |
| TransMode |
string |
トランスコーディングモード。有効値:
|
onepass |
| UserData |
string |
カスタムデータ。 |
example data |
| Video |
object |
ビデオ設定。 説明
このパラメーターが指定された場合、TemplateId で指定されたテンプレート内の AliyunVideoCodec は上書きされます。 |
|
| Bitrate |
string |
出力ビデオのビットレート。単位:Kbit/s。 |
10 |
| BitrateBnd |
object |
ビデオの平均ビットレート範囲。 |
|
| Max |
string |
合計ビットレートの上限。単位:Kbit/s。 |
20 |
| Min |
string |
合計ビットレートの下限。単位:Kbit/s。 |
10 |
| Bufsize |
string |
バッファーのサイズ。
|
1000 |
| Codec |
string |
ビデオコーデック。
|
H.264 |
| Crf |
string |
定数レートファクター。
|
22 |
| Crop |
string |
ビデオのトリミング方法。有効値:
|
1280:800:0:140 |
| Degrain |
string |
独立したノイズ除去アルゴリズムの強度。 |
5 |
| Fps |
string |
フレームレート。
|
60 |
| Gop |
string |
キーフレーム間の最大間隔、またはフレームグループ内の最大フレーム数。単位:秒。
|
1 |
| Height |
string |
ビデオの高さ。
|
1280 |
| MaxFps |
string |
最大フレームレート。 |
15 |
| Maxrate |
string |
ビデオの最大ビットレート。単位:Kbit/s。 |
10 |
| Pad |
string |
ビデオに追加される黒い罫線。
|
1280:800:0:140 |
| PixFmt |
string |
ビデオのピクセルフォーマット。
|
yuvj420p |
| Preset |
string |
プリセットビデオアルゴリズム。デフォルト値:medium。有効値:
|
veryfast |
| Profile |
string |
エンコードプロファイル。このパラメーターは H.264 コーデックでのみ返されます。デフォルト値:high。有効値: 説明
複数の定義が関与する場合、低解像度デバイスでの正常な再生を保証するために最低定義には baseline を使用し、その他の定義には main または high を使用することを推奨します。
|
baseline |
| Qscale |
string |
ビデオの品質管理レベル。 |
15 |
| ResoPriority |
string |
リソースの優先度。 |
1 |
| ScanMode |
string |
スキャンモード。有効値:
ベストプラクティス:インターレーススキャンはプログレッシブスキャンよりも帯域幅を消費しませんが、画質は劣ります。そのため、主流のビデオ制作ではプログレッシブスキャンが使用されます。
|
interlaced |
| Width |
string |
ビデオの幅。
|
1080 |
| VideoStreamMap |
string |
ビデオストリームのシーケンス番号。
|
0:a:0 |
| WaterMarkConfigUrl |
string |
ウォーターマーク設定ファイルの URL。 |
http://example.com/configure |
| WaterMarkList |
object |
||
| WaterMark |
array<object> |
ウォーターマーク。 説明
ウォーターマークが切り捨てられたり、生成に失敗したりした場合は、追加したテキストウォーターマークに特殊文字が含まれていないかを確認してください。テキストウォーターマークに特殊文字が含まれている場合、ウォーターマークを追加する前に特殊文字をエスケープする必要があります。または、互換性処理のために Alibaba Cloud カスタマーサポートに連絡するには、「チケットを送信」してください。 |
|
|
array<object> |
|||
| Dx |
string |
ウォーターマーク画像の出力ビデオに対する水平オフセット。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。デフォルト値:0。値は整数または小数です。
|
1 |
| Dy |
string |
ウォーターマーク画像の出力ビデオに対する垂直オフセット。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。値は整数または小数です。
|
1 |
| Height |
string |
ウォーターマークの高さ。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。値は整数または小数です。
|
1280 |
| InputFile |
object |
ウォーターマーク入力ファイル。PNG イメージおよび MOV ファイルがサポートされています。 |
|
| Bucket |
string |
入力ファイルが格納されている OSS バケットの名前。 |
example-bucket |
| Location |
string |
入力ファイルが格納されている OSS リージョンの ID。 |
oss-cn-hangzhou |
| Object |
string |
入力ファイルとして使用される OSS オブジェクトの名前。 |
example-logo-****.png |
| ReferPos |
string |
ウォーターマークの位置。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。有効値:
|
TopRight |
| Type |
string |
ウォーターマークのタイプ。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。詳細については、「パラメーターの詳細」をご参照ください。有効値:
|
Image |
| WaterMarkTemplateId |
string |
ウォーターマークテンプレートの ID。 |
88c6ca184c0e47098a5b665e2a12**** |
| Width |
string |
ウォーターマーク画像の幅。このパラメーターがリクエストで指定された場合、ウォーターマークテンプレート内の対応するパラメーターは上書きされます。値は整数または小数です。
|
1080 |
| Percent |
integer |
トランスコーディングの進行状況。 |
100 |
| PipelineId |
string |
MPS キューの ID。 |
88c6ca184c0e47098a5b665e2a126797 |
| State |
string |
ジョブの状態。有効値:
|
Submitted |
| Message |
string |
ジョブの作成に失敗した場合に返されるエラーメッセージ。ジョブが作成された場合、このパラメーターは返されません。 |
The specified parameter "%s" cannot be null. |
| Success |
boolean |
ジョブが成功したかどうかを示します。有効値:
|
true |
| RequestId |
string |
リクエスト ID。 |
25818875-5F78-4A45S71F6-D73936451234 |
例
成功レスポンス
JSONJSON
{
"JobResultList": {
"JobResult": [
{
"Code": "InvalidParameter.NullValue",
"Job": {
"Code": "InternalError",
"CreationTime": "2014-01-10T12:00:00Z",
"FinishTime": "2014-01-10T12:20:00Z",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example.flv"
},
"JobId": "31fa3c9ca8134f9cec2b4b0b0f78****",
"MNSMessageResult": {
"ErrorCode": "InvalidParameter.ResourceNotFound",
"ErrorMessage": "The resource operated \"%s\" cannot be found.",
"MessageId": "123"
},
"Message": "The operation has failed due to some unknown error, exception or failure.",
"Output": {
"AmixList": {
"Amix": [
{
"AmixURL": "https://outpu***.oss-cn-shanghai.aliyuncs.com/mp4-to-mp3%5E1571025263578816%40.mp3",
"Duration": "20",
"Map": "0:a:0",
"MixDurMode": "long",
"Start": "0"
}
]
},
"Audio": {
"Bitrate": "128",
"Channels": "6",
"Codec": "aac",
"Profile": "aac_low",
"Qscale": "15",
"Samplerate": "32000",
"Volume": {
"Level": "-20",
"Method": "auto"
}
},
"AudioStreamMap": "0:a:0",
"Clip": {
"TimeSpan": {
"Duration": "01:00:59.999",
"Seek": "01:59:59.999"
}
},
"Container": {
"Format": "flv"
},
"DeWatermark": "{\"0\": [{\"l\": 10,\"t\": 10,\"w\": 10,\"h\": 10},{\"l\": 100,\"t\": 0.1,\"w\": 10,\"h\": 10}],\"128000\": [],\"250000\": [{\"l\": 0.2,\"t\": 0.1,\"w\": 0.01,\"h\": 0.05}]}",
"DigiWaterMark": {
"Alpha": "1.0",
"InputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-intput.flv"
},
"Type": "Image"
},
"Encryption": {
"Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
"Key": "encryptionkey128",
"KeyType": "Base64",
"KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
"SkipCnt": "3",
"Type": "hls-aes-128"
},
"M3U8NonStandardSupport": {
"TS": {
"Md5Support": true,
"SizeSupport": true
}
},
"MergeConfigUrl": "`{\"MergeList\":[{\"MergeURL\":\"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4\"}]}",
"MergeList": {
"Merge": [
{
"Duration": "00000.20",
"MergeURL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object-****.flv",
"RoleArn": "acs:ram:::role/",
"Start": "00000.50"
}
]
},
"MuxConfig": {
"Gif": {
"DitherMode": "bayer",
"FinalDelay": "0",
"IsCustomPalette": "false",
"Loop": "0"
},
"Segment": {
"Duration": "20"
},
"Webp": {
"Loop": "0"
}
},
"OpeningList": {
"Opening": [
{
"Height": "1080",
"Start": "1",
"Width": "1920",
"openUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
}
]
},
"OutSubtitleList": {
"OutSubtitle": [
{
"Map": "0:v:0",
"Message": "The specified parameter “%s” cannot be null.",
"OutSubtitleFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Success": true
}
]
},
"OutputFile": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv",
"RoleArn": "acs:ram:::role/"
},
"Priority": "5",
"Properties": {
"Bitrate": "1000",
"Duration": "55",
"FileFormat": "QuickTime / MOV",
"FileSize": "3509895",
"Format": {
"Bitrate": "1000",
"Duration": "55",
"FormatLongName": "QuickTime / MOV",
"FormatName": "mov",
"NumPrograms": "0",
"NumStreams": "2",
"Size": "3509895",
"StartTime": "0.000000"
},
"Fps": "25",
"Height": "720",
"Streams": {
"AudioStreamList": {
"AudioStream": [
{
"Bitrate": "128.806",
"ChannelLayout": "stereo",
"Channels": "2",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecName": "aac",
"CodecTag": "0x6134706d",
"CodecTagString": "mp4a",
"CodecTimeBase": "1/44100",
"Duration": "17.159546",
"Index": "1",
"Lang": "eng",
"NumFrames": "25",
"SampleFmt": "fltp",
"Samplerate": "44100",
"StartTime": "0.000000",
"Timebase": "1/44100"
}
]
},
"SubtitleStreamList": {
"SubtitleStream": [
{
"Index": "1",
"Lang": "eng"
}
]
},
"VideoStreamList": {
"VideoStream": [
{
"AvgFPS": "23.976025",
"Bitrate": "1496.46",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"CodecName": "h264",
"CodecTag": "0x31637661",
"CodecTagString": "avc1",
"CodecTimeBase": "1001/48000",
"Dar": "16:9",
"Duration": "17.225542",
"Fps": "23.976025",
"HasBFrames": "2",
"Height": "720",
"Index": "0",
"Lang": "eng",
"Level": "51",
"NetworkCost": {
"AvgBitrate": "100",
"CostBandwidth": "10",
"PreloadTime": "8"
},
"NumFrames": "25",
"PixFmt": "yuv420p",
"Profile": "high",
"Sar": "1:1",
"StartTime": "0.000000",
"Timebase": "1/24000",
"Width": "1280"
}
]
}
},
"Width": "1280"
},
"Rotate": "180",
"SubtitleConfig": {
"ExtSubtitleList": {
"ExtSubtitle": [
{
"CharEnc": "UTF-8",
"FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input": {
"Bucket": "example-bucket-****",
"Location": "oss-cn-hangzhou",
"Object": "example-output.flv"
}
}
]
},
"SubtitleList": {
"Subtitle": [
{
"Map": "0:a:0"
}
]
}
},
"SuperReso": {
"IsHalfSample": "true"
},
"TailSlateList": {
"TailSlate": [
{
"BgColor": "White",
"BlendDuration": "2",
"Height": "1080",
"IsMergeAudio": false,
"Start": "1",
"TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv",
"Width": "1920"
}
]
},
"TemplateId": "S00000000-000010",
"TransConfig": {
"AdjDarMethod": "crop",
"IsCheckAudioBitrate": "false",
"IsCheckAudioBitrateFail": "true",
"IsCheckReso": "false",
"IsCheckResoFail": "false",
"IsCheckVideoBitrate": "false",
"IsCheckVideoBitrateFail": "true",
"TransMode": "onepass"
},
"UserData": "example data",
"Video": {
"Bitrate": "10",
"BitrateBnd": {
"Max": "20",
"Min": "10"
},
"Bufsize": "1000",
"Codec": "H.264",
"Crf": "22",
"Crop": "1280:800:0:140",
"Degrain": "5",
"Fps": "60",
"Gop": "1",
"Height": "1280",
"MaxFps": "15",
"Maxrate": "10",
"Pad": "1280:800:0:140",
"PixFmt": "yuvj420p",
"Preset": "veryfast",
"Profile": "baseline",
"Qscale": "15",
"ResoPriority": "1",
"ScanMode": "interlaced",
"Width": "1080"
},
"VideoStreamMap": "0:a:0",
"WaterMarkConfigUrl": "http://example.com/configure",
"WaterMarkList": {
"WaterMark": [
{
"Dx": "1",
"Dy": "1",
"Height": "1280",
"InputFile": {
"Bucket": "example-bucket",
"Location": "oss-cn-hangzhou",
"Object": "example-logo-****.png"
},
"ReferPos": "TopRight",
"Type": "Image",
"WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
"Width": "1080"
}
]
}
},
"Percent": 100,
"PipelineId": "88c6ca184c0e47098a5b665e2a126797",
"State": "Submitted"
},
"Message": "The specified parameter \"%s\" cannot be null.",
"Success": true
}
]
},
"RequestId": "25818875-5F78-4A45S71F6-D73936451234"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。