1 つ以上の動画を完成した動画に生成します。タイムラインパラメーターを使用してソース動画を直接送信するか、最初にオンライン編集プロジェクトを作成してから生成を送信できます。
操作説明
-
この操作を使用する前に、ApsaraVideo VOD の課金方法と料金体系を理解していることを確認してください。オンライン編集は有料の特徴です。課金の詳細については、「ビデオ編集および生成の課金」をご参照ください。
-
これは非同期操作です。タスクを送信すると、オンライン編集プロジェクト ID が返されます（動画はまだ生成されておらず、タスクは非同期実行のキューに入ります）。最終結果はコールバック通知を通じて送信されます。 GetEditingProject を呼び出してタスクのステータスをクエリすることもできます。
-
オンライン編集タイムラインで使用される動画リソースは、素材ライブラリの素材またはメディアライブラリの動画です。メディアライブラリの動画を使用する場合、そのステータスが法線であることを確認してください。
-
動画は ProjectId と タイムライン に基づいて生成されます。ロジックは以下の通りです。
ProjectId と タイムライン の両方を空にすることはできません。空の場合、動画を生成する根拠が存在しません。
ProjectId が空で タイムライン が空でない場合、指定された タイムライン でオンライン編集プロジェクトが自動的に作成されます。タイムライン で参照されている素材が抽出され、プロジェクト素材としてセットされます。その後、動画の生成が開始されます。
ProjectId が空でなく タイムライン が空の場合、ProjectId に基づいて最後に保存された タイムライン が取得され、動画の生成に使用されます。
ProjectId と タイムライン の両方が空でない場合、指定された タイムライン が動画の生成に使用され、対応するオンライン編集プロジェクトが更新されます（タイムライン およびプロジェクト素材）。他のフィールドが指定されている場合、対応するプロジェクトフィールドも更新されます。
-
動画トラック、イメージトラック、字幕トラックの最大値はそれぞれ 100 です。
-
素材の総数は 200 を超えることはできず、素材の合計ファイルサイズは 1 TB を超えることはできません。
-
入力または出力バケットのリージョンは、ApsaraVideo VOD サービスが使用されているリージョンと同じである必要があります。
-
出力が動画の場合、完成した動画には以下の解像度の制限が適用されます。
幅と高さの両方が少なくとも 128 px であること。
幅と高さの両方が最大 4096 px であること。
短辺が最大 2160 px であること。
-
動画の生成が完了すると、動画は自動的に ApsaraVideo VOD にアップロードされます。したがって、動画生成の完了後、ApsaraVideo VOD は ProduceMediaComplete および FileUploadComplete イベント通知を送信します。生成された動画のトランスコード中が完了すると、単一解像度動画トランスコーディング完了 および 全解像度動画トランスコーディング完了 イベント通知が送信されます。
-
生成された動画に効果を追加することもできます。詳細については、「効果」をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:ProduceEditingProjectVideo |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectId |
string |
任意 |
オンライン編集プロジェクトの ID。以下のいずれかの方法で ID を取得できます。
|
fb2101bf24b4cb318787dc**** |
| Timeline |
string |
任意 |
JSON フォーマットのオンライン編集プロジェクトのタイムライン。構造の詳細については、「 Timeline 」をご参照ください。 説明
各 VideoTrackClip オブジェクトに有効な MediaId が含まれていることを確認してください。含まれていない場合、リクエストは失敗します。 |
{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]} |
| Title |
string |
任意 |
オンライン編集プロジェクトのタイトル。 |
Cloud Clip Project Title。 |
| Description |
string |
任意 |
オンライン編集プロジェクトの説明。 |
Cloud clip プロジェクト description。 |
| CoverURL |
string |
任意 |
オンライン編集プロジェクトのサムネイル。 |
https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png。 |
| MediaMetadata |
string |
任意 |
JSON フォーマットの生成された動画のメタデータ。タイトルの構造の詳細については、「 MediaMetadata 」をご参照ください。 |
{"Description":"Synthetic Video Description","Title":"Synthetic userData test"} |
| ProduceConfig |
string |
任意 |
JSON フォーマットの生成構成。タイトルの構造の詳細については、「 ProduceConfig 」をご参照ください。 重要
ファイルストレージリージョンが上海の場合、StorageLocation フィールドは無視できます。ファイルストレージリージョンが他のリージョンの場合は必須です。
|
{"TemplateGroupId":"6d11e25ea30a4c465435c74****"} |
| UserData |
string |
任意 |
JSON フォーマットのカスタム設定。最大値は 256 文字です。この設定はメッセージコールバックやその他の構成をサポートします。タイトルの構造の詳細については、「 UserData 」をご参照ください。 説明
このパラメーターでメッセージコールバックを使用するには、コンソールで HTTP コールバック URL を設定し、対応するコールバックイベントタイプを選択する必要があります。設定しない場合、コールバック設定は有効になりません。 |
{"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}} |
| AppId |
string |
任意 |
アプリケーション ID。デフォルト値: app-1000000。フォーマットの詳細については、「マルチアプリケーション」をご参照ください。 |
app-**** |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
応答パラメーター。 |
||
| RequestId |
string |
リクエスト ID。 |
25818875-5F78-4AF6-D7393642CA58**** |
| MediaId |
string |
生成された動画の ID。 説明
|
006204a11bb386bb25491f95f**** |
| ProjectId |
string |
オンライン編集プロジェクトの ID。 |
fb2101bf24b4cb318787dc**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"MediaId": "006204a11bb386bb25491f95f****",
"ProjectId": "fb2101bf24b4cb318787dc****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。