调用GetEditingProjectMaterials获取云剪辑工程的待剪辑素材列表。

使用说明

在剪辑过程中,素材可添加到时间线上,但不一定完全被使用。

建议您升级成ICE,详细说明,请参见升级说明

QPS限制

本接口的单用户QPS限制为30次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetEditingProjectMaterials

系统规定参数。取值:GetEditingProjectMaterials

ProjectId String 1982361011093374****

云剪辑工程ID。可通过以下方式获取:

  • 登录点播控制台,选择制作中心 > 视频剪辑,查看ID。
  • 通过创建云剪辑工程接口创建工程时,为返回参数ProjectId的值。
Type String video

素材类型。取值:

  • video:视频
  • audio:纯音频
MaterialType String video

素材类型。取值:

  • video:视频
  • audio:纯音频
  • image:图片

返回数据

名称 类型 示例值 描述
RequestId String 746FFA07-8BBB-46B1-3E94E3B2915E****

请求ID。

MaterialList Array of Material

素材列表。

Material
Status String Normal

素材状态。取值:

  • Normal:草稿 。
  • Producing:合成中。
  • Produced :合成成功。
  • ProduceFailed:合成失败。
CreationTime String 2017-10-19 10:48:17

素材创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

CateId Integer 100005****

素材分类ID。

MaterialType String video

素材类型。取值:

  • video:视频
  • audio:纯音频
  • image:图片
Tags String 剪辑测试

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

SpriteConfig String xxx

雪碧图配置。

Source String xxx

雪碧图来源。

CateName String 测试

素材分类名称。

ModifiedTime String 2017-10-19 10:48:17

素材更新时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Description String 测试

素材描述。

MaterialId String 85befc4118b84c6723e53b80b1****

素材ID。

Size Long 1682694

素材源文件大小,单位:字节。

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

素材封面URL。

Duration Float 15.16

素材时长,精确到小数点后4位,单位:秒。

Title String test

素材标题。

Sprites Array of String {"Sprite":["http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="]}

素材雪碧图URL数组。

Snapshots Array of String ["http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="]

素材截图URL数组。

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetEditingProjectMaterials
&ProjectId=1982361011093374****
&Type=video
&MaterialType=video
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetEditingProjectMaterialsResponse>
    <RequestId>746FFA07-8BBB-46B1-3E94E3B2915E****</RequestId>
    <MaterialList>
        <Status>Normal</Status>
        <CreationTime>2017-10-19 10:48:17</CreationTime>
        <MaterialType>video</MaterialType>
        <Tags>剪辑测试</Tags>
        <SpriteConfig>xxx</SpriteConfig>
        <Source>xxx</Source>
        <CateName>测试</CateName>
        <ModifiedTime>2017-10-19 10:48:17</ModifiedTime>
        <Description>测试</Description>
        <MaterialId>85befc4118b84c6723e53b80b1****</MaterialId>
        <Size>1682694</Size>
        <CoverURL>http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg</CoverURL>
        <Duration>15.16</Duration>
        <Title>test</Title>
        <Sprites>{"Sprite":["http://example.aliyundoc.com/material_big_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="]}</Sprites>
        <Snapshots>["http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key=","http://example.aliyundoc.com/material_small_snapshot/0f325c157386f2a7e91b2ff0****.jpg?auth_key="]</Snapshots>
    </MaterialList>
</GetEditingProjectMaterialsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "746FFA07-8BBB-46B1-3E94E3B2915E****",
  "MaterialList" : [ {
    "Status" : "Normal",
    "CreationTime" : "2017-10-19 10:48:17",
    "MaterialType" : "video",
    "Tags" : "剪辑测试",
    "SpriteConfig" : "xxx",
    "Source" : "xxx",
    "CateName" : "测试",
    "ModifiedTime" : "2017-10-19 10:48:17",
    "Description" : "测试",
    "MaterialId" : "85befc4118b84c6723e53b80b1****",
    "Size" : 1682694,
    "CoverURL" : "http://example.aliyundoc.com/aivideocover/46fa444aa34065cb9250f6c****/image_01.jpg",
    "Duration" : 15.16,
    "Title" : "test",
    "Sprites" : [ "{\"Sprite\":[\"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=\"]" ]
  } ]
}

错误码

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

SDK示例

建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见: