全部產品
Search

搜尋本產品

    Intelligent Media Services：CreateLiveTranscodeTemplate

    文件中心

    Intelligent Media Services：CreateLiveTranscodeTemplate

    更新時間：Oct 12, 2026

    呼叫本介面建立即時轉碼範本，便於提交即時轉碼任務。

    介面說明

    僅上海區域支援即時媒體轉碼。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:CreateLiveTranscodeTemplate

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Type

    string

    是

    範本類型。

    • normal - 普通

    • narrow-band - 窄高

    • audio-only - 純音訊

    • origin - 原畫

    枚舉值：

    • normal :

      普通範本。

    • narrow-band :

      窄高範本。

    • audio-only :

      純音訊範本。

    • origin :

      原畫範本。

    normal
    Name

    string

    是

    範本名稱。

    my template
    TemplateConfig

    object

    否

    範本設定。

    說明

    針對不同的範本類型（Type）的傳參要求，參數填寫規則如下：當 Type 的值為 normal 時，寬和高參數中至少需要填寫一個，同時影格率和位元率參數為必填項；對於其他類型的範本，需根據具體需求填寫相應的參數。

    VideoParams

    object

    否

    影片參數。

    Codec

    string

    否

    編碼類型。可選值：

    • H.264

    • H.265

    枚舉值：

    • H.264 :

      H.264 影片編碼。

    • H.265 :

      H.265 影片編碼。

    H.264
    Height

    string

    否

    轉碼影片高度。取值：

    • Height ≥ 128

    • max（Height,Width）≤ 2560

    • min（Height,Width）≤ 1440

    重要 265 窄頻高畫質範本不得超過 1280×720。

    720
    Width

    string

    否

    轉碼影片寬度。取值：

    • Width ≥ 128

    • max（Height,Width）≤ 2560

    • min（Height,Width）≤ 1440

    重要 265 窄頻高畫質範本不得超過 1280×720。

    1280
    Fps

    string

    否

    轉碼影片影格率。單位：FPS，取值：1~60。

    25
    Bitrate

    string

    否

    轉碼影片位元率。單位：kbps，取值：1~6000。

    2500
    Gop

    string

    否

    影片 GOP（Group of Picture）。單位：影格，取值：1~3000。

    1000
    Profile

    string

    否

    編碼層級。影片支援的一組特定的編碼功能，一般值越大得到的畫面品質越好，同時編解碼消耗的資源也越高。取值：

    • 1：baseline（適合行動裝置）。

    • 2：main（適合標準解析度裝置）。

    • 3：high（適合高解析度裝置）。

    枚舉值：

    • 1 :

      Baseline（適合行動裝置）

    • 2 :

      Main（適合標準解析度裝置）

    • 3 :

      High（適合高解析度裝置）

    2
    AudioParams

    object

    否

    音訊參數。

    Codec

    string

    否

    音訊編碼格式。取值：

    • AAC

    • MP3

    枚舉值：

    • MP3 :

      MP3 音訊編碼。

    • AAC :

      AAC 音訊編碼。

    AAC
    Bitrate

    string

    否

    轉碼音訊位元率。單位：kbps，取值：1~1000。

    100
    Samplerate

    string

    否

    音訊取樣率。取值：22050~96000。

    重要 如果 AudioProfile 取值為 aac_ld，則取樣率不能超過 44100。

    44100
    Channels

    string

    否

    音訊聲道數。取值：

    • 1：單聲道。

    • 2：雙聲道。

    2
    Profile

    string

    否

    音訊編碼預設。當 Codec 為 AAC 時，取值：

    • aac_low

    • aac_he

    • aac_he_v2

    • aac_ld

    枚舉值：

    • aac_he :

      高效率 AAC（HE-AAC）

    • aac_low :

      低複雜度 AAC（LC）

    • aac_he_v2 :

      高效率 AAC 版本 2（HE-AACv2）

    • aac_ld :

      低延遲 AAC（LD）

    aaclow

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    ******3B-0E1A-586A-AC29-742247******
    TemplateId

    string

    範本 ID。

    ****20b48fb04483915d4f2cd8ac****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "******3B-0E1A-586A-AC29-742247******",
  "TemplateId": "****20b48fb04483915d4f2cd8ac****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidParam.Height Invalid Parameters: Height
    400 InvalidParam.Width Invalid Parameters: Width
    400 InvalidParam.Fps Invalid Parameters: Fps
    403 OperationDenied Your account has not enabled the ICE service.

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

    變更歷史

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