獲取指定拼接模板詳情
更新時間 2025-04-16 10:39:53
最近更新時間: 2025-04-16 10:39:53
分享文章
用戶可通過本接口向云點播獲取指定ID的拼接模板詳情。
接口功能介紹
用戶可通過本接口向云點播獲取指定ID的拼接模板詳情。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /stitching/template/get
請求體 body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| templateId | 是 | Long | 拼接模板ID | 100000023685 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息，執行成功時，為空字符串。 | "" | |
| data | 是 | Object | 返回數據。 | data |
表 data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| id | 是 | Long | 模板ID | 100000023685 | |
| name | 是 | String | 模板名稱 | 測試拼接模板1 | |
| head | 是 | Array of Objects | 片頭 | head | |
| tail | 是 | Array of Objects | 片尾 | tail | |
| video | 是 | String | 視頻編碼 | video | |
| audio | 是 | String | 音頻編碼 | audio | |
| remark | 是 | String | 備注 | 這是一個測試用的視頻拼接模板 |
表 head
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ID | 是 | String | 視頻ID | af1c37d7c06740d98fb9dd6f76992435 | |
| bucket | 是 | String | 存儲桶名稱 | vod-origin-xxxx | |
| name | 是 | String | 視頻名稱 | head.mp4 | |
| regionCode | 是 | String | 視頻存儲的區域編碼 | 09871 | |
| regionName | 是 | String | 視頻存儲的區域名稱 | 廣東資源池1區 | |
| source | 是 | String | 視頻存儲類型 | VOD |
表 tail
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| ID | 是 | String | 視頻ID | af1c37d7c06740d98fb9dd6f76992435 | |
| bucket | 是 | String | 存儲桶名稱 | vod-origin-xxxx | |
| name | 是 | String | 視頻名稱 | head.mp4 | |
| regionCode | 是 | String | 視頻存儲的區域編碼 | 09871 | |
| regionName | 是 | String | 視頻存儲的區域名稱 | 廣東資源池1區 | |
| source | 是 | String | 視頻存儲類型 | VOD |
表 video
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| follow | 是 | Boolean | 是否跟隨主視頻 | true | |
| bitRate | 是 | String | 主視頻視頻部分預設碼率 | 512kb | |
| height | 是 | Integer | 主視頻預設分辨率高度 | 1024 | |
| width | 是 | Integer | 主視頻預設分辨率寬度 | 768 |
表 audio
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| remove | 是 | Boolean | 是否去除音軌。false-保留音軌并按需填充空音頻流，true-去除音頻。 | false | |
| bitRate | 是 | String | 主視頻音頻部分預設碼率，建議從以下值選擇輸入 128K/192K/256K/320K，>=128k,<=10000k。 | 128kb |
請求示例
請求體body
{
"templateId": 100000023685
}
響應示例
{
"code": "0",
"message": "",
"data": {
"audio": "{\"remove\":false,\"bitRate\":\"128k\"}",
"createTime": 1695864988000,
"head": [
{
"ID": "687fa23e5827491ea43cdbd6be0e646a.mp4",
"bucket": "vod-origin-xxxx",
"name": "687fa23e5827491ea43cdbd6be0e646a.mp4",
"regionCode": "0210001",
"regionName": "上海資源池1區",
"source": "VOD"
}
],
"id": 100000023685,
"name": "testnew",
"remark": "testNew",
"tail": [
{
"ID": "687fa23e5827491ea43cdbd6be0e646a.mp4",
"bucket": "vod-origin-xxxx",
"name": "687fa23e5827491ea43cdbd6be0e646a.mp4",
"regionCode": "0210001",
"regionName": "上海資源池1區",
"source": "VOD"
}
],
"templateState": "F0A",
"updateTime": 1695864988000,
"video": "{\"follow\":true,\"bitRate\":\"128k\",\"height\":0,\"width\":0}"
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
