すべてのプロダクト
Search
ドキュメントセンター

:QueryTemplateList

最終更新日:Feb 25, 2026

この操作を呼び出して、一度に最大 10 個のトランスコーディングテンプレートをクエリできます。

操作説明

クエリするトランスコーディングテンプレートの ID。一度に最大 10 個のトランスコーディングテンプレートをクエリできます。複数のカスタムトランスコーディングテンプレートの ID は、コンマ (,) で区切ります。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:QueryTemplateList

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

TemplateIds

string

必須

レスポンスパラメーター

16f01ad6175e4230ac42bb5182cd****,88c6ca184c0e424d5w5b665e2a12****

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

NonExistTids

object

String

array

存在しないテンプレートの ID。指定されたすべてのトランスコーディングテンプレートが見つかった場合、このパラメーターは返されません。

string

トランスコーディングテンプレートの詳細。

88c6ca184c0e424d5w5b665e2a12****

TemplateList

object

Template

array<object>

トランスコーディングテンプレート。

array<object>

ビデオコーデック構成。

Video

object

ビデオコーデック構成。

Bufsize

string

バッファーサイズ。

  • 単位:KB。

  • デフォルト値:6000

6000

LongShortMode

string

画面自動回転機能が有効になっているかどうかを示します。

  • この機能が有効な場合、出力ビデオの幅は入力ビデオの長辺 (縦向きモードの入力ビデオの高さ) に対応し、出力ビデオの高さは入力ビデオの短辺 (縦向きモードの入力ビデオの幅) に対応します。有効な値:

  • true

  • false

  • デフォルト値:false

false

Degrain

string

ビデオ品質管理のレベル。

10

BitrateBnd

object

ビデオの平均ビットレート範囲。

Max

string

合計ビットレートの上限。単位:Kbit/s。

100

Min

string

合計ビットレートの下限。単位:Kbit/s。

500

PixFmt

string

ビデオのピクセルフォーマット。有効な値:yuv420p や yuvj420p などの標準ピクセルフォーマット。

yuv420p

Pad

string

ビデオに追加される黒帯。フォーマット:width:height:left:top。例:1280:800:0:140。

1280:800:0:140

Codec

string

コーデック。デフォルト値:H.264

H.264

Height

string

ビデオの高さ。

  • 単位:ピクセル。

  • デフォルト値:入力ビデオの高さ

800

Qscale

string

独立したノイズ除去アルゴリズムの強度。

1

Crop

string

ビデオクロッピングのメソッド。有効な値:

  • border:黒帯を自動的に検出して削除します。

  • width:height:left:top 形式の値:カスタム設定に基づいてビデオをクロップします。フォーマット:width:height:left:top。例:1280:800:0:140。

border

Bitrate

string

ビデオの平均ビットレート。単位:Kbit/s。

200

Maxrate

string

ビデオの最大ビットレート。単位:Kbit/s。

500

MaxFps

string

最大フレームレート。

60

Profile

string

エンコードプロファイル。有効な値:

  • baseline:モバイルデバイスに適用できます。

  • main:標準解像度のデバイスに適用できます。

  • high:高解像度のデバイスに適用できます。

  • デフォルト値:high

high

Crf

string

固定レート係数。

  • エンコード形式が H.264 の場合のデフォルト値:23。エンコード形式が H.265 の場合のデフォルト値:26

  • このパラメーターが設定されている場合、Bitrate の値は無効になります。

15

Remove

string

ビデオストリームを削除するかどうかを示します。有効な値:

  • true

  • false

  • デフォルト値:false

false

Gop

string

2 つのキーフレーム間の最大フレーム数。デフォルト値:250

10

Width

string

ビデオの幅。

  • 単位:ピクセル。

  • デフォルト値:入力ビデオの幅

256

Fps

string

フレームレート。

  • 入力ファイルのフレームレートが 60 を超える場合、値は 60 です。

  • デフォルト値:入力ファイルのフレームレート

25

Preset

string

プリセットビデオアルゴリズム。有効な値:veryfast、fast、medium、slow、slower。デフォルト値:medium

medium

ScanMode

string

スキャンモード。有効な値:

  • interlaced

  • progressive

interlaced

ResoPriority

string

解像度調整のポリシー。有効な値:cropFirst、widthFirst、heightFirst。

heightFirst

Hdr2sdr

string

HDR から SDR への変換機能が有効になっているかどうかを示します。この機能が有効な場合、ハイダイナミックレンジ (HDR) ビデオはスタンダードダイナミックレンジ (SDR) ビデオにトランスコードされます。

true

NarrowBand

