全部產品
Search
文件中心

:GetTranscodeTemplateGroup - 查詢轉碼配置詳情

更新時間:Dec 15, 2025

根據轉碼模板組ID查詢轉碼配置的詳細資料。

介面說明

擷取單個模板組資訊,同時會返回該模板組下所有轉碼模板的配置資訊。

調試

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

調試

授權資訊

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

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

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:GetTranscodeTemplateGroup

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

TranscodeTemplateGroupId

string

轉碼模板組 ID。

a591f697c7167*****6ae1502142d0

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

6730AC93-7B12-4B*****7F-49EE1FE8BC49

TranscodeTemplateGroup

object

轉碼模板組資料。

CreationTime

string

模板組的建立時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2018-12-12T10:20:51Z

IsDefault

string

是否是預設範本組。取值:

  • Default:預設範本組。

  • NotDefault:非預設範本組。

NotDefault

AppId

string

應用 ID。

app-****

TranscodeTemplateGroupId

string

轉碼模板組 ID。

a59b11f697c716*****6ae1502142d0

Name

string

模板組的名稱。

test

ModifyTime

string

模板組的修改時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2018-12-12T11:20:51Z

Locked

string

模板組是否處於鎖定狀態。取值:

  • Disabled:未鎖定

  • Enabled:鎖定

Enabled

TranscodeTemplateList

array<object>

轉碼模板配置資訊列表。

object

Type

string

模板類型,取值:

  • Normal(預設):正常轉碼模板。該類型模板不能設定 PackageSetting 參數。

  • VideoPackage:視頻流打包模板。該類型模板會先轉碼,後構建自適應碼流,且必須要配置 PackageSetting 參數。

  • SubtitlePackage:字幕打包模板。該類型模板不會轉碼,僅將對應字幕資訊構建到自適應碼率輸出檔案中,且必須要設定 PackageSetting 參數。但該類型模板不能在模板組中單獨存在,需要與 VideoPackage 類型模板一同配置(一個模板組僅能配置一個該類型模板)。

Normal

Video

string

視頻流轉碼配置參數(JSON 字串)。

{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}

TransConfig

string

條件轉碼參數。如需要根據源片碼率、解析度進行基本邏輯判斷再輸出轉碼視頻,則可設定該參數 (JSON 字串)。

{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}

Rotate

string

視頻旋轉標參數。控制畫面的旋轉角度,例如:設定 180,則視頻畫面將上下顛倒。取值範圍:[0,360]

90

TranscodeTemplateId

string

轉碼模板 ID。

696d29a11erc057*****a3acc398d02f4

TemplateName

string

轉碼模板名稱。

test

EncryptSetting

string

轉碼加密配置資訊。

"EncryptType":"Private"

Audio

string

音頻流轉碼配置參數(JSON 字串)。

{"Codec":"AAC","Remove":"false","Bitrate":"44","Samplerate":"32000","Channels":"2","Profile":"aac_low"}

TranscodeFileRegular

string

自訂轉碼輸出路徑。

{MediaId}/transcoce_1

Container

string

封裝音視頻碼流的容器格式(JSON 字串)。

"Format":"m3u8"

Clip

string

視頻裁剪配置(JSON 字串)。例如:需要截取視頻中的 5s 內容,用於產生一個新的視頻,則可設定該參數。

{"TimeSpan":{"Seek":"1","Duration":"5"}

Definition

string

普通轉碼模板清晰度標記:

  • LD(流暢)

  • SD(標清)

  • HD(高清)

  • FHD(超清)

  • OD(原畫,即轉封裝)

  • 2K

  • 4K

  • SQ(普通音質)

  • HQ(高音質)

窄帶高清 1.0 內建轉碼模板清晰度標記:

  • LD-NBV1(流暢)

  • SD-NBV1(標清)

  • HD-NBV1(高清)

  • FHD-NBV1(超清)

  • 2K-NBV1

  • 4K-NBV1

說明
  • 所有轉碼模板不支援清晰度標記修改。

  • 窄帶高清 1.0 轉碼模板音視頻解析度、碼率等參數為系統內建,不支援修改。

  • 窄帶高清 1.0 轉碼模板建立只支援 FLV、M3U8(HLS)、MP4 格式。

SD

PackageSetting

string

打包配置。僅支援 HLS 自適應碼流打包、DASH 打包(JSON 字串)。

"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }

SubtitleList

string

字幕配置 (JSON 字串)。

[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]

MuxConfig

string

轉碼的分區設定參數。HLS 必傳(JSON 字串)。

"Segment": { "Duration":"6" }

WatermarkIds

array

關聯的圖文浮水印模板 ID。

string

關聯的圖文浮水印模板 ID。

"USER_DEFAULT_WATERMARK","ddddddddd"

TraceMark

string

溯源浮水印資訊。

{ "Enable": true }

CopyrightMark

string

著作權浮水印資訊。

{ "Content": "測試著作權浮水印文案" }

樣本

正常返回樣本

JSON格式

{
  "RequestId": "6730AC93-7B12-4B*****7F-49EE1FE8BC49",
  "TranscodeTemplateGroup": {
    "CreationTime": "2018-12-12T10:20:51Z",
    "IsDefault": "NotDefault",
    "AppId": "app-****",
    "TranscodeTemplateGroupId": "a59b11f697c716*****6ae1502142d0",
    "Name": "test",
    "ModifyTime": "2018-12-12T11:20:51Z",
    "Locked": "Enabled",
    "TranscodeTemplateList": [
      {
        "Type": "Normal",
        "Video": "{\"Codec\":\"H.264\",\"Bitrate\":\"900\",\"Width\":\"960\",\"Remove\":\"false\",\"Fps\":\"30\"}",
        "TransConfig": "{\"IsCheckReso\":\"true\",\"IsCheckResoFail\":\"false\",\"IsCheckVideoBitrate\":\"false\",\"IsCheckVideoBitrateFail\":\"false\",\"IsCheckAudioBitrate\":\"false\",\"IsCheckAudioBitrateFail\":\"false\"}",
        "Rotate": "90",
        "TranscodeTemplateId": "696d29a11erc057*****a3acc398d02f4",
        "TemplateName": "test",
        "EncryptSetting": "\"EncryptType\":\"Private\"",
        "Audio": "{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}",
        "TranscodeFileRegular": "{MediaId}/transcoce_1",
        "Container": "\"Format\":\"m3u8\"",
        "Clip": "{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}",
        "Definition": "SD",
        "PackageSetting": "\"PackageType\":\"HLSPackage\",\"PackageConfig\":{   \"BandWidth\":\"900000\"  }",
        "SubtitleList": "[{\"SubtitleUrl\":\"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass\",\"CharEncode\":\"utf-8\"}]",
        "MuxConfig": "\"Segment\": { \"Duration\":\"6\" }",
        "WatermarkIds": [
          "\"USER_DEFAULT_WATERMARK\",\"ddddddddd\""
        ],
        "TraceMark": "{\n\t\"Enable\": true\n}",
        "CopyrightMark": "{\n\t\"Content\": \"測試著作權浮水印文案\"\n}"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情