メディア編集・制作タスクを送信します。動画または音声素材に対して、編集・制作などのポストプロダクション処理を実行する必要がある場合、この操作を呼び出して処理を自動化できます。
操作説明
この操作は、メディア編集・制作タスクの送信結果のみを返します。送信結果が返された時点では、タスクがまだ実行中の可能性があります。メディア編集・制作タスクを送信すると、バックグラウンドで非同期処理用にキューに登録されます。
オンライン編集プロジェクトのタイムラインで参照される素材は、メディアアセットライブラリ内のメディアアセットまたは 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 ピクセルを超えてはなりません。
今すぐお試しください
テスト
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 |
| 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 |
| EditingProduceConfig |
string |
任意 |
編集・制作のパラメーターです。詳細については、「EditingProduceConfig」をご参照ください。 説明
EditingProduceConfig でサムネイルが指定されていない場合、動画の最初のフレームがサムネイルとして使用されます。
|
{ "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 のパラメーター
| パラメーター | 型 | 説明 |
| MediaURL | String | 出力ファイルの URL です。OutputMediaTarget が oss-object に設定されている場合、OSS オブジェクトの HTTP URL(例:http://xxx-bucket-name.oss-cn-shanghai.aliyuncs.com/OSS)を指定します。リージョンは、この操作を呼び出すリージョンと同一である必要があります。 |
| StorageLocation | String | OutputMediaTarget が vod-media に設定されている場合、このパラメーターは ApsaraVideo VOD 内のメディアアセットの保存場所を示します。保存場所は、ApsaraVideo VOD 内のファイルパス(http:// というプレフィックスを除く)です。例:outin-xxxxxx.oss-cn-shanghai.aliyuncs.com。 |
| FileName | String | OutputMediaTarget が vod-media に設定されている場合、このパラメーターは出力ファイルのファイル名を示します。値にはファイル名拡張子が含まれますが、パスは含まれません。 |
| Width | Integer | 出力ファイルの幅です。このパラメーターは省略可能です。デフォルト値は、入力素材の最大幅です。 |
| Height | Integer | 出力ファイルの高さです。このパラメーターは省略可能です。デフォルト値は、入力素材の最大高さです。 |
| Bitrate | Integer | 出力ファイルのビットレートです。単位は Kbit/s です。このパラメーターは省略可能です。デフォルト値は、入力素材の最大ビットレートです。 |
| VodTemplateGroupId | String | VOD トランスコードテンプレートグループの 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 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。