CreateEditMaterial - 向工程添加剪辑素材--视频点播-火山引擎

文档中心

立即注册

导航

视频点播

CreateEditMaterial - 向工程添加剪辑素材

最近更新时间：2025.10.30 14:16:01首次发布时间：2025.10.24 20:19:01

调用 CreateEditMaterial 将已存在于视频点播空间中的媒资（视频、音频、图片），添加到指定的剪辑工程中，使其成为该工程内可用的剪辑素材。

使用说明

在视频点播的剪辑体系中，“媒资”和“剪辑素材”是两个独立的概念：

媒资：指您上传到点播空间中的原始文件，拥有唯一的 Vid （音视频）或 Mid（图片）。
剪辑素材：指与某个特定剪辑工程关联的媒资引用。同一个媒资可以被添加到多个不同的工程中，每次添加都会生成一个独立的剪辑素材，并获得一个唯一的 EditMid。

本接口的核心作用就是建立“媒资”与“剪辑工程”之间的关联，并返回代表此关联的 EditMid。

注意事项

调用此接口前，您需调用 CreateProject 接口创建剪辑工程。

请求说明

请求方式：POST
请求地址：https://vod.volcengineapi.com?Action=CreateEditMaterial&Version=2018-01-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`CreateEditMaterial`	接口名称。当前 API 的名称为 `CreateEditMaterial`。
Version	String	是	`2018-01-01`	接口版本。当前 API 的版本为 `2018-01-01`。

Body

参数	类型	是否必选	示例值	描述
ProjectId	String	是	`p0c8100dxxxx3phmbbcb8p374kg`	剪辑工程 ID。
Source	String	是	`vid://v0c2dfxxxxxxxxxxxppfnggtug`	素材的来源地址。支持以下类型：点播 Vid：如果您已将音视频类型的素材上传至视频点播服务并使用 Vid 模式，可通过 `vid://${vid}` 格式指定资源的 Vid 。示例：`vid://v02b6d970000bvg5pi6xxxxxx` 点播 Mid：如果您已将图片类型的素材上传至视频点播服务，可通过 `mid://${mid}` 格式指定资源的 Mid 。示例：`mid://v02b6d970000bvg5pi6xxxxxx` 点播 DirectUrl：如果您已将素材上传至视频点播服务并使用 DirectUrl 模式，可通过 `directurl://{fileName}` 格式指定资源的 FileName。示例：`directurl://test.mp3` 挂载 TOS：如果您已在点播控制台完成挂载对象存储 TOS，可通过 `tos://{bucketName}/{fileName}` 格式指定资源地址。示例：`tos://example/test.mp3`
Name	String	是	`剪辑素材01`	剪辑素材的名称，长度通常在 1-128 个字符之间。
Type	String	是	`video`	资源的类型。支持的取值如下所示。 `video`：视频资源； `audio`：音频资源； `image`：图片资源。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
Result	String	`m0cb600d3xxxx67gp8e6hf0ko790`	剪辑素材 ID，用于后续引用该素材。此 ID 一旦创建，通常不会改变。

请求示例

POST https://vod.volcengineapi.com?Action=CreateEditMaterial&Version=2018-01-01
{
  "ProjectId": "p0c8100dxxxx3phmbbcb8p374kg",
  "Source": "vid://v0c2dfxxxxxxxxxxxppfnggtug",
  "Name": "剪辑素材01",
  "Type": "video"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "CreateEditMaterial",
    "Version": "2018-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": "m0cb600d3xxxx67gp8e6hf0ko790"
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。