object

ナローバンド HD の設定。

Version

string

ナローバンド HD のバージョン。1.0 のみが返される場合があります。

1.0

Abrmax

number

動的ビットレートの上限。このパラメーターが設定されている場合、平均ビットレートは (0, 1000000] の範囲になります。

3000

MaxAbrRatio

number

動的ビットレートの上限の最大比率。このパラメーターが設定されている場合、Abrmax の値はソースビデオのビットレートの x 倍を超えません。有効な値:(0,1.0]。

1.0

TransConfig

object

一般的なトランスコーディング構成。

IsCheckAudioBitrate

string

オーディオビットレートをチェックするかどうかを示します。出力オーディオのビットレートが入力オーディオのビットレートより高い場合、入力ビットレートが保持され、指定されたオーディオビットレートは有効になりません。このパラメーターは IsCheckAudioBitrateFail より優先度が低くなります。有効な値:

  • true

  • false

  • デフォルト値:

    • このパラメーターが指定されておらず、出力オーディオのコーデックが入力オーディオのコーデックと異なる場合、デフォルト値は false です。

    • このパラメーターが指定されておらず、出力オーディオのコーデックが入力オーディオのコーデックと同じ場合、デフォルト値は true です。

false

TransMode

string

トランスコーディングモード。デフォルト値:onepass。有効な値:

  • onepass

  • twopass

  • CBR

onepass

IsCheckReso

string

解像度をチェックするかどうかを示します。幅または高さに基づいて出力解像度が入力解像度より高い場合、入力解像度が保持されます。有効な値:

  • true

  • false

  • デフォルト値:false

false

IsCheckVideoBitrateFail

string

ビデオビットレートチェックエラーを許可するかどうかを示します。このパラメーターは IsCheckVideoBitrate より優先度が高くなります。有効な値:

  • true:ビデオビットレートチェックが失敗した場合、入力ファイルはトランスコードされません。

  • false:ビデオビットレートはチェックされません。

  • デフォルト値:false

false

AdjDarMethod

string

解像度調整のメソッド。デフォルト値:none。有効な値:

  • rescale

  • crop

  • none

none

IsCheckVideoBitrate

string

ビデオビットレートをチェックするかどうかを示します。出力ビデオのビットレートが入力ビデオのビットレートより高い場合、入力ビットレートが保持されます。有効な値:

  • true

  • false

  • デフォルト値:false

false

IsCheckResoFail

string

解像度をチェックするかどうかを示します。幅または高さに基づいて出力解像度が入力解像度より高い場合、トランスコーディングの失敗が返されます。有効な値:

  • true

  • false

  • デフォルト値:false

false

IsCheckAudioBitrateFail

string

オーディオビットレートチェックエラーを許可するかどうかを示します。このパラメーターは IsCheckAudioBitrate より優先度が高くなります。有効な値:

  • true:オーディオビットレートチェックが失敗した場合、入力ファイルはトランスコードされません。

  • false:オーディオビットレートはチェックされません。

  • デフォルト値:false

false

State

string

テンプレートのステータス。有効な値:

  • Normal

  • Deleted

Normal

MuxConfig

object

トランスマックス構成。

Webp

object

WebP のトランスマックス構成。

Loop

string

ループ回数。

0

Gif

object

GIF のトランスマックス構成。

FinalDelay

string

最終フレームが一時停止する時間。

0

DitherMode

string

パレットのカラーディザリングアルゴリズム。有効な値:sierra、bayer。

sierra

Loop

string

ループ回数。

0

IsCustomPalette

string

カスタムパレットを使用するかどうかを示します。

false

Segment

object

セグメント構成。

Duration

string

セグメントの長さ。単位:秒。

10

Name

string

テンプレートの名前。

MPS-example

Audio

object

オーディオコーデック構成。

Profile

string

オーディオのコーデックプロファイル。Codec の値が aac の場合の有効な値:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

  • aac_eld

aac_low

Remove

string

オーディオストリームを削除するかどうかを示します。有効な値:

  • true

  • false

  • デフォルト値:false

false

Codec

string

オーディオコーデックフォーマット。デフォルト値:aac。有効な値:

  • aac

  • mp3

  • vorbis

  • flac

aac

Samplerate

string

サンプリングレート。

  • 単位:Hz

  • デフォルト値:44100

44100

Qscale

string

独立したノイズ除去アルゴリズムの強度。

1

Channels

string

サウンドチャンネルの数。デフォルト値:2

2

Bitrate

string

出力ファイルのオーディオビットレート。

  • 有効な値:[8,1000]

  • 単位:Kbit/s。

  • デフォルト値:128

