Intelligent Media Services:SubmitMediaProducingJob

• 課金：ビデオ編集は、出力ビデオのデュレーションに基づいて課金されます。詳細については、「ビデオ編集」をご参照ください。失敗したジョブには課金されません。

• 柔軟な編集機能：この操作を使用して、アセットを配置およびデザインします。柔軟な タイムライン 構成により、複雑なビデオ編集をサポートします。

• アセット参照ルール：タイムラインで参照されるアセットは、アセットライブラリのメディアアセットまたは OSS オブジェクトにすることができます。外部 URL および CDN URL はサポートされていません。アセットが OSS オブジェクトの場合、MediaUrl は OSS URL である必要があります。例：https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext。

• 非同期ジョブの実行：この操作は 非同期タスク を作成します。ジョブを送信すると、操作はタスク ID を返し、ジョブをバックグラウンド処理のためにキューに入れます。この段階では、ジョブはまだ完了していません。システムは、コールバック通知を介して最終結果を配信します。また、「編集・合成ジョブのクエリ」によってジョブステータスをクエリすることもできます。

• ジョブステータスのクエリ：

  1. 編集・合成ジョブのクエリ を呼び出し、JobId を渡してジョブのステータスと結果をクエリします。

  2. 編集・合成ジョブを送信する際に、リクエストの UserData パラメーターにコールバック URL を含めることができます。ジョブが完了または失敗すると、システムはこのコールバック URL に通知を送信します。コールバックデータを使用して、ジョブのステータスを取得できます。

• メディアアセットの登録と分析：ビデオ合成が完了すると、システムは新しいメディアアセットを自動的に登録します。このアセットは、最初は分析中の状態です。分析が完了した後、MediaId を使用して出力ビデオのデュレーションと解像度を取得できます。

制限事項

• この操作のスロットリング制限は 30 QPS です。送信されたジョブはキューに入れられ、非同期で処理されます。

  説明

  この制限を超えると、「Throttling.User」エラーが発生する可能性があります。詳細については、「編集ジョブ送信時の「Throttling.User」エラー」をご参照ください。

• 大量のジョブ (例：1,000 件または 10,000 件) を送信すると、システムは自動的にスケールアウトしますが、キューイングの遅延が発生する場合があります。

• トラックの最大数は、ビデオ、イメージ、字幕の各タイプで 100 です。

• アセット数に制限はありませんが、合計サイズは 1 TB を超えてはなりません。

• 入力または出力 OSS バケットのリージョンは、IMS リージョンと一致する必要があります。

• 出力がビデオの場合、次の解像度制限が適用されます：

  • 幅と高さの両方が 128 px 以上である必要があります。

  • 幅も高さも 4096 px を超えることはできません。

  • 短辺は 2160 px を超えることはできません。

OutputMediaConfig パラメーターの例

例：OSS への出力

{
  "MediaURL":"https://my-test-bucket.oss-cn-shanghai.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

OSS に出力する場合、MediaURL パラメーターは必須です。OutputMediaTarget パラメーターはデフォルトで oss-object になり、出力は OSS に送信されます。他のパラメーターはオプションです。bitrate パラメーターは、出力ファイルのビットレートを設定します。ビットレートが高いほど通常は品質が向上し、最大値は 5000 Kbps です。width と height パラメーターは、出力ファイルの解像度を設定します。

OSS URL のフォーマットは次のとおりです：https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname は、ご利用の OSS バケットの名前です。

oss-region-name.aliyuncs.com は、OSS ファイルのパブリックエンドポイントです。たとえば、中国 (上海)、中国 (北京)、および中国 (杭州) リージョンのパブリックエンドポイントは次のとおりです：

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

例：ApsaraVideo VOD への出力

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

ApsaraVideo VOD に出力する場合、storageLocation と FileName パラメーターは必須です。OutputMediaTarget パラメーターを vod-media に設定して、出力を ApsaraVideo VOD ストレージバケットに送信します。利用可能なストレージロケーションを見つけるには、ApsaraVideo VOD コンソールでアップロードされたメディアアセットのストレージロケーションを表示します。

OutputMediaConfig のパラメーター