非同期のメディアトランスコーディングタスクを作成します。このタスクは、メディアトランスコーディング、メディア連結、ビデオフレームキャプチャ、およびアニメーション GIF 生成のために、音声ファイルと動画ファイルを処理します。
操作説明
この操作を呼び出す前に、Intelligent Media Management の課金方法と料金について理解していることを確認してください。
- この操作を呼び出す前に、現在のリージョンでプロジェクトが利用可能であることを確認してください。詳細については、「プロジェクト管理」をご参照ください。
重要 非同期タスクの完了時間は保証されません。
この操作をメディアトランスコーディングに使用する場合、デフォルトでは 1 つのビデオストリーム、音声ストリーム、または字幕ストリームのみを処理します。処理するストリーム数を設定することもできます。
この操作をメディア連結に使用する場合、最大 11 個のメディアファイルを指定できます。メディアトランスコーディングやフレームキャプチャなどの操作のパラメーターは、最終的に連結された出力に適用されます。
この操作は非同期です。タスクが開始されると、その情報は 7 日間のみ保持されます。この期間を過ぎると、情報を取得できなくなります。タスク情報を表示するには、返された
TaskIdを使用して GetTask または ListTasks 操作を呼び出します。Notification パラメーターを設定して、メッセージ通知経由でタスク情報を受信することもできます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
imm:CreateMediaConvertTask |
create |
*Project
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectName |
string |
必須 |
プロジェクトの名前。プロジェクト名の取得方法の詳細については、「プロジェクトの作成」をご参照ください。 |
test-project |
| Sources |
array<object> |
必須 |
メディアファイルのリスト。複数のファイルを指定した場合、URI の順序で連結されます。 |
|
|
array<object> |
任意 |
ソースメディアファイル。 |
||
| URI |
string |
任意 |
オブジェクトの OSS URI。URI は |
oss://test-bucket/test-object |
| StartTime |
number |
任意 |
メディアトランスコーディングの開始時間 (秒単位)。有効な値は次のとおりです:
|
0 |
| Duration |
number |
任意 |
メディアトランスコーディングの持続時間 (秒単位)。デフォルト値の 0 は、メディアの最後までトランスコーディングすることを意味します。 |
0 |
| Subtitles |
array<object> |
任意 |
追加する字幕のリスト。 |
|
|
object |
任意 |
字幕の設定。 |
||
| URI |
string |
任意 |
オブジェクトの OSS URI。URI は |
oss://test-bucket/test-object |
| TimeOffset |
number |
任意 |
字幕の遅延時間 (秒単位)。デフォルト値は 0 です。 |
10.5 |
| Language |
string |
任意 |
字幕の言語。値は ISO 639-2 規格に準拠する必要があります。 |
eng |
| Attached |
boolean |
任意 |
true の場合、現在のソースメディアファイルを同期された音声ストリームまたはビデオストリームとして出力に追加します。デフォルトは false です。 説明
|
false |
| AlignMode |
string |
任意 |
追加された音声ストリームとビデオストリームのアライメントモード。有効な値は次のとおりです:
説明
|
false |
| DisableVideo |
boolean |
任意 |
ソースメディアファイルからビデオを無効にするかどうかを指定します。有効な値は次のとおりです:
|
false |
| DisableAudio |
boolean |
任意 |
ソースメディアファイルから音声を無効にするかどうかを指定します。有効な値は次のとおりです:
|
false |
| Targets |
array<object> |
任意 |
メディア処理タスクのリスト。 |
|
|
array<object> |
任意 |
出力メディアファイルの設定。 |
||
| URI |
string |
任意 |
メディアトランスコーディングの出力ファイルの OSS URI。 URI は
|
oss://test-bucket/test-target-object.mp4 |
| Container |
string |
任意 |
メディアコンテナタイプ。有効なコンテナタイプは次のとおりです:
|
mp4 |
| Speed |
number |
任意 |
出力メディアの再生速度。値は 0.5 から 1.0 の範囲 (両端を含む) である必要があります。デフォルト値は 1.0 です。 説明
このパラメーターは、ソースファイルの速度に対する比率として出力ファイルのデフォルトの再生速度を指定します。倍速トランスコーディングは実行しません。 |
1.0 |
| Segment |
object |
任意 |
メディアセグメンテーションの設定。 |
|
| Format |
string |
任意 |
セグメンテーション方式。有効な値は次のとおりです:
|
hls |
| Duration |
number |
任意 |
各セグメントの持続時間 (秒単位)。 |
30 |
| StartNumber |
integer |
任意 |
開始シーケンス番号。このパラメーターは HLS でのみサポートされます。デフォルト値は 0 です。 |
5 |
| Video | TargetVideo |
任意 |
ビデオ処理パラメーター。 重要 このパラメーターを空のままにすると、最初のビデオストリームが存在する場合、出力ファイルに直接コピーされます。 |
|
| Audio | TargetAudio |
任意 |
音声処理パラメーター。 重要 このパラメーターを空のままにすると、最初の音声ストリームが存在する場合、出力ファイルに直接コピーされます。 |
|
| Subtitle | TargetSubtitle |
任意 |
字幕処理パラメーター。 重要 このパラメーターを空のままにすると、最初の字幕ストリームが存在する場合、出力ファイルに直接コピーされます。 |
|
| Image | TargetImage |
任意 |
フレームキャプチャ、スプライト生成、およびアニメーション画像生成のパラメーター。 |
|
| StripMetadata |
boolean |
任意 |
true の場合、メディアファイルから |
|
| Data |
object |
任意 |
データストリームを保持するための設定。 重要 データストリームの保持は、 Container パラメーターが mp4 に設定されている場合にのみサポートされます。 |
|
| Stream |
array |
任意 |
処理するソースファイル内のデータストリームのインデックスのリスト。空のリスト (デフォルト) は、データストリームが保持されないことを示します。インデックス -1 は、すべてのデータストリームが保持されることを示します。
説明
指定されたインデックスが存在するデータストリームに対応しない場合、そのインデックスは無視されます。 |
|
|
integer |
任意 |
処理するデータストリームのインデックス。 |
0 |
|
| AttachedPicture |
object |
任意 |
添付画像を保持するための設定。 重要 添付画像の保持は、 Container パラメーターが mp4 または mkv に設定されている場合にのみサポートされます。 |
|
| Stream |
array |
任意 |
処理するソースファイル内の添付画像のインデックスのリスト。空のリスト (デフォルト) は、添付画像が保持されないことを示します。インデックス -1 は、すべての添付画像が保持されることを示します。
説明
指定されたインデックスが存在する添付画像に対応しない場合、そのインデックスは無視されます。 |
|
|
integer |
任意 |
処理する添付画像のインデックス。 |
0 |
|
| UserData |
string |
任意 |
カスタムユーザーデータ。このデータは非同期通知で返され、通知を内部システムに関連付けることができます。最大長は 2,048 バイトです。 |
{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"} |
| Tags |
object |
任意 |
非同期タスクの検索とフィルタリングのためのカスタムタグ。 |
{"test":"val1"} |
| CredentialConfig | CredentialConfig |
任意 |
特別な要件がない場合は、このパラメーターを空のままにすることができます。 チェーン承認の設定。詳細については、「チェーン承認を使用して他のエンティティのリソースにアクセスする」をご参照ください。 |
|
| Notification | Notification |
任意 |
メッセージ通知の設定。詳細については、Notification をクリックしてください。非同期通知のフォーマットについては、「非同期通知フォーマット」をご参照ください。 |
|
| AlignmentIndex |
integer |
任意 |
メディアファイルを連結する際に、Sources リスト内のプライマリファイルのインデックスを指定します。デフォルトのトランスコーディングパラメーター ( |
0 |
| TargetGroups |
array<object> |
任意 |
入力メディアを HLS 出力に変換してパッケージングするためのメディアパッケージングタスクのリスト。各 TargetGroup は 1 つの HLS マスタープレイリストに対応します。 |
|
|
array<object> |
任意 |
|||
| URI |
string |
任意 |
パッケージングタスクの出力 HLS マスタープレイリストファイルの OSS URI。 |
oss://test-bucket/test-object/master.m3u8 |
| Targets |
array<object> |
任意 |
メディアパッケージングサブタスクのリスト。各 |
|
|
array<object> |
任意 |
|||
| URI |
string |
任意 |
サブタスクの出力 HLS メディアプレイリストファイルの OSS URI。 重要 この URI は TargetGroups.URI と同じディレクトリまたはそのサブディレクトリにある必要があります。 |
oss://test-bucket/test-target-object.mp4 |
| Container |
string |
任意 |
パッケージングコンテナタイプ。 |
mp4 |
| Speed |
number |
任意 |
出力メディアの再生速度。値は 0.5 から 1.0 の範囲 (両端を含む) である必要があります。デフォルト値は 1.0 です。 説明
このパラメーターは、ソースファイルの速度に対する比率として出力ファイルのデフォルトの再生速度を指定します。倍速トランスコーディングは実行しません。 |
1.0 |
| Segment |
object |
任意 |
メディアパッケージングの設定。 |
|
| Format |
string |
任意 |
メディアパッケージングフォーマット。 |
hls |
| Duration |
number |
任意 |
各セグメントの持続時間 (秒単位)。 |
30 |
| StartNumber |
integer |
任意 |
セグメントの開始シーケンス番号。デフォルトは 0 です。 |
5 |
| Video | TargetVideo |
任意 |
ビデオ処理パラメーター。 重要 このパラメーターを空のままにすると、最初のビデオストリームが存在する場合、出力ファイルに直接コピーされます。 |
|
| Audio | TargetAudio |
任意 |
音声処理パラメーター。 重要 このパラメーターを空のままにすると、最初の音声ストリームが存在する場合、出力ファイルに直接コピーされます。 |
|
| Subtitle | TargetSubtitle |
任意 |
字幕処理パラメーター。 重要 字幕ストリームをパッケージングするには、 Subtitle.ExtractSubtitle パラメーターを使用する必要があります。Subtitle.ExtractSubtitle の URI は、TargetGroups.URI と同じディレクトリまたはそのサブディレクトリにある必要があります。Subtitle.ExtractSubtitle の Format は vtt である必要があります。すべての字幕ストリームをパッケージングするには、このパラメーターを 1 つの Target で設定するだけで十分です。 |
|
| StripMetadata |
boolean |
任意 |
true の場合、出力ファイルからメタデータを削除します。デフォルトは false です。 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスボディ。 |
||
| RequestId |
string |
リクエストの ID。 |
CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6 |
| EventId |
string |
イベントの ID。 |
0ED-1Bz8z71k5TtsUejT4UJ16Es**** |
| TaskId |
string |
タスクの ID。 |
MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6",
"EventId": "0ED-1Bz8z71k5TtsUejT4UJ16Es****",
"TaskId": "MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。