使用AddEditingProjectMaterials为云剪辑工程添加素材-视频点播-阿里云-视频点播(VOD)-阿里云帮助中心

将一个或多个素材添加到剪辑工程中。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

vod:AddEditingProjectMaterials

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ProjectId	string	是	云剪辑工程 ID。	afa31b483b5c41609185de0e1b790579
MaterialIds	string	是	素材 ID，多个素材以逗号（,）分隔；最多支持 10 个素材 ID。说明关联多个素材时应保证多个素材均为同一类型，且与 MaterialType 取值对应。	d3251979f9fd41f2acb29ccda5a6f772
MaterialType	string	是	素材类型。取值： video：视频。 audio：纯音频。 image：图片。	video

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID	85237CDA-0B54-5CED-BA10-A8A71AA13C1A
MaterialList	array<object>	素材列表
	object	素材详情
Status	string	素材状态。取值： Normal：正常。 Uploading：上传中。 UploadFail：上传失败。	Normal
CateId	integer	分类 ID。	1000487543
CreateTime	string	素材创建时间。格式为：yyyy-mm-ddthh:mm:ssz（utc 时间）。	2019-10-02T08:26Z
MaterialType	string	素材类型。取值： video：视频 audio：纯音频 image：图片	video
Tags	string	素材标签。多个使用半角逗号（,）分隔。	tag1,tag2
SpriteConfig	string	雪碧图配置。	xxx
CateName	string	素材分类名称。	Category 1
Description	string	素材描述。	Material description
MaterialId	string	素材 ID。	85befc4118b84c6723e53b80b1****
Size	integer	文件大小。	1682694
CoverURL	string	素材封面 url。	http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg
Duration	number	素材时长。单位（秒），精确到小数点后 4 位。	3690.2332
CustomerId	integer	用户 ID。	1234751840694470
Title	string	素材标题。	test
ModifyTime	string	素材更新时间。格式为：yyyy-mm-ddthh:mm:ssz（utc 时间）。	2022-11-25T07:28:34Z
Sprites	array	素材雪碧图 url 数组。
	string	素材雪碧图 url	"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0**.jpg?auth_key=**"
Snapshots	array	素材截图 URL 数组。
	string	素材截图 url。	"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0**.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0**.jpg?auth_key="

示例

正常返回示例

JSON格式

{
  "RequestId": "85237CDA-0B54-5CED-BA10-A8A71AA13C1A",
  "MaterialList": [
    {
      "Status": "Normal",
      "CateId": 1000487543,
      "CreateTime": "2019-10-02T08:26Z",
      "MaterialType": "video",
      "Tags": "tag1,tag2",
      "SpriteConfig": "xxx",
      "CateName": "Category 1",
      "Description": "Material description",
      "MaterialId": "85befc4118b84c6723e53b80b1****",
      "Size": 1682694,
      "CoverURL": "http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg",
      "Duration": 3690.2332,
      "CustomerId": 1234751840694470,
      "Title": "test",
      "ModifyTime": "2022-11-25T07:28:34Z",
      "Sprites": [
        "\"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=****\""
      ],
      "Snapshots": [
        "\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\",\"http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=\""
      ]
    }
  ]
}

错误码

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

变更历史

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