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

ApsaraVideo Live:AddCustomLiveStreamTranscode

最終更新日:Dec 17, 2025

カスタムトランスコーディング設定を追加します。

操作説明

この操作は、次のタイプのカスタムトランスコーディングテンプレートをサポートしています:

  • h264:カスタム H.264 標準テンプレート。

  • h264-nbhd:カスタム H.264 狭帯域 HD™ テンプレート。

  • h265:カスタム H.265 標準テンプレート。

  • h265-nbhd:カスタム H.265 ナローバンド HD テンプレート。

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

QPS 制限

この操作には、ユーザーごとに毎分 6,000 回の呼び出しという 1 秒あたりのクエリ数 (QPS) 制限があります。制限を超えると、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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:AddCustomLiveStreamTranscode

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-shanghai

Domain

string

必須

ストリーミングドメイン。

example.com

App

string

必須

ライブストリームの AppName。

liveApp****

KmsKeyID

string

任意

Key Management Service (KMS) のカスタマーマスターキー (CMK) の ID。

afce5722-81d2-43c3-9930-7601da11****

KmsUID

string

任意

KMS アカウントの ID。

25346073170691****

KmsKeyExpireInterval

string

任意

キーのローテーション期間。単位:秒。有効値:60~3600。

3600

Template

string

必須

トランスコーディングテンプレートのカスタム名。

説明

名前には、数字、文字、ハイフン (-) を使用できます。数字または文字で始まる必要があります。標準のトランスコーディングテンプレートの名前と同じにすることはできません。

LiveCusTranscode****

TemplateType

string

必須

カスタムトランスコーディングテンプレートのタイプ。有効値:

  • h264:カスタム H.264 標準トランスコーディング。

  • h264-nbhd:カスタム H.264 狭帯域 HD™ トランスコーディング。

  • h265:カスタム H.265 標準トランスコーディング。

  • h265-nbhd:カスタム H.265 狭帯域 HD™ トランスコーディング。

  • audio:音声のみのトランスコーディング。

説明

ビデオタイプの場合、Height、Width、FPS、および VideoBitrate は必須です。

h264

Height

integer

任意

出力ビデオの高さ (ピクセル単位)。要件:

  • Height ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

説明

h265-nbhd の場合、720 を超えることはできません。

720

Width

integer

任意

出力ビデオの幅 (ピクセル単位)。

要件:

  • Width ≥ 100

  • max(Height, Width) ≤ 2560

  • min(Height, Width) ≤ 1440

説明

h265-nbhd の場合、1280 を超えることはできません。

576

FPS

integer

任意

出力ビデオのフレームレート。単位:1 秒あたりのフレーム数 (FPS)。有効値:1~60

30

VideoBitrate

integer

任意

出力ビデオのビットレート。単位:kbps。有効値:1~6000

説明

システムは指定されたビットレートでビデオをトランスコードしようとしますが、実際のビットレートは、特に指定された値が高すぎるか低すぎる場合、指定された値と同じにならないことがあります。

720

AudioBitrate

integer

任意

出力オーディオのビットレート。単位:kbps。有効値:1~1000

512

Gop

string

任意

Group of Pictures (GOP) サイズ。単位はフレームまたは秒です。有効値:

  • フレーム単位:1~3000。

  • 秒単位:1s~20s。

1

Profile

integer

任意

ビデオコーデックプロファイル。値が大きいほど、ビデオ品質は向上しますが、エンコーディングとデコーディングのリソース消費量も高くなります。有効値:

  • 1:ベースライン (モバイルデバイス用)。

  • 2:メイン (SD デバイス用)。

  • 3:ハイ (HD デバイス用)。

2

AudioProfile

string

任意

オーディオプロファイル。有効値:

  • aac_low

  • aac_he

  • aac_he_v2

  • aac_ld

aac_low

AudioCodec

string

任意

オーディオコーデック。有効値:

  • AAC

  • MP3

AAC

AudioRate

integer

任意

オーディオサンプルレート。有効値:2205096000

重要

AudioProfile を aac_ld に設定した場合、サンプルレートは 44100 を超えることはできません。

