1つ以上のソースビデオを結合してビデオを制作します。timeline パラメーターを使用してソースビデオを直接送信できます。または、オンライン編集プロジェクトを作成してから、そのプロジェクトを制作のために送信することもできます。
操作説明
-
この操作を使用する前に、ApsaraVideo VOD の課金方法と価格設定を十分に理解していることを確認してください。オンライン編集は有料機能です。課金の詳細については、「ビデオ編集と制作の課金」をご参照ください。
-
この操作はタスク送信の結果を返します。応答が成功したことはタスクが送信されたことを示しますが、ビデオが制作されたことを保証するものではありません。制作タスクはキューに追加され、バックグラウンドで非同期に実行されます。
-
オンライン編集のタイムラインで使用されるビデオ素材は、素材管理の素材またはメディアライブラリのビデオです。メディアライブラリのビデオを使用する場合、そのステータスが「正常」であることを確認してください。
-
ビデオ制作は ProjectId と Timeline に基づいて行われます。ロジックは次のとおりです：
ProjectId と Timeline の両方を空にすることはできません。空にすると、ビデオを制作できません。
ProjectId が空で Timeline が空でない場合、オンライン編集プロジェクトが自動的に作成されます。指定された Timeline がプロジェクトのタイムラインとして使用されます。Timeline で参照されている素材がフェッチされ、プロジェクトの素材として設定されます。その後、ビデオが制作されます。
ProjectId が空でなく Timeline が空の場合、指定された ProjectId の最後に保存されたタイムラインが取得され、ビデオ制作に使用されます。
ProjectId と Timeline の両方が空でない場合、指定された Timeline に基づいてビデオが制作されます。対応するオンライン編集プロジェクトのタイムラインと素材も更新されます。他のフィールドを指定した場合、オンライン編集プロジェクトの対応するフィールドが更新されます。
-
ビデオトラック、イメージトラック、字幕トラックの数は、それぞれ 100 に制限されています。
-
素材の総数は 200 を超えることはできません。素材ファイルの合計サイズは 1 TB を超えることはできません。
-
入力または出力バケットのリージョンは、VOD サービスを使用するリージョンと同じである必要があります。
-
出力ビデオの解像度には、以下の制限があります：
幅と高さは 128 ピクセル未満にすることはできません。
幅と高さは 4096 ピクセルを超えることはできません。
短辺は 2160 ピクセルを超えることはできません。
-
ビデオが制作されると、自動的に ApsaraVideo VOD にアップロードされます。ビデオ制作が完了すると、VOD サービスは Media Production Complete および Video Upload Complete イベント通知を送信します。制作されたビデオがトランスコードされると、サービスは Single Definition Transcoding Complete および All Definitions Transcoding Complete イベント通知を送信します。
-
制作されたビデオに効果を追加することもできます。詳細については、「効果」をご参照ください。
今すぐお試しください
テスト
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 |
任意 |
オンライン編集プロジェクトのサムネイル。 |
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 |
任意 |
カスタム設定。これは最大 256 文字の JSON 文字列です。メッセージコールバックなどの設定をサポートしています。構造の詳細については、「UserData」をご参照ください。 説明
このパラメーターでメッセージコールバック機能を使用するには、コンソールで Webhook アドレスを設定し、対応するイベントタイプを選択する必要があります。そうでない場合、コールバック設定は有効になりません。 |
{"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****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。