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

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

介面說明

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

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:CreateEditingProject

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
Title	string	是	雲端剪輯專案標題。	example
Description	string	否	雲端剪輯專案描述。	Description
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 不能為空。具體格式見普通範本建立及使用、進階範本建立及使用。	See the template user guide.
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	範本素材參數。	See the template user guide.
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": "See the template user guide.",
    "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"
  }
}

錯誤碼

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

變更歷史

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