新增拼接模板
更新時間 2025-04-16 10:39:53
最近更新時間: 2025-04-16 10:39:53
分享文章
用戶可在通過本接口向云點播新增一組拼接模板。
接口功能介紹
用戶可在通過本接口向云點播新增一組拼接模板。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。
URI
POST /stitching/template/create
請求體 body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| name | 是 | String | 拼接模板名稱 | 測試拼接模板1 | |
| head | 否 | Array of Objects | 片頭視頻,但head與tail兩個選填入參至少需要傳一個。 | head | |
| tail | 否 | Array of Objects | 片尾視頻,但head與tail兩個選填入參至少需要傳一個。 | tail | |
| video | 是 | String | 拼接視頻信息 | video | |
| audio | 是 | String | 音頻信息 | audio | |
| remark | 否 | String | 拼接模板備注 | 測試拼接模板1 |
表 head
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| visitUrl | 是 | String | 片頭視頻列表,必須為云點播存儲地址 | //vod-origin-test.gdoss.ctyun.store/1c5df1379a714dd39ce97c1ee1c305d7.mp4 |
表 tail
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| visitUrl | 是 | String | 片尾視頻列表,必須云點播存儲地址 | //vod-origin-test.gdoss.ctyun.store/1c5df1379a714dd39ce97c1ee1c305d7.mp4 |
表 video
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| follow | 是 | Boolean | 拼接視頻分辨率是否跟隨主視頻 | true/false | |
| bitRate | 是 | String | 主視頻視頻部分預設碼率 | 512kb | |
| height | 是 | Integer | 主視頻預設分辨率高度 | 1024 | |
| width | 是 | Integer | 主視頻預設分辨率寬度 | 768 |
表 audio
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| remove | 是 | Boolean | 是否去掉拼接視頻音頻 | true/false | |
| bitRate | 是 | String | 主視頻音頻部分預設碼率,建議從以下值選擇輸入 128K/192K/256K/320K,>=128k,<=10000k。 | 128kb |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息,創建成功時,為空字符串。 | "" | |
| data | 是 | Object | 返回數據。 | data |
表 data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| templateId | 是 | Long | 模板ID | 100000000004 | -- |
請求示例
請求體body
{
"name": "測試拼接模板1",
"head": [
{
"visitUrl": "//vod-origin-test.gdoss.ctyun.store/1c5df1379a714dd39ce97c1ee1c305d7.mp4"
}
],
"tail": [
{
"visitUrl": "//vod-transcode-test.gdoss.ctyun.store/adedb99a97b940dab21746656e04c58f/224.flv"
}
],
"video": "{\"follow\": false,\"bitRate\": \"512k\",\"height\": 720,\"width\": 1280}",
"audio": "{\"remove\": false,\"bitRate\": \"128k\"}",
"remark": "這是一個測試用的視頻拼接模板"
}
響應示例
{
"code": 0,
"message": "",
"data" : {
"templateId" : 100000000004
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗,用戶無操作權限 | 用戶鑒權失敗,用戶無操作權限 |
| 404 | 請求的資源不存在,輸入錯誤的URL | 請求的資源不存在,輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。