CreateEditingProject - 创建云剪辑工程 - 智能媒体服务

创建云剪辑工程，支持设置标题、描述、时间线和工程封面等。

接口说明

按照剪辑合成的成片时长计费，详情请参见视频剪辑。若处理失败，不收取费用。
创建剪辑工程后，您可以调用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"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。