すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Management:CreateMediaConvertTask

最終更新日:Jun 03, 2026

非同期のメディアトランスコーディングタスクを作成します。このタスクは、メディアトランスコーディング、メディア連結、ビデオフレームキャプチャ、およびアニメーション GIF 生成のために、音声ファイルと動画ファイルを処理します。

操作説明

  • この操作を呼び出す前に、Intelligent Media Management の課金方法と料金について理解していることを確認してください。

  • この操作を呼び出す前に、現在のリージョンでプロジェクトが利用可能であることを確認してください。詳細については、「プロジェクト管理」をご参照ください。
    重要 非同期タスクの完了時間は保証されません。
  • この操作をメディアトランスコーディングに使用する場合、デフォルトでは 1 つのビデオストリーム、音声ストリーム、または字幕ストリームのみを処理します。処理するストリーム数を設定することもできます。

  • この操作をメディア連結に使用する場合、最大 11 個のメディアファイルを指定できます。メディアトランスコーディングやフレームキャプチャなどの操作のパラメーターは、最終的に連結された出力に適用されます。

  • この操作は非同期です。タスクが開始されると、その情報は 7 日間のみ保持されます。この期間を過ぎると、情報を取得できなくなります。タスク情報を表示するには、返された TaskId を使用して GetTask または ListTasks 操作を呼び出します。Notification パラメーターを設定して、メッセージ通知経由でタスク情報を受信することもできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

imm:CreateMediaConvertTask

create

*Project

acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ProjectName

string

必須

プロジェクトの名前。プロジェクト名の取得方法の詳細については、「プロジェクトの作成」をご参照ください。

test-project

Sources

array<object>

必須

メディアファイルのリスト。複数のファイルを指定した場合、URI の順序で連結されます。

array<object>

任意

ソースメディアファイル。

URI

string

任意

オブジェクトの OSS URI。URI は oss://${Bucket}/${Object} 形式を使用する必要があります。${Bucket} はプロジェクトと同じリージョンにある OSS バケットの名前で、${Object} はファイル拡張子を含むオブジェクトのフルパスです。

oss://test-bucket/test-object

StartTime

number

任意

メディアトランスコーディングの開始時間 (秒単位)。有効な値は次のとおりです:

  • 0 (デフォルト):メディアファイルの先頭からトランスコーディングを開始します。

  • n (0 より大きい値):メディアファイルの n 秒目からトランスコーディングを開始します。

0

Duration

number

任意

メディアトランスコーディングの持続時間 (秒単位)。デフォルト値の 0 は、メディアの最後までトランスコーディングすることを意味します。

0

Subtitles

array<object>

任意

追加する字幕のリスト。

object

任意

字幕の設定。

URI

string

任意

オブジェクトの OSS URI。URI は oss://${Bucket}/${Object} 形式を使用する必要があります。${Bucket} はプロジェクトと同じリージョンにある OSS バケットの名前で、${Object} はファイル拡張子を含むオブジェクトのフルパスです。 サポートされている字幕フォーマットには、srt、vtt、mov_text、ass、dvd_sub、pgs があります。

oss://test-bucket/test-object

TimeOffset

number

任意

字幕の遅延時間 (秒単位)。デフォルト値は 0 です。

10.5

Language

string

任意

字幕の言語。値は ISO 639-2 規格に準拠する必要があります。

eng

Attached

boolean

任意

true の場合、現在のソースメディアファイルを同期された音声ストリームまたはビデオストリームとして出力に追加します。デフォルトは false です。

説明
  • AlignmentIndex によって参照されるソースメディアファイルに対して Attached を true に設定することはできません。

false

AlignMode

string

任意

追加された音声ストリームとビデオストリームのアライメントモード。有効な値は次のとおりです:

  • false (デフォルト):アライメントは実行されません。

  • loop:音声またはビデオをループさせることでコンテンツを配置します。

  • pad:無音フレームまたは黒フレームでパディングすることでコンテンツを配置します。

説明
  • このパラメーターは、Attached が true に設定されている場合にのみ有効です。

false

DisableVideo

boolean

任意

ソースメディアファイルからビデオを無効にするかどうかを指定します。有効な値は次のとおりです:

  • true:ビデオを無効にします。

  • false (デフォルト):ビデオを含めます。

false

DisableAudio

boolean

任意

ソースメディアファイルから音声を無効にするかどうかを指定します。有効な値は次のとおりです:

  • true:音声を無効にします。

  • false (デフォルト):音声を含めます。

false

Targets

array<object>

任意

メディア処理タスクのリスト。

array<object>

任意

出力メディアファイルの設定。

URI

string

任意

メディアトランスコーディングの出力ファイルの OSS URI。

URI は oss://${Bucket}/${Object} 形式である必要があります。この形式では、${Bucket} は OSS バケットの名前で、プロジェクトと同じリージョンにある必要があります。${Object} はファイル拡張子を含むオブジェクトのフルパスです。

  • URI にファイル拡張子がある場合、すべての出力メディアファイルはこの URI に保存されます。複数のファイルが生成された場合、互いに上書きされます。

  • URI にファイル拡張子がない場合、最終的な出力 URI は URIContainer、および Segment パラメーターに基づいて生成されます。たとえば、URIoss://examplebucket/outputVideo の場合:
    • Containermp4Segment が空の場合、生成されるメディアファイルの OSS URI は oss://examplebucket/outputVideo.mp4 です。

    • ContainertsSegmentFormathls の場合、プロセスは OSS URI が oss://examplebucket/outputVideo.m3u8 の m3u8 ファイルと、プレフィックスが oss://examplebucket/outputVideo の複数の TS ファイルを生成します。

oss://test-bucket/test-target-object.mp4

Container

string

任意

