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

Intelligent Media Services:SubmitMediaProducingJob

最終更新日:Mar 21, 2026

メディア編集・制作タスクを送信します。動画または音声素材に対して、編集・制作などのポストプロダクション処理を実行する必要がある場合、この操作を呼び出して処理を自動化できます。

操作説明

  • この操作は、メディア編集・制作タスクの送信結果のみを返します。送信結果が返された時点では、タスクがまだ実行中の可能性があります。メディア編集・制作タスクを送信すると、バックグラウンドで非同期処理用にキューに登録されます。

  • オンライン編集プロジェクトのタイムラインで参照される素材は、メディアアセットライブラリ内のメディアアセットまたは Object Storage Service (OSS) オブジェクトである必要があります。外部 URL や Alibaba Cloud コンテンツデリバリーネットワーク (CDN) の URL はサポートされていません。OSS オブジェクトを素材として使用する場合は、MediaUrl を OSS の URL(例:https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.ext)に設定してください。

  • 制作が完了すると、出力ファイルは自動的にメディアアセットとして登録されます。登録されたメディアアセットはまず解析処理を経る必要があります。解析が完了した後は、メディアアセット ID を指定して、持続時間および解像度情報を照会できます。

制限事項

  • この操作の速度制限しきい値は、秒間クエリ数 (QPS) 30 です。

    **

    しきい値を超えた場合、編集タスクの送信時に「Throttling.User」エラーが返されます。この問題の解決方法については、「よくある質問」をご参照ください。

  • 1 つのプロジェクト内で作成できるトラック数は、最大でビデオトラック 100 個、イメージトラック 100 個、字幕トラック 100 個です。

  • 素材ファイルの合計サイズは、1 TB を超えてはなりません。

  • 素材が格納されている OSS バケットおよび出力メディアアセットを保存する OSS バケットは、Intelligent Media Services (IMS) が有効化されているリージョンと同一のリージョンである必要があります。

  • 出力動画は、以下の要件を満たす必要があります:

    • 幅および高さの両方が、最低でも 128 ピクセルである必要があります。

    • 幅および高さの両方が、4,096 ピクセルを超えてはなりません。

    • 動画の短辺が、2,160 ピクセルを超えてはなりません。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:SubmitMediaProducingJob

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ProjectId

string

任意

編集プロジェクトの ID です。

説明

: ProjectId、Timeline、TemplateId のいずれか 1 つを指定し、残りの 2 つのパラメーターは空のままにしてください。

xxxxxfb2101cb318xxxxx

Timeline

string

任意

オンライン編集タスクのタイムラインです。パラメーターの詳細については、「タイムラインの構成」をご参照ください。

説明

: ProjectId、Timeline、TemplateId のいずれか 1 つを指定し、残りの 2 つのパラメーターは空のままにしてください。

{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"****4d7cf14dc7b83b0e801c****"},{"MediaId":"****4d7cf14dc7b83b0e801c****"}]}]}

TemplateId

string

任意

テンプレート ID です。テンプレートを使用すると、タイムラインを容易に構築できます。

説明

: ProjectId、Timeline、TemplateId のいずれか 1 つを指定し、残りの 2 つのパラメーターは空のままにしてください。TemplateId を指定する場合は、ClipsParam も指定する必要があります。

****96e8864746a0b6f3****

ClipsParam

string

任意

テンプレートの素材パラメーター(JSON 形式)。TemplateId を指定する場合は、ClipsParam も指定する必要があります。詳細については、「標準テンプレートの作成と使用」および「高度なテンプレートの作成と使用」をご参照ください。

见模板使用文档

ProjectMetadata

string

任意

編集プロジェクトのメタデータ(JSON 形式)。パラメーターの詳細については、「ProjectMetadata」をご参照ください。

{"Description":"剪辑视频描述","Title":"剪辑标题测试"}

OutputMediaTarget

string

任意

出力ファイルの種別。有効な値は以下のとおりです:

  • oss-object:OSS バケット内の OSS オブジェクト。

  • vod-media:ApsaraVideo VOD 内のメディアアセット。

  • S3:Amazon Simple Storage Service (S3) プロトコルに基づく出力ファイル。

oss-object

OutputMediaConfig

string

必須

出力ファイルの構成(JSON 形式)。OSS の URL または ApsaraVideo VOD のストレージバケット内の保存場所を指定できます。

OSS に出力ファイルを保存するには、MediaURL を指定する必要があります。ApsaraVideo VOD に出力ファイルを保存するには、StorageLocation および FileName を指定する必要があります。