96000

AudioChannelNum

integer

任意

オーディオチャンネル数。有効値:

  • 1:モノラル。

  • 2:ステレオ。

2

Lazy

string

任意

オンデマンドトランスコーディングを有効にするかどうかを指定します。有効値:

  • yes:最初の視聴者がこのトランスコードされたストリームをリクエストしたときにのみトランスコーディングが開始されます。

  • no:ストリームが公開されるとすぐにトランスコーディングが開始されます。

yes

EncryptParameters

string

任意

暗号化設定。JSON 文字列形式で指定します。

  • EncryptType:暗号化タイプ。値を aliyun に設定します。

  • KmsKeyID:KMS の CMK の ID。

  • KmsKeyExpireInterval:キーのローテーション期間。単位:秒。有効値:60~3600

説明

設定した場合、その内部フィールドを空にすることはできません。

{"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}

ResWithSource

string

任意

アダプティブ解像度設定。指定した場合、Height および Width パラメーターをオーバーライドします。フィールド:

  • Type (string):必須。有効値:

    • short:ビデオの短辺を指定された値に設定し、元のアスペクト比を維持するように他方の辺をスケーリングします。

    • long:ビデオの長辺を指定された値に設定し、元のアスペクト比を維持するように他方の辺をスケーリングします。

    • screen:出力を標準解像度に一致させ、ソースの向きに基づいてディメンションを自動的に反転させます。

  • Value (string):必須。有効値:

    • short の場合:360、480、540、720、1080。

    • long の場合:640、848、960、1280、1920。

    • screen の場合:640×360、848×480、960×540、1280×720、1920×1080。

{"Type":"short","Value":"1080"}

FpsWithSource

string

任意

ソースのフレームレートに基づいて出力フレームレートを適応させ、指定された範囲内に保ちます。指定した場合、FPS パラメーターをオーバーライドします。フィールド:

  • UpLimit (integer):必須。フレームレートの上限。1~60 の整数で、下限より大きい必要があります。

  • LowerLimit (integer):必須。フレームレートの下限。1~60 の整数で、上限より小さい必要があります。

{"UpLimit":60,"LowerLimit":1}

BitrateWithSource

string

任意

アダプティブビットレート設定。指定した場合、VideoBitrate パラメーターをオーバーライドします。フィールド:

  • UpLimit (integer):必須。ビットレートの上限。128~10000 の整数で、下限より大きい必要があります。

  • LowerLimit (integer):必須。ビットレートの下限。128~10000 の整数で、上限より小さい必要があります。

  • Factor (float):必須:ソースビットレートに乗算して出力ビットレートを計算するための係数。有効値:0.1~1。値は小数点以下 1 桁まで指定できます。値 1 は、出力ビットレートがソースビットレートと同じであることを示します。

{"UpLimit":2500,"LowerLimit":800,"Factor":1}

ExtWithSource

string

任意

トランスコードされたストリームをソースストリームに合わせるその他のアダプティブ設定。フィールド:

  • KeyFrameOpen:キーフレームをソースストリームに合わせるかどうかを指定します。有効値:yes および no。

  • Copyts (string):プレゼンテーションタイムスタンプ (PTS) をソースストリームに合わせるかどうかを指定します。有効値:yes および no。

  • SeiMode:Supplemental Enhancement Information (SEI) のパススルーモード。有効値:0 (無効) および 1 (有効)。

{"KeyFrameOpen":"yes","Copyts":"yes","SeiMode":1}

DeInterlaced

boolean

任意

トランスコーディング中にインターレースを自動的に検出して削除するかどうかを指定します。インターレース解除は、インターレースビデオをプログレッシブビデオに変換します。

  • true:インターレース解除を有効にします。

  • false:ソースフォーマットを維持します。これがデフォルト値です。

false

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

16A96B9A-F203-4EC5-8E43-CB92E68F****

成功レスポンス

JSONJSON

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameters %s Please check and try again later.
400 ConfigAlreadyExists %s Please check and try again later.
400 TemplateLimit %s Please check and try again later.

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

変更履歴

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