メディアコンテナタイプ。有効なコンテナタイプは次のとおりです:

  • 音声/ビデオコンテナ:mp4、mkv、mov、asf、avi、mxf、ts、flv

  • 音声のみのコンテナ:mp3、aac、flac、oga、ac3、opus
    重要 ContainerURI パラメーターは一緒に設定する必要があります。字幕抽出、フレームキャプチャ、スプライト生成、またはアニメーション画像生成のみを実行する場合は、ContainerURI の両方を空のままにします。この場合、SegmentVideoAudioSpeed などのパラメーターは無視されます。

mp4

Speed

number

任意

出力メディアの再生速度。値は 0.5 から 1.0 の範囲 (両端を含む) である必要があります。デフォルト値は 1.0 です。

説明

このパラメーターは、ソースファイルの速度に対する比率として出力ファイルのデフォルトの再生速度を指定します。倍速トランスコーディングは実行しません。

1.0

Segment

object

任意

メディアセグメンテーションの設定。

Format

string

任意

セグメンテーション方式。有効な値は次のとおりです:

  • hls

  • dash

hls

Duration

number

任意

各セグメントの持続時間 (秒単位)。

30

StartNumber

integer

任意

開始シーケンス番号。このパラメーターは HLS でのみサポートされます。デフォルト値は 0 です。

5

Video TargetVideo

任意

ビデオ処理パラメーター。

重要 このパラメーターを空のままにすると、最初のビデオストリームが存在する場合、出力ファイルに直接コピーされます。

Audio TargetAudio

任意

音声処理パラメーター。

重要 このパラメーターを空のままにすると、最初の音声ストリームが存在する場合、出力ファイルに直接コピーされます。

Subtitle TargetSubtitle

任意

字幕処理パラメーター。

重要 このパラメーターを空のままにすると、最初の字幕ストリームが存在する場合、出力ファイルに直接コピーされます。

Image TargetImage

任意

フレームキャプチャ、スプライト生成、およびアニメーション画像生成のパラメーター。

StripMetadata

boolean

任意

true の場合、メディアファイルから titlealbum などのメタデータを削除します。デフォルトは false です。

Data

object

任意

データストリームを保持するための設定。

重要 データストリームの保持は、Container パラメーターが mp4 に設定されている場合にのみサポートされます。

Stream

array

任意

処理するソースファイル内のデータストリームのインデックスのリスト。空のリスト (デフォルト) は、データストリームが保持されないことを示します。インデックス -1 は、すべてのデータストリームが保持されることを示します。

  • 例:[0,1] はインデックス 0 と 1 のデータストリームを処理します。[1] はインデックス 1 のデータストリームを処理します。[-1] はすべてのデータストリームを処理します。

説明

指定されたインデックスが存在するデータストリームに対応しない場合、そのインデックスは無視されます。

integer

任意

処理するデータストリームのインデックス。

0

AttachedPicture

object

任意

添付画像を保持するための設定。

重要 添付画像の保持は、Container パラメーターが mp4 または mkv に設定されている場合にのみサポートされます。

Stream

array

任意

処理するソースファイル内の添付画像のインデックスのリスト。空のリスト (デフォルト) は、添付画像が保持されないことを示します。インデックス -1 は、すべての添付画像が保持されることを示します。

  • 例:[0,1] はインデックス 0 と 1 の添付画像を処理します。[1] はインデックス 1 の添付画像を処理します。[-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 リスト内のプライマリファイルのインデックスを指定します。デフォルトのトランスコーディングパラメーター (Video および Audio オブジェクトからの解像度やフレームレートなど) は、このプライマリファイルから取得されます。デフォルトのインデックスは 0 です。

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>

任意

メディアパッケージングサブタスクのリスト。各 Target は、HLS マスタープレイリスト内のバリアントストリーム (#EXT-X-STREAM-INF) に対応し、対応する HLS メディアプレイリストを生成します。

array<object>

任意

URI

string

任意

サブタスクの出力 HLS メディアプレイリストファイルの OSS URI。

重要 この URI は TargetGroups.URI と同じディレクトリまたはそのサブディレクトリにある必要があります。

oss://test-bucket/test-target-object.mp4

Container

string

任意

パッケージングコンテナタイプ。mp4ts のみがサポートされています。

mp4

Speed

number

任意

出力メディアの再生速度。値は 0.5 から 1.0 の範囲 (両端を含む) である必要があります。デフォルト値は 1.0 です。

説明

このパラメーターは、ソースファイルの速度に対する比率として出力ファイルのデフォルトの再生速度を指定します。倍速トランスコーディングは実行しません。

1.0

Segment

object

任意

メディアパッケージングの設定。

Format

string

任意

メディアパッケージングフォーマット。hls のみがサポートされています。

hls

Duration

number

任意

各セグメントの持続時間 (秒単位)。

30

StartNumber

integer

任意

セグメントの開始シーケンス番号。デフォルトは 0 です。

5

Video TargetVideo

任意

ビデオ処理パラメーター。

重要 このパラメーターを空のままにすると、最初のビデオストリームが存在する場合、出力ファイルに直接コピーされます。

Audio TargetAudio

任意

音声処理パラメーター。

重要 このパラメーターを空のままにすると、最初の音声ストリームが存在する場合、出力ファイルに直接コピーされます。

Subtitle TargetSubtitle

任意

字幕処理パラメーター。

重要 字幕ストリームをパッケージングするには、Subtitle.ExtractSubtitle パラメーターを使用する必要があります。Subtitle.ExtractSubtitleURI は、TargetGroups.URI と同じディレクトリまたはそのサブディレクトリにある必要があります。Subtitle.ExtractSubtitleFormatvtt である必要があります。すべての字幕ストリームをパッケージングするには、このパラメーターを 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****"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。