CreateMediaConvertTask - - Alibaba Cloud ドキュメントセンター

非同期のメディアトランスコードタスクを作成します。このタスクは、オーディオファイルとビデオファイルを処理します。メディアトランスコード、メディア連結、ビデオスナップショット、およびビデオのアニメーション画像への変換をサポートします。

操作説明

この操作を呼び出す前に、Intelligent Media Management (IMM) の課金方法と料金を理解してください。
この操作を呼び出す前に、現在のリージョンにアクティブなプロジェクトが存在することを確認してください。詳細については、「プロジェクトの管理」をご参照ください。
重要非同期タスクの実行時間は保証されません。
この操作をメディアトランスコードに使用する場合、デフォルトではビデオ、オーディオ、または字幕ストリームが 1 つだけ処理されます。処理するビデオ、オーディオ、および字幕ストリームの数を設定できます。
この操作をメディア連結に使用する場合、最大 11 個のメディアファイルを連結できます。トランスコードとスナップショットに設定したパラメーターは、連結されたメディアデータに適用されます。
本操作は非同期操作です。タスクが開始されると、その情報は 7 日間のみ保存されます。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	任意	ファイルの Object Storage Service (OSS) URI。フォーマットは `oss://${Bucket}/${Object}` です。`${Bucket}` は、現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Object}` は、ファイル拡張子を含むファイルの完全なパスです。	oss://test-bucket/test-object
StartTime	number	任意	トランスコードの開始時刻 (秒単位)。有効な値は次のとおりです： 0 (デフォルト)：メディアファイルの先頭からトランスコードを開始します。 0 より大きい数値：メディアファイルの先頭から n 秒後にトランスコードを開始します。	0
Duration	number	任意	トランスコードの期間 (秒単位)。デフォルト値は 0 で、ビデオの最後までトランスコードされることを意味します。	0
Subtitles	array<object>	任意	追加する字幕のリスト。デフォルトでは空です。
	object	任意	字幕情報。
URI	string	任意	ファイルの OSS 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	任意	現在のソースメディアファイルを、同期再生用のオーディオまたはビデオストリームとして出力メディアファイルに追加するかどうかを指定します。デフォルト値は 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>	任意	Targets 配列内の要素の詳細。
URI	string	任意	トランスコードされた出力ファイルの OSS URI。フォーマットは `oss://${Bucket}/${Object}` です。`${Bucket}` は、現在のプロジェクトと同じリージョンにある OSS バケットの名前です。`${Object}` は、ファイル拡張子を含むファイルの完全なパスです。 URI にファイル拡張子が含まれている場合、出力メディアファイルの OSS URI は URI の値になります。複数のファイルが生成される場合、上書きされる可能性があります。 URI にファイル拡張子が含まれていない場合、出力メディアファイルの OSS URI は URI、Container、および Segment パラメーターによって決定されます。たとえば、URI が `oss://examplebucket/outputVideo` の場合： Container が `mp4` で Segment が空の場合、生成されるメディアファイルの OSS URI は `oss://examplebucket/outputVideo.mp4` です。 Container が `ts` で Segment の Format が `hls` の場合、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 重要 `Container` と `URI` パラメーターを同時に設定してください。字幕抽出、ビデオスナップショット生成、スプライト生成、またはビデオからアニメーション画像への変換のみを実行する場合は、`Container` と `URI` の両方を空のままにしてください。この場合、`Segment`、`Video`、`Audio`、および `Speed` パラメーターは無効です。	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	任意	ビデオ処理パラメーターの設定。重要 `Video` が空の場合、最初のビデオストリーム (存在する場合) は出力ファイルに直接コピーされます。
Audio	TargetAudio	任意	オーディオ処理パラメーターの設定。重要 `Audio` が空の場合、最初のオーディオストリーム (存在する場合) は出力ファイルに直接コピーされます。
Subtitle	TargetSubtitle	任意	字幕処理パラメーターの設定。重要 `Subtitle` が空の場合、最初の字幕ストリーム (存在する場合) は出力ファイルに直接コピーされます。
Image	TargetImage	任意	ビデオスナップショット、スプライト、およびビデオからアニメーション画像への変換のパラメーター設定。
StripMetadata	boolean	任意	メディアファイルのメタデータ (`title` や `album` など) を削除するかどうかを指定します。デフォルト値は false です。
UserData	string	任意	カスタムユーザーデータ。このデータは非同期通知で返され、通知を内部システムに関連付けるのに役立ちます。最大長は 2,048 バイトです。	{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tags	object	任意	非同期タスクを検索およびフィルタリングするためのカスタムタグ。	{"test":"val1"}
CredentialConfig	CredentialConfig	任意	特別な要件がない場合は、このパラメーターを空のままにしてください。チェーン承認の設定。詳細については、「チェーン承認を使用して他のエンティティのリソースにアクセスする」をご参照ください。
Notification	Notification	任意	メッセージ通知の設定。非同期通知のフォーマットの詳細については、「非同期通知メッセージフォーマット」をご参照ください。
AlignmentIndex	integer	任意	メディア連結の場合、このパラメーターはソースリスト内のプライマリメディアファイルのインデックスを指定します。プライマリファイルは、`Video` および `Audio` の解像度やフレームレートなどのデフォルトのトランスコードパラメーターを提供します。デフォルト値は 0 で、リストの最初のメディアファイルに対応します。	0

レスポンスフィールド

フィールド	型	説明	例
	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****"
}

エラーコード

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

変更履歴

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