Intelligent Media Services:SubmitMediaProducingJob

• 課金: ビデオクリップ編集は、生成された動画の持続時間に基づいて課金されます。詳細については、「ビデオクリップ」をご参照ください。失敗したタスクには料金が発生しません。

• 多様な編集機能: クリエイティブなアイデアに基づいて素材を配置・デザインする必要がある場合に、この操作を呼び出します。この操作は柔軟な タイムライン構成 をサポートしており、複雑なビデオクリップ編集要件に対応できます。

• 素材リファレンスルール: クラウド編集タイムラインでリファレンスされる素材は、メディア ライブラリ内のメディアアセットまたは OSS ファイルです。外部 URL や CDN URL はサポートされていません。素材が OSS ファイルの場合、MediaUrl は OSS URL フォーマット（例: https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext）のみをサポートします。

• 非同期タスク実行: この操作は非同期タスクです。タスクをコミットすると、タスク ID が返されます（タスクはまだ完了しておらず、非同期実行のためにバックグラウンドキューに入ります）。最終結果はコールバック通知を通じて送信されます。 GetMediaProducingJob を呼び出して、タスクのステータスを能動的にクエリすることもできます。

• タスクステータスのクエリ:

  1. GetMediaProducingJob を呼び出し、JobId を渡してタスクのステータスと結果をクエリします。

  2. メディア制作タスクをコミットする際、リクエストパラメーターに UserData を設定してコールバック URL を含めることができます。編集タスクが完了または失敗すると、システムはコールバック URL に通知を送信します。コールバックデータを処理してタスクのステータスを取得できます。

• メディアアセットの登録と分析: 動画合成が完了すると、メディアアセットが自動的に登録されます。このポイントでは、メディアアセットはまだ分析中の状態です。分析が完了すると、MediaId に基づいて生成された動画の持続時間と解像度を取得できます。

使用制限

• この操作の速度制限は 30 QPS（タスク送信の秒間リクエスト数）です。送信されたタスクはバックグラウンドキューに入り、非同期でプロセスされます。

  説明

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

• large な数のタスク（1,000 や 10,000 など）を送信する場合、システムは動的にスケールアップしますが、キューイング時間が発生する可能性があります。

• ビデオトラック、イメージトラック、字幕トラックの最大値トラック数はそれぞれ 100 です。

• 素材の数に制限はありませんが、すべての素材の合計ファイルサイズは 1 TB を超えることはできません。

• 入力または出力 OSS バケットのリージョンは、IMS が使用されているリージョンと同じである必要があります。

• 出力が動画の場合、生成される動画には以下の解像度制限が適用されます。

  • 幅と高さはともに少なくとも 128 px である必要があります。

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

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

OutputMediaConfig パラメーター例

例: OSS への出力

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

OSS に出力する場合、MediaURL が必須です。OutputMediaTarget パラメーターのデフォルト値は "oss-object" で、OSS への出力を示します。他のパラメーターは任意です。Bitrate は出力メディアのビットレートを設定するために使用されます。一般的に、ビットレートが高いほど鮮明な動画になります。最大値は 5000 です。Width と Height は出力メディアの解像度を設定するために使用されます。

OSS URL パスフォーマット: https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname は OSS バケットの名前です。

oss-region-name.aliyuncs.com は OSS ファイルのパブリックエンドポイントです。例えば、シンガポール、日本（東京）、米国（バージニア）のエンドポイントは以下の通りです。

oss-ap-southeast-1.aliyuncs.com
oss-ap-northeast-1.aliyuncs.com 
oss-us-east-1.aliyuncs.com

例: VOD への出力

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

VOD に出力する場合、StorageLocation パラメーターと FileName パラメーターが必須です。OutputMediaTarget パラメーターを "vod-media" に設定して、VOD ストレージバケットに出力します。メディアアセットをアップロードし、メディアアセットのストレージアドレスを確認した後、VOD で利用可能なストレージ場所を表示できます。

OutputMediaConfig 構造体の設定項目