すべてのプロダクト
Search

このプロダクト

    :AddTemplate

    ドキュメントセンター

    :AddTemplate

    最終更新日:Feb 25, 2026

    カスタムトランスコーディングテンプレートを作成します。コンテナフォーマット、ビデオストリーム設定、オーディオストリーム設定などの情報を設定する必要があります。

    操作説明

    この操作を呼び出す際には、コンテナフォーマット、ビデオストリーム、オーディオストリームなどに関連するトランスコーディングパラメーターを設定する必要があります。一部のパラメーターを指定しない場合、テンプレートを使用して生成されるストリームには、それらのパラメーターで指定された情報は含まれません。

    QPS 制限

    この操作は、アカウントごとに 1 秒あたり最大 100 回呼び出すことができます。この制限を超えたリクエストはドロップされ、サービスが中断されます。この操作を呼び出す際には、この制限に注意することを推奨します。詳細については、「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:AddTemplate

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    必須

    トランスコーディングテンプレートの名前。名前の長さは最大 128 バイトです。

    mps-example
    Container

    string

    任意

    コンテナフォーマット。値は、Format パラメーターを含む JSON オブジェクトである必要があります。このパラメーターを指定しない場合、トランスコードされたメディアファイルはデフォルトで MP4 フォーマットになります。トランスコーディングテンプレートを使用して他のフォーマットのメディアファイルを生成する場合は、このパラメーターが必須です。詳細については、「コンテナ」をご参照ください。

    • デフォルト値：MP4。

    • ビデオトランスコーディングは、FLV、MP4、HLS (M3U8 + TS)、MPEG-DASH (MPD + fMP4) のフォーマットをサポートしています。

    説明

    コンテナフォーマットが FLV の場合、ビデオコーデックを H.265 に設定することはできません。

    • オーディオトランスコーディングは、MP3、MP4、OGG、FLAC、M4A のフォーマットをサポートしています。

    • 画像トランスコーディングは、GIF および WebP フォーマットをサポートしています。

    説明

    • コンテナフォーマットが GIF の場合、ビデオコーデックは GIF に設定する必要があります。

    • コンテナフォーマットが WebP の場合、ビデオコーデックは WebP に設定する必要があります。

    {"Format":"mp4"}
    Video

    string

    任意

    ビデオストリームの設定。値は JSON オブジェクトである必要があります。詳細については、「ビデオ」をご参照ください。

    説明

    このパラメーターを指定しない場合、出力ファイルにはビデオストリームが含まれません。ビデオストリームを保持したい場合は、このパラメーターが必須です。

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

    string

    任意

    オーディオストリームの設定。値は JSON オブジェクトである必要があります。詳細については、「オーディオ」をご参照ください。

    説明

    このパラメーターを指定しない場合、出力ファイルにはオーディオストリームが含まれません。オーディオストリームを保持したい場合は、このパラメーターが必須です。

    {"Codec":"H.264","Samplerate":"44100","Bitrate":"500","Channels":"2"}
    TransConfig

    string

    任意

    一般的なトランスコーディング設定。値は JSON オブジェクトである必要があります。詳細については、「TransConfig」をご参照ください。このパラメーターを指定しない場合、デフォルト設定が使用されます。デフォルト設定がビジネス要件を満たせない場合は、このパラメーターが必須です。

    {"TransMode":"onepass"}
    MuxConfig

    string

    任意

    セグメント設定。値は JSON オブジェクトである必要があります。詳細については、「MuxConfig」をご参照ください。このパラメーターを指定しない場合、メディアセグメントファイルは生成されません。メディアセグメントファイルを生成したい場合は、このパラメーターが必須です。

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

    Container

    パラメータータイプ必須説明
    FormatStringいいえこのパラメーターのデフォルト値は MP4 です。ビデオトランスコーディングは、FLV、MP4、HLS (M3U8 + TS)、MPEG-DASH (MPD + fMP4) のフォーマットをサポートしています。オーディオトランスコーディングは、MP3、MP4、OGG、FLAC、M4A のフォーマットをサポートしています。画像トランスコーディングは、GIF および WebP フォーマットをサポートしています。コンテナフォーマットを GIF に設定した場合、ビデオコーデックは GIF に設定する必要があります。コンテナフォーマットを WebP に設定した場合、ビデオコーデックは WebP に設定する必要があります。コンテナフォーマットを FLV に設定した場合、ビデオコーデックは H.265 に設定できません。

    Video

    パラメータータイプ必須説明
    CodecStringいいえビデオコーデック。有効な値：H.264、H.265、GIF、WebP。デフォルト値：H.264。
    ProfileStringいいえコーデックプロファイル。有効な値：baseline、main、high。デフォルト値：high。baseline の値は、メディアファイルがモバイルデバイス用にトランスコードされることを指定します。main の値は、メディアファイルが標準解像度のデバイス用にトランスコードされることを指定します。high の値は、メディアファイルが高解像度のデバイス用にトランスコードされることを指定します。複数の解像度が利用可能な場合、低スペックのデバイスでの正常な再生を保証するために、最も低い解像度にはこのパラメーターを baseline に設定することを推奨します。他の解像度には main または high を設定してください。このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。
    BitrateStringいいえ有効な値：10～50000。単位：Kbit/s。
    CrfStringいいえ固定レート係数。有効な値：0～51。デフォルト値：26。このパラメーターを指定すると、Bitrate パラメーターの設定は無効になります。
    WidthStringいいえビデオの幅。有効な値：128～4096。デフォルト値：入力ビデオの幅。単位：ピクセル。
    HeightStringいいえビデオの高さ。有効な値：128～4096。デフォルト値：入力ビデオの高さ。単位：ピクセル。
    FpsStringいいえビデオのフレームレート。デフォルト値：入力ファイルのフレームレート。入力ファイルのフレームレートが 60 を超える場合、値は 60 になります。有効な値：0～60。単位：1 秒あたりのフレーム数。
    GopStringいいえGOP (Group of Pictures) サイズ。GOP サイズは、キーフレームの最大間隔、またはフレームグループ内の最大フレーム数にすることができます。キーフレームの最大間隔を指定する場合、単位 (s) が必要です。デフォルト値：10s。最大フレーム数を指定する場合、値に単位はありません。有効な値：1～100000。
    PresetStringいいえプリセットのビデオアルゴリズム。有効な値：veryfast、fast、medium、slow、slower。デフォルト値：medium。このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。
    ScanModeStringいいえスキャンモード。有効な値：interlaced と progressive。
    BufsizeStringいいえバッファーのサイズ。有効な値：1000～128000。デフォルト値：6000。単位：KB。
    MaxrateStringいいえビデオの最大ビットレート。有効な値：10～50000。単位：Kbit/s。
    PixFmtStringいいえビデオのピクセルフォーマット。yuv420p や yuvj420p などの標準ピクセルフォーマットがサポートされています。デフォルトでは、yuv420p または入力ビデオのピクセルフォーマットが使用されます。
    RemoveStringいいえビデオストリームを削除するかどうかを指定します。true の値はビデオストリームを削除することを指定します。false の値はビデオストリームを保持することを指定します。デフォルト値：false。
    CropStringいいえビデオのクロップ方法。border の値は、黒い境界線を自動的に検出してクロップすることを指定します。width:height:left:top の形式の値は、カスタム設定に基づいてビデオ画像をクロップすることを指定します。例：1280:800:0:140。
    PadStringいいえビデオに追加する黒い境界線。値は width:height:left:top の形式である必要があります。例：1280:800:0:140。
    LongShortModeStringいいえ画面自動回転機能を有効にするかどうかを指定します。この機能が有効な場合、出力ビデオの幅は入力ビデオの長辺に対応し、これは縦向きモードの入力ビデオの高さになります。出力ビデオの高さは入力ビデオの短辺に対応し、これは縦向きモードの入力ビデオの幅になります。true の値は画面自動回転機能を有効にすることを指定します。false の値は画面自動回転機能を無効にすることを指定します。デフォルト値：false。

    次の表は、サポートされているコンテナフォーマット、ビデオコーデック、オーディオコーデックの組み合わせを示しています。

    コンテナフォーマットオーディオコーデックビデオコーデック
    FLVAAC および MP3H.264
    MP4AAC および MP3H.264 および H.265
    TSAAC および MP3H.264 および H.265
    M3U8AAC および MP3H.264 および H.265
    GIFサポートされていませんGIF

    次の表は、さまざまなビデオコーデックでサポートされているビデオストリームパラメーターを示しています。Y の値はパラメーターがサポートされていることを示します。N の値はパラメーターがサポートされていないことを示します。

    ビデオコーデックH.264H.265GIF
    Profileはいいいえいいえ
    Bitrateはいはいいいえ
    Crfはいはいいいえ
    Widthはいはいはい
    Heightはいはいはい
    Fpsはいはいはい
    Gopはいはいいいえ
    Presetはいいいえいいえ
    ScanModeはいはいはい
    Bufsizeはいはいいいえ
    Maxrateはいはいいいえ
    PixFmtはいはいbgr8

    Audio

    パラメータータイプ必須説明
    CodecStringいいえオーディオコーデック。有効な値：AAC、MP3、VORBIS、FLAC。デフォルト値：AAC。
    ProfileStringいいえオーディオのコーデックプロファイル。Codec パラメーターが AAC に設定されている場合の有効な値：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。
    SamplerateStringいいえサンプリングレート。有効な値：22050、32000、44100、48000、96000。デフォルト値：44100。単位：Hz。ビデオコンテナフォーマットが FLV でオーディオコーデックが MP3 の場合、サンプリングレートは 32000、48000、96000 にできません。オーディオコーデックが MP3 の場合、サンプリングレートは 96000 にできません。
    BitrateStringいいえ出力ファイルのオーディオビットレート。有効な値：8～1000。デフォルト値：128。単位：Kbit/s。
    ChannelsStringいいえサウンドチャンネルの数。デフォルト値：2。Codec パラメーターが MP3 に設定されている場合の有効な値：1 および 2。Codec パラメーターが AAC に設定されている場合の有効な値：1、2、4、5、6、8。
    RemoveStringいいえオーディオストリームを削除するかどうかを指定します。true の値はオーディオストリームを削除することを指定します。false の値はオーディオストリームを保持することを指定します。デフォルト値：false。

    次の表は、サポートされているオーディオコーデックとコンテナフォーマットの組み合わせを示しています。

    コンテナフォーマットオーディオコーデック
    MP3MP3
    MP4AAC
    OGGVORBIS および FLAC
    FLACFLAC

    TransConfig

    パラメータータイプ必須説明
    TransModeStringいいえトランスコーディングモード。有効な値：onepass、twopass、CBR。デフォルト値：onepass。
    AdjDarMethodStringいいえ解像度調整の方法。有効な値：rescale、crop、pad、none。デフォルト値：none。
    IsCheckResoStringいいえ解像度をチェックするかどうかを指定します。この機能が有効で、幅または高さに基づいて出力ファイルの解像度が入力ファイルの解像度より高いとシステムが検出した場合、トランスコーディング後も入力ファイルの解像度が保持されます。true の値は解像度をチェックすることを指定します。false の値は解像度をチェックしないことを指定します。デフォルト値：false。
    IsCheckResoFailStringいいえ解像度をチェックするかどうかを指定します。この機能が有効で、幅または高さに基づいて出力ファイルの解像度が入力ファイルの解像度より高いとシステムが検出した場合、トランスコーディング失敗を示すエラーが返されます。true の値は解像度をチェックすることを指定します。false の値は解像度をチェックしないことを指定します。デフォルト値：false。
    IsCheckVideoBitrateStringいいえビデオビットレートをチェックするかどうかを指定します。この機能が有効で、出力ファイルのビデオビットレートが入力ファイルのビデオビットレートより大きいとシステムが検出した場合、トランスコーディング後も入力ファイルのビデオビットレートが保持されます。true の値はビデオビットレートをチェックすることを指定します。false の値はビデオビットレートをチェックしないことを指定します。デフォルト値：false。
    IsCheckAudioBitrateStringいいえオーディオビットレートをチェックするかどうかを指定します。この機能が有効で、出力ファイルのオーディオビットレートが入力ファイルのオーディオビットレートより大きいとシステムが検出した場合、トランスコーディング後も入力ファイルのオーディオビットレートが保持されます。true の値はオーディオビットレートをチェックすることを指定します。false の値はオーディオビットレートをチェックしないことを指定します。デフォルト値：false。
    IsCheckAudioBitrateFailStringいいえオーディオビットレートをチェックするかどうかを指定します。この機能が有効で、出力オーディオのビットレートが入力オーディオのビットレートより高いとシステムが検出した場合、入力オーディオはトランスコードされません。true の値はオーディオビットレートをチェックすることを指定します。false の値はオーディオビットレートをチェックしないことを指定します。デフォルト値：false。このパラメーターは IsCheckAudioBitrate パラメーターより優先されます。
    IsCheckVideoBitrateFailStringいいえビデオビットレートをチェックするかどうかを指定します。この機能が有効で、出力ビデオのビットレートが入力ビデオのビットレートより高いとシステムが検出した場合、入力ビデオはトランスコードされません。true の値はビデオビットレートをチェックすることを指定します。false の値はビデオビットレートをチェックしないことを指定します。デフォルト値：false。このパラメーターは IsCheckVideoBitrate パラメーターより優先されます。

    MuxConfig

    パラメータータイプ必須説明
    SegmentStringいいえセグメント設定。値は JSON オブジェクトである必要があります。詳細については、次のセクションをご参照ください。

    Segment

    パラメータータイプ必須説明
    DurationStringいいえセグメントの長さ。値は整数である必要があります。単位：秒。有効な値：1～60。デフォルト値：10。
    ForceSegTimeStringいいえメディアファイルをセグメント化する時点。最大 10 個の時点を指定できます。時点はコンマ (,) で区切ります。時点は小数点以下 3 桁まで正確に指定できます。単位：秒。たとえば、このパラメーターを 23,55,60 に設定すると、メディアファイルは 23 秒、55 秒、60 秒の時点でセグメント化されます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

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

    RequestId

    string

    リクエスト ID。

    FA258E67-09B8-4EAA-8F33-BA567834A2C3
    Template

    object

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

    Video

    object

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

    Bufsize

    string

    バッファーのサイズ。

    • デフォルト値：6000。

    • 単位：KB。

    6000
    LongShortMode

    string

    画面自動回転機能が有効かどうかを示します。デフォルト値：false。有効な値：

    • true：画面自動回転機能が有効です。

    • false：画面自動回転機能が無効です。

    説明

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

    false
    Degrain

    string

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

    10
    BitrateBnd

    object

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

    Max

    string

    最大ビットレート。

    1500
    Min

    string

    最小ビットレート。

    800
    PixFmt

    string

    ピクセルフォーマット。yuv420p や yuvj420p などの標準ピクセルフォーマットがサポートされています。デフォルトのピクセルフォーマットは yuv420p または入力ビデオのピクセルフォーマットです。

    yuv420p
    Pad

    string

    ビデオに追加する黒い境界線。値は width:height:left:top の形式です。

    1280:800:0:140
    Codec

    string

    ビデオコーデック。有効な値：H.264、H.265、GIF、WebP。デフォルト値：H.264。

    H.264
    Height

    string

    ビデオの高さ。

    • 単位：ピクセル。

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

    800
    Qscale

    string

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

    1
    Crop

    string

    ビデオのクロップ方法。有効な値：

    • border：境界線を自動的に検出して削除します。

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

    border
    Bitrate

    string

    出力ビデオのビットレート。単位：Kbit/s。

    500
    Maxrate

    string

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

    500
    MaxFps

    string

    最大フレームレート。

    60
    Profile

    string

    コーデックプロファイル。

    • baseline：モバイルデバイスに適しています

    • main：標準解像度のデバイスに適しています

    • high：高解像度のデバイスに適しています

    • デフォルト値：high。

    複数の解像度が利用可能な場合、低スペックのデバイスでの正常な再生を保証するために、最も低い解像度にはこのパラメーターを baseline に設定することを推奨します。他の解像度には main または high を設定してください。

    説明

    このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。

    high
    Crf

    string

    固定レート係数。ビデオコーデックが H.264 に設定されている場合のデフォルト値：23。ビデオコーデックが H.265 に設定されている場合のデフォルト値：26。

    説明

    このパラメーターを指定すると、Bitrate パラメーターの設定は無効になります。

    15
    Remove

    string

    ビデオストリームが削除されるかどうかを示します。

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

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

    • デフォルト値：false。

    false
    Gop

    string

    GOP サイズ。GOP サイズは、キーフレームの最大間隔、またはフレームグループ内の最大フレーム数にすることができます。最大間隔を指定する場合、値には単位 (s) が含まれます。最大フレーム数を指定する場合、値には単位が含まれません。デフォルト値：10s。

    10s
    Width

    string

    ビデオの幅。

    • デフォルト値：入力ビデオの幅。****

    • 単位：ピクセル。

    256
    Fps

    string

    フレームレート。デフォルト値：入力ファイルのフレームレート。入力ファイルのフレームレートが 60 を超える場合、値は 60 になります。単位：1 秒あたりのフレーム数。

    25
    Preset

    string

    プリセットのビデオアルゴリズム。デフォルト値：medium。有効な値：

    • veryfast

    • fast

    • medium

    • slow

    • slower

    説明

    このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。

    fast
    ScanMode

    string

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

    • interlaced

    • progressive

    interlaced
    ResoPriority

    string

    解像度調整のポリシー。

    0
    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

    一般的なトランスコーディング設定。

    IsCheckAudioBitrate

    string

    オーディオビットレートがチェックされるかどうかを示します。

    この機能が有効で、出力ファイルのオーディオビットレートが入力ファイルのオーディオビットレートより大きいとシステムが検出した場合、トランスコーディング後も入力ファイルのオーディオビットレートが保持されます。

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

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

    • デフォルト値：false。

    true
    TransMode

    string

    トランスコーディングモード。有効な値：

    • onepass

    • twopass

    • CBR

    • デフォルト値：onepass。

    onepass
    IsCheckReso

    string

    解像度がチェックされるかどうかを示します。

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

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

    • デフォルト値：false。

    説明

    この機能が有効で、幅または高さに基づいて出力ファイルの解像度が入力ファイルの解像度より高いとシステムが検出した場合、トランスコーディング後も入力ファイルの解像度が保持されます。

    true
    IsCheckVideoBitrateFail

    string

    ビデオビットレートがチェックされるかどうかを示します。この機能が有効で、出力ファイルのビデオビットレートが入力ファイルのビデオビットレートより高いとシステムが検出した場合、入力ファイルはトランスコードされません。このパラメーターは IsCheckVideoBitrate パラメーターより優先されます。

    • true：ビデオビットレートがチェックされます。この場合、出力ファイルのビデオビットレートが入力ファイルのビデオビットレートより高い場合、入力ファイルはトランスコードされません。

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

    • デフォルト値：false。

    true
    AdjDarMethod

    string

    解像度調整の方法。デフォルト値：none。有効な値：

    • rescale：入力ビデオが再スケーリングされます。

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

    • none：変更は行われません。

    rescale
    IsCheckVideoBitrate

    string

    ビデオビットレートがチェックされるかどうかを示します。

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

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

    • デフォルト値：false。

    説明

    この機能が有効で、出力ファイルのビデオビットレートが入力ファイルのビデオビットレートより大きいとシステムが検出した場合、トランスコーディング後も入力ファイルのビデオビットレートが保持されます。

    true
    IsCheckResoFail

    string

    解像度がチェックされるかどうかを示します。

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

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

    • デフォルト値：false。

    説明

    この機能が有効で、幅または高さに基づいて出力ファイルの解像度が入力ファイルの解像度より高いとシステムが検出した場合、トランスコーディング失敗を示すエラーが返されます。

    true
    IsCheckAudioBitrateFail

    string

    オーディオビットレートがチェックされるかどうかを示します。この機能が有効で、出力ファイルのオーディオビットレートが入力ファイルのオーディオビットレートより高いとシステムが検出した場合、入力ファイルはトランスコードされません。このパラメーターは IsCheckAudioBitrate パラメーターより優先されます。有効な値：

    • true：オーディオビットレートがチェックされます。この場合、出力ファイルのオーディオビットレートが入力ファイルのオーディオビットレートより高い場合、入力ファイルはトランスコードされません。

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

    • デフォルト値：false。

    true
    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。

    true
    Codec

    string

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

    • aac

    • mp3

    • vorbis

    • flac

    aac
    Samplerate

    string

    サンプリングレート。

    • 単位：Hz。

    • デフォルト値：44100。

    44100
    Qscale

    string

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

    5
    Channels

    string

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

    2
    Volume

    object

    音量コントロールの構成

    Method

    string

    音量調整の方法。有効な値：

    • auto：音量が自動的に調整されます。

    • dynamic：音量が動的に調整されます。

    • linear：音量が線形に調整されます。

    auto
    Level

    string

    音量調整範囲。

    • デフォルト値：-20。

    • 単位：dB。

    -20
    IntegratedLoudnessTarget

    string

    出力音量。

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

    単位：dB。

    有効な値：[-70,-5]。

    デフォルト値：-6。

    -6
    TruePeak

    string

    ピーク音量。

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

    単位：dB。

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

    デフォルト値：-1。

    0
    LoudnessRangeTarget

    string

    出力音量に対する音量の範囲。

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

    単位：dB。

    有効な値：[1,20]。

    デフォルト値：8。

    8
    PeakLevel

    string

    音量調整係数。

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

    有効な値：[0,1]。

    デフォルト値：0.9。

    0.9
    Bitrate

    string

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

    • 単位：Kbit/s。

    • デフォルト値：128。

    500
    Id

    string

    トランスコーディングテンプレートの ID。後続の操作呼び出しのためにこの ID を保持することを推奨します。

    16f01ad6175e4230ac42bb5182cd****
    Container

    object

    コンテナフォーマットの設定。

    Format

    string

    コンテナフォーマット。

    mp4

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "FA258E67-09B8-4EAA-8F33-BA567834A2C3",
  "Template": {
    "Video": {
      "Bufsize": "6000",
      "LongShortMode": "false",
      "Degrain": "10",
      "BitrateBnd": {
        "Max": "1500",
        "Min": "800"
      },
      "PixFmt": "yuv420p",
      "Pad": "1280:800:0:140",
      "Codec": "H.264",
      "Height": "800",
      "Qscale": "1",
      "Crop": "border",
      "Bitrate": "500",
      "Maxrate": "500",
      "MaxFps": "60",
      "Profile": "high",
      "Crf": "15",
      "Remove": "false",
      "Gop": "10s",
      "Width": "256",
      "Fps": "25",
      "Preset": "fast",
      "ScanMode": "interlaced",
      "ResoPriority": "0",
      "Hdr2sdr": "true",
      "NarrowBand": {
        "Version": "1.0",
        "Abrmax": 3000,
        "MaxAbrRatio": 1
      }
    },
    "TransConfig": {
      "IsCheckAudioBitrate": "true",
      "TransMode": "onepass",
      "IsCheckReso": "true",
      "IsCheckVideoBitrateFail": "true",
      "AdjDarMethod": "rescale",
      "IsCheckVideoBitrate": "true",
      "IsCheckResoFail": "true",
      "IsCheckAudioBitrateFail": "true"
    },
    "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": "true",
      "Codec": "aac",
      "Samplerate": "44100",
      "Qscale": "5",
      "Channels": "2",
      "Volume": {
        "Method": "auto",
        "Level": "-20",
        "IntegratedLoudnessTarget": "-6",
        "TruePeak": "0",
        "LoudnessRangeTarget": "8",
        "PeakLevel": "0.9"
      },
      "Bitrate": "500"
    },
    "Id": "16f01ad6175e4230ac42bb5182cd****",
    "Container": {
      "Format": "mp4"
    }
  }
}

    エラーコード

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

    変更履歴

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