通過CreateEditingProject介面建立雲剪輯工程-智能媒體服務-阿里雲

建立雲剪輯工程，支援設定標題、描述、時間軸和工程封面等。

介面說明

按照剪輯合成的成片時間長度計費，詳情請參見視訊剪輯。若處理失敗，不收取費用。
建立剪輯工程後，您可以調用SubmitMediaProducingJob - 提交剪輯合成作業介面提交媒體剪輯合成任務。調用SubmitLiveEditingJob - 提交直播剪輯任務提交直播剪輯任務。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:CreateEditingProject

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Title	string	是	雲剪輯工程標題	example
Description	string	否	雲剪輯工程描述	描述
Timeline	string	否	雲剪輯工程時間軸，Json 格式	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**4d7cf14dc7b83b0e801c"},{"MediaId":"4d7cf14dc7b83b0e801c**"}]}]}
CoverURL	string	否	雲剪輯工程封面。	https://example.com/example.png
TemplateId	string	否	模板 Id，用於快速低門檻的構建時間軸。重要 Timeline、TemplateId 有且只有一個非空。當 TemplateId 不為空白時，ClipsParam 不可為空。	**96e8864746a0b6f3**
ClipsParam	string	否	模板對應的素材參數，Json 格式，當 TemplateId 不為空白時，ClipsParam 不可為空。具體格式見普通模板建立及使用、進階模板建立及使用。	見模板使用文檔
TemplateType	string	否	模板類型，建立基於模板的雲剪輯工程需要填寫，預設值：Timeline。取值範圍： Timeline 普通模板 VETemplate 進階模板枚舉值： Timeline : 普通模板 VETemplate : 進階模板	Timeline
MaterialMaps	string	否	工程關聯素材，多個素材以逗號（,）分隔；每種類型最多支援 10 個素材 ID.	{"video":"***2e057304fcd9b145c5cafc*", "image":"8021a8d493da643c8acd98*,*cb6307a4edea614d8b3f3c*", "liveStream": "[{\"appName\":\"testrecord\",\"domainName\":\"test.alivecdn.com\",\"liveUrl\":\"rtmp://test.alivecdn.com/testrecord/teststream\",\"streamName\":\"teststream\"}]", "editingProject": "*9b145c5cafc2e057304fcd***"}
BusinessConfig	string	否	工程業務配置。一般剪輯工程可忽略。如果是直播剪輯工程 OutputMediaConfig.StorageLocation 必填。 OutputMediaConfig.Path 不填預設合成的直播片段儲存在根路徑下 OutputMediaTarget 可選填 vod-media/oss-object，不填預設 oss-object。 OutputMediaTarget 為 vod-media 時，Path 不生效。	{ "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
ProjectType	string	否	剪輯工程類型 EditingProject：普通剪輯工程。 LiveEditingProject：直播剪輯工程。	LiveEditingProject

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	****3B-0E1A-586A-AC29-742247****
Project	object	雲剪輯工程
ProjectId	string	雲剪輯工程 ID	**01bf24bf41c78b2754cb3187**
Title	string	雲剪輯工程標題	example_title
Description	string	工程描述	example_description
Timeline	string	雲剪輯工程時間軸，Json 格式。具體結構定義參見配置 TimeLine 說明。當該欄位為空白時，則建立一個空的時間軸，且雲剪輯工程的總時間長度為 0。	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**4d7cf14dc7b83b0e801c"},{"MediaId":"4d7cf14dc7b83b0e801c**"}]}]}
TemplateId	string	模板 Id	**96e8864746a0b6f3**
ClipsParam	string	模板素材參數	見模板使用文檔
CoverURL	string	雲剪輯工程封面	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
Status	integer	雲剪輯工程狀態。所有雲剪輯工程狀態列表： 1:Draft 2:Editing 3:Producing 4:Produced 5:ProduceFailed 7:Deleted	2
StatusName	string	雲剪輯狀態名稱，對應狀態列表中狀態名稱。	Editing
CreateTime	string	雲剪輯工程建立時間	2021-01-08T16:52:07Z
ModifiedTime	string	雲剪輯工程編輯時間	2021-01-08T16:52:07Z
Duration	number	雲剪輯工程時間長度	3.4200000
CreateSource	string	雲剪輯工程建立方式 OpenAPI AliyunConsole WebSDK LiveEditingOpenAPI LiveEditingConsole	WebSDK
ModifiedSource	string	雲剪輯工程編輯方式 OpenAPI AliyunConsole WebSDK LiveEditingOpenAPI LiveEditingConsole	WebSDK
TemplateType	string	雲剪輯工程模版類型 -Timeline -VETemplate	Timeline
BusinessConfig	string	工程業務配置，一般剪輯工程可忽略	{ "OutputMediaConfig" : { "StorageLocation": "test-bucket.oss-cn-shanghai.aliyuncs.com", "Path": "test-path" }, "OutputMediaTarget": "oss-object", "ReservationTime": "2021-06-21T08:05:00Z" }
ProjectType	string	剪輯工程類型，預設 EditingProject EditingProject: 普通剪輯工程 LiveEditingProject: 直播剪輯工程	LiveEditingProject
BusinessStatus	string	工程業務狀態，一般剪輯工程可忽略預約中：Reserving 預約取消：ReservationCanceled 直播中：BroadCasting 載入失敗：LoadingFailed 直播結束：LiveFinished	Reserving

樣本

正常返回樣本

JSON格式

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "Project": {
    "ProjectId": "****01bf24bf41c78b2754cb3187****",
    "Title": "example_title",
    "Description": "example_description",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"},{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"}]}]}",
    "TemplateId": "****96e8864746a0b6f3****",
    "ClipsParam": "見模板使用文檔",
    "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
    "Status": 2,
    "StatusName": "Editing",
    "CreateTime": "2021-01-08T16:52:07Z",
    "ModifiedTime": "2021-01-08T16:52:07Z",
    "Duration": 3.42,
    "CreateSource": "WebSDK",
    "ModifiedSource": "WebSDK",
    "TemplateType": "Timeline",
    "BusinessConfig": "{ \"OutputMediaConfig\" :    { \"StorageLocation\": \"test-bucket.oss-cn-shanghai.aliyuncs.com\", \"Path\": \"test-path\"   }, \"OutputMediaTarget\": \"oss-object\", \"ReservationTime\": \"2021-06-21T08:05:00Z\" }",
    "ProjectType": "LiveEditingProject",
    "BusinessStatus": "Reserving"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。