呼叫本介面根據影音 ID 查詢影音轉碼摘要，包括影音轉碼狀態、轉碼進展等彙總資訊。
介面說明
由於影音可能存在多次轉碼，故本介面僅返回最近一次的轉碼摘要。
支援批次查詢，單次最多可查詢 10 個影音的轉碼摘要。
如需查詢歷史轉碼任務資訊，可呼叫 ListTranscodeTask 介面查詢。
本介面僅支援查詢一年內的轉碼任務資料。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vod:GetTranscodeSummary |
get |
*All Resource
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| VideoIds |
string |
是 |
音訊/影片 ID。最多支援 10 個 ID，多個 ID 之間使用半形逗號（,）分隔。音訊/影片 ID 可透過以下方式取得：
|
"d4860fcc6ae9fed52e8938244****,e1db68cc586644b83e562bcd94****,hhhhhhh" |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
25818875-5F78-4A*****F6-D7393642CA58 |
| NonExistVideoIds |
array |
不存在的音訊/影片 ID 清單。 |
|
|
string |
不存在的音訊/影片 ID 清單。 |
["hhhhhhh"] |
|
| TranscodeSummaryList |
array<object> |
音訊/影片轉碼基礎資訊清單。 |
|
|
array<object> |
|||
| CreationTime |
string |
轉碼任務建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2019-01-23T12:35:12Z |
| VideoId |
string |
音訊/影片 ID。 |
e1db68cc586644b83e562bcd94**** |
| CompleteTime |
string |
轉碼任務完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2019-01-23T12:40:12Z |
| TranscodeStatus |
string |
轉碼處理狀態。取值：
|
Processing |
| TranscodeTemplateGroupId |
string |
轉碼使用的範本群組 ID。 |
44f9e406bbb*****736a9abe876ecc0 |
| TranscodeJobInfoSummaryList |
array<object> |
轉碼作業摘要資訊清單。 |
|
|
object |
|||
| CreationTime |
string |
轉碼作業建立時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2019-02-27T03:34:46Z |
| ErrorMessage |
string |
轉碼失敗的錯誤資訊。 |
ErrorMessage |
| Height |
string |
轉碼輸出視頻的畫面高。單位：px。 |
960 |
| TranscodeProgress |
integer |
轉碼進度。取值範圍： |
100 |
| TranscodeTemplateId |
string |
使用的轉碼模板 ID。 |
57496724ae2*****0968d6e08acc8f6 |
| Bitrate |
string |
轉碼輸出視頻的平均碼率。單位：Kbps。 |
749 |
| ErrorCode |
string |
轉碼失敗的錯誤碼。 |
200 |
| CompleteTime |
string |
轉碼作業完成時間。格式為：yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。 |
2019-02-27T03:40:51Z |
| Width |
string |
轉碼輸出視頻的畫面寬。單位：px。 |
544 |
| Duration |
string |
轉碼輸出視頻時間長度。單位：秒。 |
12 |
| Fps |
string |
轉碼輸出視頻的幀率。單位：幀/秒。 |
30 |
| TranscodeJobStatus |
string |
轉碼作業狀態。取值：
|
Transcoding |
| Filesize |
integer |
轉碼輸出視頻的檔案大小。單位：Byte。 |
1144259 |
| Format |
string |
轉碼輸出視頻的封裝格式。 |
mp4 |
| WatermarkIdList |
array |
轉碼使用的浮水印列表。 |
|
|
string |
轉碼使用的浮水印列表。 |
["af2afe4761992c*****d947dae97337"] |
樣本
正常返回樣本
JSON格式
{
"RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
"NonExistVideoIds": [
"[\"hhhhhhh\"]"
],
"TranscodeSummaryList": [
{
"CreationTime": "2019-01-23T12:35:12Z",
"VideoId": "e1db68cc586644b83e562bcd94****",
"CompleteTime": "2019-01-23T12:40:12Z",
"TranscodeStatus": "Processing",
"TranscodeTemplateGroupId": "44f9e406bbb*****736a9abe876ecc0",
"TranscodeJobInfoSummaryList": [
{
"CreationTime": "2019-02-27T03:34:46Z",
"ErrorMessage": "ErrorMessage",
"Height": "960",
"TranscodeProgress": 100,
"TranscodeTemplateId": "57496724ae2*****0968d6e08acc8f6",
"Bitrate": "749",
"ErrorCode": "200",
"CompleteTime": "2019-02-27T03:40:51Z",
"Width": "544",
"Duration": "12",
"Fps": "30",
"TranscodeJobStatus": "Transcoding",
"Filesize": 1144259,
"Format": "mp4",
"WatermarkIdList": [
"[\"af2afe4761992c*****d947dae97337\"]"
]
}
]
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。