將一個(gè)或多個(gè)視頻合成為成品。可以通過時(shí)間線參數(shù)直接提交源視頻,也可以先創(chuàng)建云剪輯工程,再提交合成。
接口說明
-
請確保在使用該接口前,已充分了解視頻點(diǎn)播產(chǎn)品的收費(fèi)方式和價(jià)格。云剪輯為付費(fèi)功能,計(jì)費(fèi)詳情,請參見剪輯合成計(jì)費(fèi)。
-
該接口返回合成任務(wù)的提交結(jié)果,不保證接口返回時(shí)視頻已合成完畢。合成任務(wù)將進(jìn)入后臺(tái)排隊(duì),異步執(zhí)行。
-
云剪輯時(shí)間線所使用的視頻資源,既可以是素材管理中的素材,也可以是媒體庫中的視頻,使用媒體庫中的視頻需要確保其狀態(tài)為正常(Normal)。
-
合成視頻依據(jù) ProjectId 與 Timeline 進(jìn)行,具體邏輯如下:
- ProjectId 與 Timeline 不能同時(shí)為空,否則合成視頻沒有任何依據(jù)。
- 如果 ProjectId 為空,Timeline 不為空,則自動(dòng)創(chuàng)建一個(gè)云剪輯工程,以 Timeline 為時(shí)間線,同時(shí)提取 Timeline 中引用的素材并設(shè)置為云剪輯工程的素材,之后進(jìn)行視頻合成。
- 如果 ProjectId 不為空,Timeline 為空,則根據(jù) ProjectId 獲取最新保存的 Timeline,并以此進(jìn)行視頻合成。
- 如果 ProjectId 與 Timeline 均不為空,則以傳入的 Timeline 為準(zhǔn),進(jìn)行視頻合成,同時(shí)更新對應(yīng)的云剪輯工程(Timeline 和云剪輯工程素材)。如果填寫其他字段,則對相應(yīng)的云剪輯工程字段進(jìn)行更新。
-
視頻軌、圖片軌、字幕軌的軌道數(shù)每種均限制最多 100 個(gè)。
-
素材總數(shù)不能超過 200 個(gè),素材文件總大小不能超過 1 TB。
-
輸入或輸出 Bucket 所在 Region,必須和使用 VOD 服務(wù)的 Region 保持一致。
-
當(dāng)輸出為視頻時(shí),成片分辨率有以下限制:
- 寬高都不能小于 128px。
- 寬高都不能大于 4096px。
- 短邊不能大于 2160px。
-
視頻合成完成后,會(huì)自動(dòng)上傳到視頻點(diǎn)播中,因此,視頻合成完成之后,點(diǎn)播服務(wù)會(huì)發(fā)送媒體合成完成和視頻上傳完成的事件通知。合成視頻轉(zhuǎn)碼完成后,會(huì)發(fā)送視頻單個(gè)清晰度轉(zhuǎn)碼完成和視頻全部清晰度轉(zhuǎn)碼完成的事件通知。
-
您還可以為合成視頻添加特效。更多詳情,請參見特效。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級別:是指每個(gè)操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
vod:ProduceEditingProjectVideo | create | *全部資源 * |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ProjectId | string | 否 | 云剪輯工程 ID。可通過以下方式獲取:
| fb2101bf24b4cb318787dc**** |
Timeline | string | 否 | 云剪輯工程時(shí)間線,JSON 格式。具體結(jié)構(gòu)定義,請參見 Timeline 。 | {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac59615a54328bc3443****"},{"MediaId":"da87a9cff645cd88bc6d8326e4****"}]}]} |
Title | string | 否 | 云剪輯工程標(biāo)題。 | 剪輯合成測試 |
Description | string | 否 | 云剪輯工程描述。 | 描述 |
CoverURL | string | 否 | 云剪輯工程封面。 | https://example.aliyundoc.com/6AB4D0E1E1C7446888351****.png |
MediaMetadata | string | 否 | 合成視頻的元數(shù)據(jù),JSON 格式。具體結(jié)構(gòu)定義,請參見 MediaMetadata 。 | {"Description":"合成視頻描述","Title":"合成userData測試"} |
ProduceConfig | string | 否 | 合成配置,JSON 格式。具體結(jié)構(gòu)定義,請參見 ProduceConfig 。 說明
當(dāng)?shù)赜驗(yàn)槌虾R酝獾钠渌赜驎r(shí),StorageLocation 字段必填。
| {"TemplateGroupId":"6d11e25ea30a4c465435c74****"} |
UserData | string | 否 | 自定義設(shè)置,為 JSON 字符串,支持消息回調(diào)等設(shè)置。具體結(jié)構(gòu)定義,請參見 UserData 。 說明
此參數(shù)中消息回調(diào)的使用前提是需要在控制臺(tái)配置 HTTP 回調(diào)地址和勾選對應(yīng)的回調(diào)事件類型才能使用,否則回調(diào)設(shè)置不生效。
| {"Extend":{"width":1280,"id":"028a8e56b1ebf6bb7afc74****","height":720},"MessageCallback":{"CallbackURL":"https://example.aliyundoc.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}} |
AppId | string | 否 | 應(yīng)用 ID。默認(rèn)取值: app-1000000。使用說明,請參見多應(yīng)用。 | app-**** |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"MediaId": "006204a11bb386bb25491f95f****",
"ProjectId": "fb2101bf24b4cb318787dc****"
}
錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2023-11-02 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |