全部产品
Search

搜索本产品

    视频点播：AddEditingProjectMaterials - 增加剪辑工程关联素材

    文档中心

    视频点播：AddEditingProjectMaterials - 增加剪辑工程关联素材

    更新时间：Jul 19, 2024

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    ProjectIdstring是

    云剪辑工程 ID。

    		afa31b483b5c41609185de0e1b790579
    MaterialIdsstring是

    素材 ID，多个素材以逗号（,）分隔；最多支持 10 个素材 ID。

    说明 关联多个素材时应保证多个素材均为同一类型，且与 MaterialType 取值对应。
    		d3251979f9fd41f2acb29ccda5a6f772
    MaterialTypestring是

    素材类型。取值：

    • video：视频。
    • audio：纯音频。
    • image：图片。
    		video

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID

    		85237CDA-0B54-5CED-BA10-A8A71AA13C1A
    MaterialListarray<object>

    素材列表

    object

    素材详情

    Statusstring

    素材状态。取值：

    • Normal：正常。
    • Uploading：上传中。
    • UploadFail：上传失败。
    		Normal
    CateIdinteger

    分类 ID。

    		1000487543
    CreateTimestring

    素材创建时间。格式为：yyyy-mm-ddthh:mm:ssz（utc 时间）。

    		2019-10-02T08:26Z
    MaterialTypestring

    素材类型。取值：

    • video：视频
    • audio：纯音频
    • image：图片
    		video
    Tagsstring

    素材标签。多个使用半角逗号（,）分隔。

    		tag1,tag2
    SpriteConfigstring

    雪碧图配置。

    		xxx
    CateNamestring

    素材分类名称。

    		分类1
    Descriptionstring

    素材描述。

    		素材描述
    MaterialIdstring

    素材 ID。

    		85befc4118b84c6723e53b80b1****
    Sizelong

    文件大小。

    		1682694
    CoverURLstring

    素材封面 url。

    		http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg
    Durationfloat

    素材时长。单位（秒），精确到小数点后 4 位。

    		3690.2332
    CustomerIdlong

    用户 ID。

    		1234751840694470
    Titlestring

    素材标题。

    		test
    ModifyTimestring

    素材更新时间。格式为：yyyy-mm-ddthh:mm:ssz（utc 时间）。

    		2022-11-25T07:28:34Z
    Spritesarray

    素材雪碧图 url 数组。

    string

    素材雪碧图 url

    		"http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=****"
    Snapshotsarray

    素材截图 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": "分类1",
      "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=\""
      ]
    }
  ]
}

    错误码

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