すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:CreateLiveTranscodeTemplate

    ドキュメントセンター

    Intelligent Media Services:CreateLiveTranscodeTemplate

    最終更新日:Oct 12, 2026

    リアルタイムトランスコーディングジョブを送信するためのリアルタイムトランスコーディングテンプレートを作成します。

    操作説明

    リアルタイムメディアトランスコーディングは上海リージョンでのみサポートされています。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ice:CreateLiveTranscodeTemplate

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Type

    string

    必須

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

    • normal: 法線テンプレート。

    • narrow-band: Narrowband HD テンプレート。

    • audio-only: 音声のみのテンプレート。

    • origin: オリジナル品質テンプレート。

    列挙値:

    • normal :

      法線テンプレート。

    • narrow-band :

      Narrowband HD テンプレート。

    • audio-only :

      音声のみのテンプレート。

    • origin :

      オリジナル品質テンプレート。

    normal
    Name

    string

    必須

    テンプレート名。

    my template
    TemplateConfig

    object

    任意

    テンプレート構成。

    説明

    パラメーターの要件はテンプレートタイプ (Type) によって異なります。Type パラメーターが normal に設定されている場合、幅および高さのパラメーターの少なくとも 1 つを指定する必要があり、フレームレートおよびビットレートのパラメーターは必須です。他のテンプレートタイプの場合は、必要に応じてパラメーターを指定します。

    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

    重要 H.265 Narrowband HD テンプレートの解像度は 1280×720 を超えることはできません。

    720
    Width

    string

    任意

    トランスコードされたビデオの幅。有効な値:

    • Width ≥ 128

    • max(Height, Width) ≤ 2560

    • min(Height, Width) ≤ 1440

    重要 H.265 Narrowband HD テンプレートの解像度は 1280×720 を超えることはできません。

    1280
    Fps

    string

    任意

    トランスコードされたビデオのフレームレート。単位: FPS。有効な値: 1～60。

    25
    Bitrate

    string

    任意

    トランスコードされたビデオのビットレート。単位: kbps。有効な値: 1～6000。

    2500
    Gop

    string

    任意

    ビデオのグループオブピクチャ (GOP) サイズ。単位: フレーム。有効な値: 1～3000。

    1000
    Profile

    string

    任意

    エンコードプロファイル。ビデオでサポートされる特定のエンコーディング特徴のセット。通常、値が大きいほどビデオ品質は向上しますが、エンコーディングおよびデコーディングのリソース消費が増加します。有効な値:

    • 1: ベースラインプロファイル、モバイルデバイスに適しています。

    • 2: メインプロファイル、標準解像度デバイスに適しています。

    • 3: ハイプロファイル、高解像度デバイスに適しています。

    列挙値:

    • 1 :

      ベースラインプロファイル (モバイルデバイスに適しています)

    • 2 :

      メインプロファイル (標準解像度デバイスに適しています)

    • 3 :

      ハイプロファイル (高解像度デバイスに適しています)

    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 :

      High-Efficiency AAC (HE-AAC)

    • aac_low :

      Low-Complexity AAC (LC)

    • aac_he_v2 :

      High-Efficiency AAC version 2 (HE-AACv2)

    • aac_ld :

      Low-Delay AAC (LD)

    aaclow

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ。

    RequestId

    string

    リクエスト ID。

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

    string

    テンプレート ID。

    ****20b48fb04483915d4f2cd8ac****

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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.

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

    変更履歴

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