詳細については、「OutputMediaConfig」をご参照ください。

{"MediaURL":"https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4"}

UserData

string

任意

ユーザー定義データ(JSON 形式)。最大長は 512 バイトです。カスタムコールバック URL を指定できます。詳細については、「編集完了時のコールバックの設定」をご参照ください。

{"NotifyAddress":"https://xx.com/xx","RegisterMediaNotifyAddress":"https://xxx.com/xx"}

ClientToken

string

任意

リクエストのべき等性を保証するためのクライアントトークンです。

****12e8864746a0a398****

Source

string

任意

編集・制作リクエストのソース。有効な値は以下のとおりです:

  • OpenAPI

  • AliyunConsole

  • WebSDK

OPENAPI

EditingProduceConfig

string

任意

編集・制作のパラメーターです。詳細については、「EditingProduceConfig」をご参照ください。

説明

EditingProduceConfig でサムネイルが指定されていない場合、動画の最初のフレームがサムネイルとして使用されます。

  • AutoRegisterInputVodMedia:タイムライン内の ApsaraVideo VOD メディアアセットを IMS に自動登録するかどうかを指定します。デフォルト値は true です。

  • OutputWebmTransparentChannel:出力動画に alpha チャンネルを含めるかどうかを指定します。デフォルト値は false です。

  • CoverConfig:カスタムサムネイルのパラメーターです。

{ "AutoRegisterInputVodMedia": "true", "OutputWebmTransparentChannel": "true" }

MediaMetadata

string

任意

制作された動画のメタデータ(JSON 形式)。パラメーターの詳細については、「MediaMetadata」をご参照ください。

{ "Title":"test-title", "Tags":"test-tags1,tags2" }

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 です。Width および Height は出力ファイルの解像度を指定します。

OSS の URL は、次の形式で指定してください:https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext。

bucketname: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 で使用可能なストレージ場所は、メディアアセットを ApsaraVideo VOD にアップロードした後のメディアアセットのストレージの場所に記載されています。

OutputMediaConfig のパラメーター

パラメーター説明
MediaURLString出力ファイルの URL です。OutputMediaTarget が oss-object に設定されている場合、OSS オブジェクトの HTTP URL(例:http://xxx-bucket-name.oss-cn-shanghai.aliyuncs.com/OSS)を指定します。リージョンは、この操作を呼び出すリージョンと同一である必要があります。
StorageLocationStringOutputMediaTarget が vod-media に設定されている場合、このパラメーターは ApsaraVideo VOD 内のメディアアセットの保存場所を示します。保存場所は、ApsaraVideo VOD 内のファイルパス(http:// というプレフィックスを除く)です。例:outin-xxxxxx.oss-cn-shanghai.aliyuncs.com。
FileNameStringOutputMediaTarget が vod-media に設定されている場合、このパラメーターは出力ファイルのファイル名を示します。値にはファイル名拡張子が含まれますが、パスは含まれません。
WidthInteger出力ファイルの幅です。このパラメーターは省略可能です。デフォルト値は、入力素材の最大幅です。
HeightInteger出力ファイルの高さです。このパラメーターは省略可能です。デフォルト値は、入力素材の最大高さです。
BitrateInteger出力ファイルのビットレートです。単位は Kbit/s です。このパラメーターは省略可能です。デフォルト値は、入力素材の最大ビットレートです。
VodTemplateGroupIdStringVOD トランスコードテンプレートグループの ID です。VOD トランスコードを実行しない場合は、値を VOD_NO_TRANSCODE に設定します。

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーターです。

RequestId

string

リクエスト ID です。

****36-3C1E-4417-BDB2-1E034F****

ProjectId

string

編集プロジェクトの ID です。

****b4549d46c88681030f6e****

JobId

string

ジョブ ID です。

****d80e4e4044975745c14b****

MediaId

string

出力ファイルのメディアアセット ID です。

****c469e944b5a856828dc2****

VodMediaId

string

出力ファイルが ApsaraVideo VOD に保存されている場合の、ApsaraVideo VOD 内の出力ファイルのメディアアセット ID です。

****d8s4h75ci975745c14b****

成功レスポンス

JSONJSON

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****b4549d46c88681030f6e****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "VodMediaId": "****d8s4h75ci975745c14b****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameter The specified parameter \ is not valid.
404 ProjectNotFound The specified project not found

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

変更履歴

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