すべてのプロダクト
Search

このプロダクト

    :UpdateTemplate

    ドキュメントセンター

    :UpdateTemplate

    最終更新日:Feb 25, 2026

    カスタムトランスコーディングテンプレートの設定を更新します。

    操作説明

    ステータスが「送信済み」のジョブがこのカスタムテンプレートの使用を指定している場合、対応するトランスコーディングテンプレートの情報は更新できません。

    QPS 制限

    この API の 1 秒あたりのクエリ数 (QPS) 制限は、ユーザーあたり 100 リクエスト/秒です。制限を超えると、API 呼び出しがレート制限の対象となり、ビジネスに影響を与える可能性があります。API を適切に呼び出してください。詳細については、「QPS 制限」をご参照ください。

    今すぐお試しください

    この 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:UpdateTemplate

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    TemplateId

    string

    必須

    テンプレートの名前。名前の長さは 128 バイトまでです。

    16f01ad6175e4230ac42bb5182cd****
    Name

    string

    必須

    コンテナフォーマット。値は JSON オブジェクトです。デフォルトのフォーマット：MP4。

    • ビデオフォーマット：FLV、MP4、HLS (M3U8 + TS)、MPEG-DASH (MPD + fMP4)

    • オーディオフォーマット：MP3、MP4、OGG、FLAC、M4A

    • 画像フォーマット：GIF、WebP

    詳細については、「Parameter details」トピックの Container パラメーターをご参照ください。

    MPS-example
    Container

    string

    任意

    ビデオストリームの構成。値は JSON オブジェクトです。詳細については、「Parameter details」トピックの Video パラメーターをご参照ください。

    {"Format":"mp4"}
    Video

    string

    任意

    オーディオストリームの構成。値は JSON オブジェクトです。詳細については、「Parameter details」トピックの Audio パラメーターをご参照ください。

    {"Codec":"H.264","Profile":"high","Bitrate":"500","Crf":"15","Width":"256","Height":"800","Fps":"25","Gop":"10"}
    Audio

    string

    任意

    トランスマックス構成。値は JSON オブジェクトです。詳細については、「Parameter details」トピックの MuxConfig パラメーターをご参照ください。

    {"Codec":"aac","Samplerate":"44100","Bitrate":"500","Channels":"2"}
    MuxConfig

    string

    任意

    一般的なトランスコード設定。値は JSON オブジェクトです。詳細については、「Parameter details」トピックの TransConfig パラメーターをご参照ください。

    {"Segment":{"Duration":"10"}}
    TransConfig

    string

    任意

    リクエストの ID。

    {"TransMode":"onepass"}

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    トランスコーディングテンプレートのタイプです。

    5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21
    Template

    object

    トランスコーディングテンプレートの種類です。

    Video

    object

    ビデオコーデックの構成。

    LongShortMode

    string

    バッファーのサイズです。

    • 単位：KB。

    • デフォルト値：6000。

    false
    Bufsize

    string

    動画の品質制御レベルです。

    6000
    Degrain

    string

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

    10
    BitrateBnd

    object

    合計ビットレートの上限 (単位： Kbit/s) です。

    Max

    string

    総ビットレートの下限値です。単位：Kbit/s。

    500
    Min

    string

    ピクセルフォーマット。yuv420p・yuvj420p などの標準ピクセルフォーマットが有効です。

    100
    PixFmt

    string

    動画に追加される黒い枠です。

    • フォーマット： width:height:left:top

    • 例： 1280:800:0:140

    yuv420p
    Pad

    string

    ビデオコーデック。デフォルト値：H.264。

    1280:800:0:140
    Codec

    string

    出力ビデオの高さ。

    • 単位：ピクセル。

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

    H.264
    Height

    string

    独立したノイズ除去アルゴリズムのレベルです。

    800
    Qscale

    string

    動画のクロップに使用するメソッドです。

    • border：ボーダーを自動的に検出して削除します。

    • width:height:left:top フォーマットの値：指定した設定で動画をクロップします。例： 1280:800:0:140

    1
    Crop

    string

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

    border
    Bitrate

    string

    動画の最大ビットレートです。単位：Kbit/s。

    200
    Maxrate

    string

    最大フレームレートです。

    500
    MaxFps

    string

    エンコードプロファイル。有効な値は以下のとおりです。

    • baseline：モバイルデバイス向け。

    • main：標準画質デバイス向け。

    • high：高画質デバイス向け。

    • デフォルト値：high。

    60
    Profile

    string

    ビットレートの品質制御係数です。

    • Codec パラメーターが H.264 に設定されている場合のデフォルト値： 23。Codec パラメーターが H.265 に設定されている場合のデフォルト値： 26。

    • このパラメーターが応答として返された場合、Bitrate パラメーターの設定は無効になります。

    high
    Crf

    string

    動画ストリームを削除するかどうかを示します。有効な値は以下のとおりです。

    • true：動画ストリームを削除します。

    • false：動画ストリームを保持します。

    • デフォルト値：false。

    15
    Remove

    string

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

    false
    Gop

    string

    動画の幅です。

    • 単位：ピクセル。

    • デフォルト値：入力動画の幅。

    10
    Width

    string

    フレームレート。

    • 入力動画のフレームレートが 60 を超える場合、値は 60 として返されます。

    • デフォルト値：入力動画のフレームレート。

    256
    Fps

    string

    プリセットのビデオアルゴリズムです。デフォルト値は medium です。有効な値は以下のとおりです。

    • veryfast

    • fast

    • medium

    • slow

    • slower

    25
    Preset

    string

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

    • インターレース: インターレーススキャンが実行されます。

    • プログレッシブ: プログレッシブスキャンが実行されます。

    medium
    ScanMode

    string

    解像度調整のポリシーです。

    interlaced
    ResoPriority

    string

    一般的トランスコード構成です。

    1
    Hdr2sdr

    string

    HDR2SDR 変換機能の有効化状態を示します。この機能が有効の場合、ハイダイナミックレンジ（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

    音声ビットレートのチェックを有効にするかどうかを指定します。出力音声のビットレートが入力音声のビットレートより大きい場合、トランスコード後に元の入力音声のビットレートが維持されます。この場合、指定した音声ビットレートは効果を発揮しません。本パラメーターの優先度は、IsCheckAudioBitrateFail パラメーターより低くなります。有効な値：

    • true：音声ビットレートをチェックします。

    • false：音声ビットレートをチェックしません。

    • デフォルト値：

      • パラメーターが空欄のままであり、かつ出力音声のコーデックが入力音声のコーデックと異なる場合、デフォルト値は false です。

      • パラメーターが空欄のままであり、かつ出力音声のコーデックが入力音声のコーデックと同じ場合、デフォルト値は true です。

    IsCheckAudioBitrate

    string

    トランスコードモードです。デフォルト値は onepass です。有効な値は以下のとおりです：

    • onepass

    • twopass

    • CBR

    false
    TransMode

    string

    解像度をチェックするかどうかを指定します。幅または高さにおいて、出力解像度が入力解像度よりも高い場合、トランスコード後も入力解像度は保持されます。有効な値：

    • true：解像度をチェックします。

    • false：解像度をチェックしません。

    • デフォルト値：false。

    onepass
    IsCheckReso

    string

    ビットレートのチェック対象かどうかを示します。このパラメーターは、IsCheckVideoBitrate パラメーターよりも優先度が高くなります。有効な値は以下のとおりです。

    • true：ビットレートをチェックします。

    • false：ビットレートをチェックしません。

    • デフォルト値：false。

    false
    IsCheckVideoBitrateFail

    string

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

    • rescale： 入力ビデオはリサイズされます。

    • crop： 入力ビデオはクロップされます。

    • none： 変更なし。

    false
    AdjDarMethod

    string

    動画ビットレートをチェックするかどうかを示します。このパラメーターを true に設定すると、出力ファイルの動画ビットレートが入力ファイルより大きい場合、トランスコード後も入力ファイルの動画ビットレートが保持されます。有効な値：

    • true： 動画ビットレートはチェックされます。

    • false： 動画ビットレートはチェックされません。

    • デフォルト値： false。

    none
    IsCheckVideoBitrate

    string

    解像度をチェックするかどうかを指定します。このパラメーターを true に設定し、システムが幅または高さに基づいて出力ファイルの解像度が入力ファイルの解像度より高いことを検出した場合、トランスコード失敗を示すエラーが返されます。有効な値は次のとおりです：

    • true：解像度はチェックされます。

    • false：解像度はチェックされません。

    • デフォルト値：false。

    false
    IsCheckResoFail

    string

    オーディオビットレートがチェックされるかどうかを示します。このパラメーターは、IsCheckAudioBitrate パラメーターよりも優先度が高いです。有効な値：

    • true：オーディオビットレートがチェックされます。

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

    • デフォルト値：false。

    false
    IsCheckAudioBitrateFail

    string

    テンプレートのステータス。有効な値は以下のとおりです。

    • Normal：テンプレートが正常です。

    • Deleted：テンプレートが削除されています。

    false
    State

    string

    トランスミュックス構成。

    Normal
    MuxConfig

    object

    WebP のトランスミュックス構成。

    Webp

    object

    ループ回数。

    Loop

    string

    GIF のトランスミキシング構成。

    0
    Gif

    object

    最終フレームを静止させる時間です。単位：ミリ秒。

    FinalDelay

    string

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

    false
    DitherMode

    string

    ループ回数。

    bayer
    Loop

    string

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

    0
    IsCustomPalette

    string

    セグメント構成。

    0
    Segment

    object

    セグメントの長さです。単位：秒。

    Duration

    string

    テンプレート名。

    10
    Name

    string

    オーディオコーデックの構成です。

    MPS-example
    Audio

    object

    オーディオコーデックの設定です。

    Profile

    string

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

    • true：オーディオストリームは削除されます。

    • false：オーディオストリームは保持されます。

    • デフォルト値：false。

    aac_low
    Remove

    string

    オーディオコーデックのフォーマットです。デフォルト値： aac。有効な値は以下のとおりです。

    • aac

    • mp3

    • vorbis

    • flac

    false
    Codec

    string

    サンプリングレート。

    • 単位：Hz。

    • デフォルト値：44100。

    aac
    Samplerate

    string

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

    44100
    Qscale

    string

    サウンドチャンネル数です。デフォルト値： 2。

    1
    Channels

    string

    出力ファイルの音声ビットレート。

    • 有効な値：8～1000。

    • 単位：Kbps。

    • デフォルト値：128。

    2
    Bitrate

    string

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

    500
    Volume

    object

    ボリュームコントロール設定。

    Method

    string

    音量調整メソッド。有効値：

    • auto

    • dynamic

    • linear

    auto
    TruePeak

    string

    ピークボリュームです。

    • このパラメーターは、Method の値が 動的 の場合にのみ有効です。

    • 単位：デシベル（dB）。

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

    • デフォルト値：-1。

    -1
    IntegratedLoudnessTarget

    string

    期待されるボリュームです。

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

    • 単位：デシベル

    • 有効値：[-70, -5]

    • デフォルト値：-6

    -6
    Level

    string

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

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

    • 単位：デシベル。

    • 有効な値：20 以下。

    • デフォルト値：-20。

    -20
    LoudnessRangeTarget

    string

    ボリュームの期待値に対する範囲です。

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

    • 単位：デシベル

    • 有効値：[1, 20]

    • デフォルト値：8

    8
    PeakLevel

    string

    音量調整係数。

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

    有効値：[0,1]。

    デフォルト値：0.9。

    0.9
    Id

    string

    コンテナー構成です。

    16f01ad6175e4230ac42bb5182cd****
    Container

    object

    コンテナー設定。

    Format

    string

    コンテナフォーマット。

    mp4

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "5E4FB22E-B9EA-4E24-8FFC-B407EA71QW21",
  "Template": {
    "Video": {
      "LongShortMode": "false",
      "Bufsize": "6000",
      "Degrain": "10",
      "BitrateBnd": {
        "Max": "500",
        "Min": "100"
      },
      "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": "1",
      "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": "false",
        "DitherMode": "bayer",
        "Loop": "0",
        "IsCustomPalette": "0"
      },
      "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",
        "Level": "-20",
        "LoudnessRangeTarget": "8",
        "PeakLevel": "0.9"
      }
    },
    "Id": "16f01ad6175e4230ac42bb5182cd****",
    "Container": {
      "Format": "mp4"
    }
  }
}

    エラーコード

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

    変更履歴

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