建立雲端轉碼任務。
介面說明
服務存取點
本介面可用的服務存取點包括：
| 地區名稱 | 地區 ID | 公網接入地址 |
| 新加坡 | ap-southeast-1 | live.ap-southeast-1.aliyuncs.com |
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求文法
POST HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| AppId |
string |
是 |
頻道所屬的應用 ID。由大小寫字母、數字、底線、短劃線（-）組成，最大 64 字元。 |
********-7074-****-9ef5-85c19a4***** |
| ChannelId |
string |
是 |
待轉碼使用者所屬的頻道 ID。由大小寫字母、數字、底線、短劃線（-）組成，最大 64 字元。 |
myChannel |
| InputParam |
object |
是 |
訂閱輸入相關參數。 |
|
| SingleSubUserParam |
object |
是 |
單流訂閱輸入參數。 |
|
| UserId |
string |
是 |
訂閱的使用者識別碼。 |
userA |
| StreamType |
integer |
否 |
訂閱使用者的媒體類型。取值：
|
0 |
| SourceType |
integer |
否 |
訂閱的視頻輸入資料流類型，僅訂閱媒體類型包含視頻流有效。取值：
|
0 |
| OutputParams |
array<object> |
是 |
轉碼輸出相關參數。 |
|
|
object |
否 |
轉碼輸出參數。 |
||
| ChannelId |
string |
是 |
轉碼流轉推到的頻道 ID。由大小寫字母、數字、底線、短劃線（-）組成，最大 64 字元。（暫不支援轉推到不同的頻道，設定無效） |
myChannel |
| UserId |
string |
是 |
轉碼流轉推到頻道的使用者識別碼，需保證與頻道內其它使用者識別碼 不同。 |
userA_360p |
| UserToken |
string |
是 |
轉碼流轉推到頻道所需的使用者 Token，詳見 Token 鑒權。 |
eyJhcHBpZCI******** |
| TranscodeTemplate |
string |
是 |
轉碼模板名。取值：
|
lhd |
| MaxIdleTime |
integer |
否 |
空閑逾時時間，當任務處於空閑狀態（訂閱不到指定主播流）的時間長度超過一定時間會自動停止。 單位為秒，範圍須在[10,14400]內，即最大 4 小時，預設為 300 秒。 |
600 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回內容。 |
||
| RequestId |
string |
請求 ID。 |
******3B-0E1A-586A-AC29-742247****** |
| TaskId |
string |
雲端轉碼任務 ID。 |
******73-8501-****-8ac1-72295a****** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "******3B-0E1A-586A-AC29-742247******",
"TaskId": "******73-8501-****-8ac1-72295a******"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter%s | %s. | |
| 400 | MissingParameter%s | %s. | |
| 400 | TooManyRequests | %s. | |
| 500 | InternalError | %s. | 直播 liveapi 服務端錯誤。 |
| 403 | Forbidden | %s. | |
| 404 | NotFound%s | %s. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。