使用AddEditingProjectMaterials為雲剪輯工程添加素材-ApsaraVideo for 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	分類別識別碼。	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	素材分類名稱。	分類1
Description	string	素材描述。	素材描述
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	使用者識別碼。	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": "分類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=\""
      ]
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。