すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:CreateMediaLiveChannel

    ドキュメントセンター

    Intelligent Media Services:CreateMediaLiveChannel

    最終更新日:Mar 21, 2026

    MediaLive チャンネルを作成します。

    操作説明

    QPS 制限

    この操作は、Alibaba Cloud アカウントごとに 1 秒あたり最大 50 回まで呼び出すことができます。この制限を超えるリクエストは破棄され、サービス中断が発生する可能性があります。本操作を呼び出す際には、この制限を十分にご確認ください。

    今すぐお試しください

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

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    必須

    チャンネルの名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    mych
    InputAttachments

    array<object>

    必須

    関連付けられた入力です。

    array<object>

    任意

    InputId

    string

    必須

    関連付けられた入力の ID です。

    myinput
    LanguageName

    string

    任意

    RTMP 入力の言語を識別するタグです。出力から参照できます。最大長は 32 文字です。サポートされる文字：

    • Unicode 文字

    • 数字 (0–9)

    • アンダースコア (_)

    • ハイフン (-)

    • スペース（先頭および末尾には配置できません）

    English
    AudioSelectors

    array<object>

    任意

    音声セレクターです。

    array<object>

    任意

    Name

    string

    必須

    音声セレクターの名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    myselector
    AudioLanguageSelection

    object

    任意

    音声言語選択設定です。

    LanguageCode

    string

    必須

    音声ソース内の 3 文字の ISO 639-2 言語コードを入力します。

    eng
    AudioPidSelection

    object

    任意

    音声 PID 選択設定です。

    Pid

    integer

    必須

    ソース内の特定の PID を入力します。

    123
    AudioTrackSelection

    array<object>

    任意

    音声トラック選択設定です。

    object

    任意

    TrackId

    integer

    必須

    ソース内の音声トラックを Track ID で指定します（1 つ以上）。

    1
    OutputGroups

    array<object>

    必須

    出力グループです。

    array<object>

    任意

    Name

    string

    必須

    出力グループの名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    group1
    Type

    string

    必須

    出力グループのタイプです。現在は MediaPackage のみがサポートされています。

    MediaPackage
    Outputs

    array<object>

    必須

    出力グループ内の出力です。

    array<object>

    任意

    Name

    string

    必須

    出力の名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    output1
    MediaType

    integer

    任意

    出力のメディアタイプです。有効な値：

    • 0：音声および動画

    • 1：音声のみ。値を 1 に設定した場合、VideoSettings を参照できません。

    • 2：動画のみ。値を 2 に設定した場合、AudioSettings を参照できません。

    0
    MediaPackageOutputSetting

    object

    任意

    MediaPackage へ配信される出力の設定です。

    NameModifier

    string

    任意

    マニフェスト名修飾子です。子マニフェストの M3U8 ファイル名にはこの修飾子が含まれます。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 40 文字です。

    480p
    AudioGroupId

    string

    任意

    マニフェスト音声グループ ID です。複数の音声トラックを 1 つのグループに関連付けるには、同じ音声グループ ID を割り当てます。視聴者は必要に応じてトラックを選択できます。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 40 文字です。

    audiogroup
    VideoSettingName

    string

    任意

    参照される VideoSettings の名前です。

    myVideo1
    AudioSettingNames

    array

    任意

    参照される AudioSettings です。

    string

    任意

    参照される AudioSettings の名前です。

    myAudio1
    MediaPackageGroupSetting

    object

    任意

    MediaPackage の送信先です。

    GroupName

    string

    必須

    MediaPackage 内の GroupName です。

    myPackageGroup
    ChannelName

    string

    必須

    MediaPackage 内の ChannelName です。

    myPackageChannel
    AudioSettings

    array<object>

    任意

    音声設定です。

    array<object>

    任意

    Name

    string

    必須

    音声設定の名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    audio1
    AudioSelectorName

    string

    任意

    音声セレクターの名前です。

    a1
    LanguageCode

    string

    任意

    3 文字の ISO 639-2 言語コードを入力します。音声セレクターで選択された音声トラックに言語コードが存在する場合は、音声セレクターで指定された言語コードが使用されます。選択された音声トラックに言語コードがない場合、または音声セレクターが条件に一致するトラックを見つけられない場合は、この言語コードが使用されます。

    eng
    LanguageName

    string

    任意

    RTMP 入力の言語を識別するタグです。出力から参照できます。最大長は 32 文字です。サポートされる文字：

    • Unicode 文字

    • 数字 (0–9)

    • アンダースコア (_)

    • ハイフン (-)

    • スペース（先頭および末尾には配置できません）

    English
    AudioCodec

    string

    任意

    音声コーデックです。未指定の場合、ソース仕様が使用されます。有効な値：aac、libfdk_aac。

    libfdk_aac
    AudioCodecSetting

    object

    任意

    音声エンコーディング設定です。

    Profile

    string

    任意

    音声コーデックプロファイルです。AudioCodec が aac の場合、AAC-LOW および AAC-MAIN がサポートされます。AudioCodec が libfdk_aac の場合、AAC-LOW、AAC-HE、および AAC-HEV2 がサポートされます。

    AAC-LOW
    Bitrate

    integer

    任意

    音声ビットレートです。単位：bit/s。有効な値：8000～1000000。1000 の倍数である必要があります。

    200000
    SampleRate

    integer

    任意

    音声サンプルレートです。単位：Hz。有効な値：22050、32000、44100、48000、96000。

    44100
    VideoSettings

    array<object>

    任意

    動画設定です。

    array<object>

    任意

    Name

    string

    必須

    動画設定の名前です。英字、数字、ハイフン (-)、およびアンダースコア (_) を使用できます。最大長は 64 文字です。

    video1
    Width

    integer

    任意

    出力の幅です。0 を設定するか空欄のままにすると、元の縦横比を維持するために高さに応じて幅が自動的に調整されます。

    有効な値：

    • 通常のトランスコードの場合、大きい方のディメンションは 3840 px を超えず、小さい方のディメンションは 2160 px を超えません。

    • 狭帯域 HD™ トランスコードの場合、大きい方のディメンションは 1920 px を超えず、小さい方のディメンションは 1080 px を超えません。

    1280
    Height

    integer

    任意

    出力の高さです。0 を設定するか空欄のままにすると、元の縦横比を維持するために幅に応じて高さが自動的に調整されます。

    有効な値：

    • 通常のトランスコードの場合、大きい方のディメンションは 3840 px を超えず、小さい方のディメンションは 2160 px を超えません。

    • 狭帯域 HD™ トランスコードの場合、大きい方のディメンションは 1920 px を超えず、小さい方のディメンションは 1080 px を超えません。

    720
    VideoCodec

    string

    任意

    動画コーデックです。有効な値：H264、H265。

    H264
    VideoCodecSetting

    object

    任意

    動画エンコーディング設定です。

    Rate

    object

    任意

    動画エンコーディングレートです。未指定の場合、ソース仕様が使用されます。

    Bitrate

    integer

    任意

    動画ビットレートです。単位：bit/s。0 を設定するか空欄のままにすると、ソース仕様が使用されます。有効な値：50000～6000000。1000 の倍数である必要があります。

    2500000
    RateControlMode

    string

    任意

    ビットレート制御モードです。有効な値：CBR、ABR、VBR。

    ABR
    MaxBitrate

    integer

    任意

    最大ビットレートです。単位：bit/s。有効な値：100000～6000000。1000 の倍数である必要があります。

    6000000
    BufferSize

    integer

    任意

    動画バッファーのサイズです。単位：bit/s。有効な値：100000～6000000。1000 の倍数である必要があります。

    6000000
    Framerate

    object

    任意

    フレームレートです。未指定の場合、ソース仕様が使用されます。

    FramerateControl

    string

    任意

    フレームレートモードです。有効な値：SPECIFIED（固定フレームレート）、FROM_SOURCE（ソース仕様を使用）。

    SPECIFIED
    FramerateNumerator

    integer

    任意

    固定フレームレートの分子です。FramerateControl が SPECIFIED に設定されている場合、このパラメーターは必須です。有効な値：1～60。分子は分母で割り切れる必要があります。

    25
    FramerateDenominator

    integer

    任意

    固定フレームレートの分母です。FramerateControl が SPECIFIED に設定されている場合、このパラメーターは必須です。有効な値：1～60。分子は分母で割り切れる必要があります。

    1
    Gop

    object

    任意

    GOP 設定です。未指定の場合、ソース仕様が使用されます。

    GopSizeUnits

    string

    任意

    GOP サイズの単位です。有効な値：FRAMES、SECONDS。

    FRAMES
    GopSize

    integer

    任意

    GOP サイズです。GopSizeUnits が SECONDS の場合、値の範囲は 1～20 です。GopSizeUnits が FRAMES の場合、値の範囲は 1～3000 です。

    90
    BframesNum

    integer

    任意

    B フレームの数です。有効な値：1～3。

    3
    CodecDetail

    object

    任意

    動画エンコーディング設定です。

    Profile

    string

    任意

    H.264 プロファイルです。有効な値：BASELINE、HIGH、MAIN。デフォルト値：MAIN。このパラメーターは、コーデックが H.264 の場合にのみ有効です。

    MAIN
    Level

    string

    任意

    動画エンコーディングレベルです。現時点ではサポートされていません。

    H264_LEVEL_AUTO
    VideoCodecType

    string

    任意

    動画トランスコーディング方法です。有効な値：

    • NORMAL：通常のトランスコード

    • NBHD：狭帯域 HD™ トランスコード

    未指定の場合、デフォルトで通常のトランスコードが使用されます。

    NORMAL

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマです。

    RequestId

    string

    リクエストの ID です。

    ******11-DB8D-4A9A-875B-275798******
    ChannelId

    string

    チャンネルの ID です。

    SEGK5KA6KYKAWQQH

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "ChannelId": "SEGK5KA6KYKAWQQH"
}

    エラーコード

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

    変更履歴

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