500

Volume

object

ボリュームコントロール構成。

Method

string

ボリュームを調整するために使用されるメソッド。有効な値:

  • auto

  • dynamic

  • linear

  • デフォルト値:dynamic。

auto

TruePeak

string

ピークボリューム。

  • このパラメーターは、Method の値が dynamic の場合にのみ有効になります。

  • 単位:dB。

  • 有効な値:[-9,0]。

  • デフォルト値:-1。

-1

IntegratedLoudnessTarget

string

出力ボリューム。

  • このパラメーターは、Method の値が dynamic の場合にのみ有効になります。

  • 単位:dB。

  • 有効な値:[-70,-5]。

  • デフォルト値:-6。

-6

LoudnessRangeTarget

string

出力ボリュームに対するボリュームの範囲。

  • このパラメーターは、Method の値が dynamic の場合にのみ有効になります。

  • 単位:dB。

  • 有効な値:[1,20]。

  • デフォルト値:8。

8

Level

string

入力オーディオのボリュームに対する増加したボリューム。

  • このパラメーターは、Method の値が linear の場合にのみ有効になります。

  • 単位:dB。

  • 有効な値:20 以下。

  • デフォルト値:-20。

-20

PeakLevel

string

音量調整係数。

このパラメーターは、Method の値が adaptive の場合にのみ有効になります。

有効な値:[0,1]。

デフォルト値:0.9。

0.9

Id

string

トランスコーディングテンプレート ID。

16f01ad6175e4230ac42bb5182cd****

Container

object

コンテナフォーマット構成。

Format

string

コンテナのフォーマット。有効な値:flv、mp4、ts、m3u8、gif、mp3、ogg、flac。

flv

CreationTime

string

テンプレートが作成された時間。

2021-03-04T06:44:43Z

RequestId

string

リクエスト ID。

BC860F04-778A-472F-AB39-E1BF329C1EA8

成功レスポンス

JSONJSON

{
  "NonExistTids": {
    "String": [
      "88c6ca184c0e424d5w5b665e2a12****"
    ]
  },
  "TemplateList": {
    "Template": [
      {
        "Video": {
          "Bufsize": "6000",
          "LongShortMode": "false",
          "Degrain": "10",
          "BitrateBnd": {
            "Max": "100",
            "Min": "500"
          },
          "PixFmt": "yuv420p",
          "Pad": "1280:800:0:140",
          "Codec": "H.264",
          "Height": "800",
          "Qscale": "1",
          "Crop": "border",
          "Bitrate": "200",
          "Maxrate": "500",
          "MaxFps": "60",
          "Profile": "high",
          "Crf": "15",
          "Remove": "false",
          "Gop": "10",
          "Width": "256",
          "Fps": "25",
          "Preset": "medium",
          "ScanMode": "interlaced",
          "ResoPriority": "heightFirst",
          "Hdr2sdr": "true",
          "NarrowBand": {
            "Version": "1.0",
            "Abrmax": 3000,
            "MaxAbrRatio": 1
          }
        },
        "TransConfig": {
          "IsCheckAudioBitrate": "false",
          "TransMode": "onepass",
          "IsCheckReso": "false",
          "IsCheckVideoBitrateFail": "false",
          "AdjDarMethod": "none",
          "IsCheckVideoBitrate": "false",
          "IsCheckResoFail": "false",
          "IsCheckAudioBitrateFail": "false"
        },
        "State": "Normal",
        "MuxConfig": {
          "Webp": {
            "Loop": "0"
          },
          "Gif": {
            "FinalDelay": "0",
            "DitherMode": "sierra",
            "Loop": "0",
            "IsCustomPalette": "false"
          },
          "Segment": {
            "Duration": "10"
          }
        },
        "Name": "MPS-example",
        "Audio": {
          "Profile": "aac_low",
          "Remove": "false",
          "Codec": "aac",
          "Samplerate": "44100",
          "Qscale": "1",
          "Channels": "2",
          "Bitrate": "500",
          "Volume": {
            "Method": "auto",
            "TruePeak": "-1",
            "IntegratedLoudnessTarget": "-6",
            "LoudnessRangeTarget": "8",
            "Level": "-20",
            "PeakLevel": "0.9"
          }
        },
        "Id": "16f01ad6175e4230ac42bb5182cd****",
        "Container": {
          "Format": "flv"
        },
        "CreationTime": "2021-03-04T06:44:43Z"
      }
    ]
  },
  "RequestId": "BC860F04-778A-472F-AB39-E1BF329C1EA8"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。