使用GetMediaProducingJob查詢剪輯合成作業的狀態和詳細資料-智能媒體服務-阿里雲

擷取剪輯合成作業的詳細資料，包括剪輯合成任務的任務狀態、時間軸、模板及資料等。

介面說明

使用限制

本介面僅支援查詢近一年的剪輯任務資料。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetMediaProducingJob

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
JobId	string	否	剪輯合成作業 Id	**cdb3e74639973036bc84**

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	請求 ID	**83B7-7F87-4792-BFE9-63CD2137**
MediaProducingJob	object	雲剪輯工程資訊
JobId	string	剪輯合成作業 Id	**cdb3e74639973036bc84**
ProjectId	string	雲剪輯工程 Id	**fddd7748b58bf1d47e95**
MediaId	string	輸出成品的資源 Id	**0cc6ba49eab379332c5b**
MediaURL	string	輸出成品的資源檔 URL	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4
Timeline	string	剪輯合成作業對應的時間軸	{"VideoTracks":[{"VideoTrackClips":[{"MediaId":"**4d7cf14dc7b83b0e801c"},{"MediaId":"4d7cf14dc7b83b0e801c**"}]}]}
TemplateId	string	剪輯合成作業對應的模板 Id	**6e76134d739cc3e85d3e**
ClipsParam	string	剪輯合成作業對應的模板參數	{"VideoArray":["**05512043f49f697f7425","05512043f49f697f7425","05512043f49f697f7425**"]}
Duration	number	輸出成品的時間長度重要當合成任務成功且輸出成品的類型為音視頻時，該欄位有值。	30.500000
CreateTime	string	剪輯合成作業建立時間，格式為 utc 時間。格式為："YYYY-MM-DD'T'hh:mm:ss'Z'"。	2020-12-23T13:33:40Z
CompleteTime	string	剪輯合成作業完成時間，格式為 utc 時間。格式為："YYYY-MM-DD'T'hh:mm:ss'Z'"。	2020-12-23T13:33:52Z
ModifiedTime	string	剪輯合成作業修改時間，格式為 utc 時間。格式為："YYYY-MM-DD'T'hh:mm:ss'Z'"。	2020-12-23T13:33:49Z
Status	string	剪輯合成作業狀態，取值可能為如下值： Init （初始狀態） Queuing（排隊中） Processing（處理中） Success（成功） Failed（失敗）	Failed
Code	string	剪輯合成作業錯誤碼重要作業失敗時關注該欄位	ExceededMaximumValue
Message	string	剪輯合成作業錯誤資訊重要作業失敗時關注該欄位	The specified "Width_Height" has exceeded maximum value.
VodMediaId	string	如果剪輯任務的成片輸出到 VOD，成片會註冊成一個 VOD 的媒資，vodMediaId 即該媒資在 VOD 的媒資 ID	**332c5b0cc6ba49eab379**
UserData	string	使用者自訂設定，JSON 格式。	{"NotifyAddress":"http://xx.xx.xxx","Key":"Valuexxx"}
SubJobMaterials	string	當該剪輯任務是批量智能一鍵成片的子任務，返回子任務用到的口播文案、標題等素材資訊。	{"Title": "標題", "SpeechText": "批量智能一鍵成片口播文案"}
Progress	integer

樣本

正常返回樣本

JSON格式

{
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "MediaProducingJob": {
    "JobId": "****cdb3e74639973036bc84****",
    "ProjectId": "****fddd7748b58bf1d47e95****",
    "MediaId": "****0cc6ba49eab379332c5b****",
    "MediaURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example2.mp4",
    "Timeline": "{\"VideoTracks\":[{\"VideoTrackClips\":[{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"},{\"MediaId\":\"****4d7cf14dc7b83b0e801c****\"}]}]}",
    "TemplateId": "****6e76134d739cc3e85d3e****",
    "ClipsParam": "{\"VideoArray\":[\"****05512043f49f697f7425****\",\"****05512043f49f697f7425****\",\"****05512043f49f697f7425****\"]}",
    "Duration": 30.5,
    "CreateTime": "2020-12-23T13:33:40Z",
    "CompleteTime": "2020-12-23T13:33:52Z",
    "ModifiedTime": "2020-12-23T13:33:49Z",
    "Status": "Failed",
    "Code": "ExceededMaximumValue",
    "Message": "The specified \"Width_Height\" has exceeded maximum value.",
    "VodMediaId": "****332c5b0cc6ba49eab379****",
    "UserData": "{\"NotifyAddress\":\"http://xx.xx.xxx\",\"Key\":\"Valuexxx\"}",
    "SubJobMaterials": "{\"Title\": \"標題\", \"SpeechText\": \"批量智能一鍵成片口播文案\"}",
    "Progress": 0
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidParameter	The specified parameter \ is not valid.
404	JobNotFound	The specified job not found

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

變更歷史

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