1 つ以上の動画を合成して、最終的な合成ビデオを制作します。`Timeline` パラメーターを使用してソースビデオを直接送信するか、最初にクラウド編集プロジェクトを作成してから制作のために送信することができます。
操作説明
-
重要：クラウド編集は有料機能です。この操作を呼び出す前に、ApsaraVideo VOD の課金方法と料金をご確認ください。詳細については、オンライン編集と制作をご参照ください。
-
これは非同期 API です。タスクを送信すると、システムはクラウド編集プロジェクトの ID を返します。制作はすぐには開始されません。タスクは非同期で処理され、最終結果はコールバック経由で送信されます。また、GetEditingProject 操作を呼び出してタスクステータスをクエリすることもできます。
-
クラウド編集のタイムラインでは、素材管理またはメディアライブラリの動画リソースを使用できます。メディアライブラリの動画を使用する場合は、そのステータスが「通常」であることを確認してください。
-
サービスは `ProjectId` と `Timeline` に基づいて動画を合成します。ロジックは次のとおりです：
`ProjectId` または `Timeline` のいずれかを指定する必要があります。
`Timeline` を指定し、`ProjectId` を指定しない場合、システムは自動的に新しいクラウド編集プロジェクトを作成します。この `Timeline` はプロジェクトのタイムラインとなり、そこで参照されている素材はプロジェクトに追加されます。その後、システムは動画合成に進みます。
`ProjectId` を指定し、`Timeline` を指定しない場合、システムはそのプロジェクトで最後に保存されたタイムラインを取得して動画を合成します。
`ProjectId` と `Timeline` の両方を指定した場合、システムは指定された `Timeline` を使用して動画を合成し、プロジェクトのタイムラインと素材を更新します。他のパラメーターを指定した場合、システムは対応するプロジェクトフィールドも更新します。
-
ビデオトラック、イメージトラック、字幕トラックの各タイプで、最大 100 トラックまで使用できます。
-
素材の総数は 200 を超えることはできず、すべての素材の合計ファイルサイズは 1 TB を超えることはできません。
-
入力または出力バケットのリージョンは、ApsaraVideo VOD サービスを利用するリージョンと同じである必要があります。
-
出力ビデオの解像度は、次の制約を満たす必要があります：
幅と高さは 128 px 以上である必要があります。
幅と高さは 4,096 px 以下である必要があります。
短辺は 2,160 px 以下である必要があります。
-
サービスが動画を合成した後、自動的に動画を ApsaraVideo VOD にアップロードします。その後、サービスはメディア合成完了と動画アップロード完了のイベント通知を送信します。合成された動画がトランスコードされた後、サービスは TranscodeComplete と AllStreamTranscodeComplete のイベント通知を送信します。
-
合成された動画に特殊効果を追加することもできます。詳細については、特殊効果をご参照ください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vod:ProduceEditingProjectVideo |
create |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectId |
string |
任意 |
クラウド編集プロジェクトの ID。ID は次のいずれかの方法で取得できます：
|
fb2101bf24b4cb318787dc**** |
| Timeline |
string |
任意 |
クラウド編集プロジェクトのタイムライン (JSON 形式)。スキーマの詳細については、タイムラインをご参照ください。 説明
各 `VideoTrackClip` オブジェクトに有効な `MediaId` が含まれていることを確認してください。そうでない場合、リクエストは失敗します。 |
{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]} |
| Title |
string |
任意 |
クラウド編集プロジェクトのタイトル。 |
Cloud Clip Project Title |
| Description |
string |
任意 |
クラウド編集プロジェクトの説明。 |
Cloud clip project description |
| CoverURL |
string |
任意 |
クラウド編集プロジェクトのカバー URL。 |
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 をご参照ください。 説明
メッセージコールバック機能を使用するには、ApsaraVideo VOD コンソールで 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****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。