すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:SubmitTranscodeJob

    ドキュメントセンター

    Intelligent Media Services:SubmitTranscodeJob

    最終更新日:Apr 19, 2026

    SubmitTranscodeJob 操作を呼び出して、動画または音声のトランスコーディングジョブを Intelligent Media Services (IMS) に送信します。リクエストでは、トランスコーディングするソースファイル、出力フォーマット、および関連パラメーターを指定する必要があります。

    操作説明

    • この操作は 2025 年 12 月 31 日に廃止されます。代わりに SubmitMediaConvertJob を使用してください。

    • これは非同期操作です。ジョブを送信すると、システムはジョブ ID を返します。ジョブはすぐには完了せず、バックグラウンドで非同期に実行するためにキューに入れられます。最終結果はコールバック通知で受信します。また、QueryTranscodeJob を呼び出してジョブステータスをクエリすることもできます。

    今すぐお試しください

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

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    ジョブ名。

    job-name
    InputGroup

    array<object>

    必須

    ジョブの入力グループ。単一の入力はトランスコーディングジョブを作成します。複数の入力はメディアマージジョブを作成します。

    job-name

    object

    必須

    ジョブ入力。

    Type

    string

    必須

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    必須

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    説明

    URL 内の OSS バケットを使用する前に、IMS のストレージ管理に追加する必要があります。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    InputUrl

    string

    任意

    入力ストリームパス：

    • このパラメーターは、Type が Media の場合にのみ有効です。メディアアセットから特定のファイルを入力として選択できます。

    • システムは、入力 URL がメディアアセットに存在するかどうかを確認します。

    oss://bucket/path/to/video.mp4
    OutputGroup

    array<object>

    必須

    ジョブの出力グループ。

    user-data

    array<object>

    必須

    ジョブ出力。

    Output

    object

    必須

    出力メディア設定。

    Type

    string

    必須

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    必須

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    説明

    URL 内の OSS バケットを使用する前に、IMS のストレージ管理に追加する必要があります。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    OutputUrl

    string

    任意

    出力ストリームパス：
    このパラメーターは Type が Media の場合にのみ有効です。メディアアセットから特定のファイルを出力として選択できます。
    有効なプレースホルダー：




    • {MediaId}：メディアアセット ID。

    • {JobId}：サブジョブ ID。

    • {MediaBucket}：メディアアセットが存在するバケット。

    • {ExtName}：ファイル拡張子。これはトランスコーディングテンプレートで指定された出力フォーマットです。

    • {DestMd5}：トランスコーディングされた出力ファイルの MD5 ハッシュ。

    説明

    1. このパラメーターには {MediaId} と {JobId} の両方を含める必要があります。

    2. 出力バケットは、メディアアセットが存在するバケットと同じである必要があります。

    oss://bucket/path/to/{MediaId}/{JobId}.mp4
    ProcessConfig

    object

    必須

    ジョブ処理設定。

    Transcode

    object

    必須

    トランスコーディング設定。

    TemplateId

    string

    必須

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    任意

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Video

    object

    任意

    ビデオ設定。

    Codec

    string

    任意

    エンコード形式。

    H.264
    Profile

    string

    任意

    エンコードプロファイル。有効な値：baseline、main、high。

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

    • main：標準解像度デバイス向け。

    • high：高解像度デバイス向け。

    デフォルト値：high。

    Main
    Bitrate

    string

    任意

    平均ビデオビットレート。有効な値：[10, 50000]。単位：Kbps。

    3000
    Crf

    string

    任意

    固定レート係数 (CRF)。品質とビットレートのトレードオフを制御します。有効な値：[0, 51]。デフォルト値：H.264 の場合は 23、H.265 の場合は 26。

    説明

    Crf を設定した場合、Bitrate の設定は無視されます。

    23
    Width

    string

    任意

    幅。有効な値：[128, 4096]。単位：px。デフォルト値：元のビデオの幅。

    1920
    Height

    string

    任意

    高さ。有効な値：[128, 4096]。単位：px。デフォルト値：元のビデオの高さ。

    1080
    Fps

    string

    任意

    フレームレート。有効な値：(0, 60]。デフォルト値：入力ファイルのフレームレート。

    説明

    入力ファイルのフレームレートが 60 を超える場合、システムは 60 を使用します。

    25
    Gop

    string

    任意

    キーフレーム間の最大フレーム数。有効な値：[1, 1080000]。デフォルト値：250。

    250
    Preset

    string

    任意

    ビデオエンコーダープリセット。H.264 のみがこのパラメーターをサポートします。有効な値：veryfast、fast、medium、slow、slower。デフォルト値：medium。

    medium
    ScanMode

    string

    任意

    スキャンモード。有効な値：interlaced および progressive。

    progressive
    PixFmt

    string

    任意

    ビデオカラーフォーマット。有効な値には yuv420p および yuvj420p が含まれます。

    yuv420p
    Remove

    string

    任意

    ビデオを削除するかどうかを指定します。

    false
    Crop

    string

    任意

    ビデオクロッピング方法。2つのオプションがあります：

    • 黒枠を自動的に検出してクロップします。これを border に設定します。

    • カスタムクロッピング。フォーマット：width:height:left:top。例：1280:800:0:140

    1280:800:0:140
    Pad

    string

    任意

    黒枠のパディング設定。フォーマット：width:height:left:top。例：1280:800:0:140

    1280:800:0:140
    LongShortMode

    string

    任意

    縦向きまたは横向きのビデオの自動回転（長辺/短辺モードとも呼ばれる）を有効にするかどうかを指定します。

    false
    Bufsize

    string

    任意

    バッファサイズ。有効な値：[1000, 128000]。デフォルト値：6000。単位：Kb。

    6000
    Maxrate

    string

    任意

    ピークビデオビットレート。有効な値：[10, 50000]。単位：Kbps。

    9000
    AbrMax

    string

    任意

    アダプティブビットレートストリーミング (ABR) の最大ビットレート。これはナローバンド HD 1 にのみ適用されます。有効な値：[10, 50000]。単位：Kbps。

    6000
    Audio

    object

    任意

    オーディオ設定。

    Codec

    string

    任意

    オーディオコーデック。有効な値：AAC、MP3、VORBIS、FLAC。デフォルト値：AAC。

    AAC
    Profile

    string

    任意

    オーディオエンコーディングプロファイル。Codec が AAC の場合、有効な値は aac_low、aac_he、aac_he_v2、aac_ld、aac_eld です。

    aac_low
    Samplerate

    string

    任意

    サンプルレート。デフォルト値：44100。有効な値：22050、32000、44100、48000、96000。単位：Hz。

    44100
    Bitrate

    string

    任意

    出力ファイルのオーディオビットレート。有効な値：[8, 1000]。単位：Kbps。デフォルト値：128。

    128
    Channels

    string

    任意

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

    2
    Remove

    string

    任意

    音声ストリームを削除するかどうかを指定します。

    false
    Volume

    object

    任意

    音量コントロール。

    Method

    string

    任意

    音量調整方法。

    auto
    IntegratedLoudnessTarget

    string

    任意

    ターゲットラウドネスレベル。

    -6
    TruePeak

    string

    任意

    トゥルーピーク音量。

    -1
    LoudnessRangeTarget

    string

    任意

    ラウドネスレンジ。

    8
    Container

    object

    任意

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

    Format

    string

    任意

    コンテナフォーマット。

    mp4
    MuxConfig

    object

    任意

    多重化設定。

    Segment

    object

    任意

    セグメント設定。

    Duration

    string

    任意

    セグメント期間。

    10
    ForceSegTime

    string

    任意

    強制セグメントタイムポイント。

    2,3
    TransConfig

    object

    任意

    条件付きトランスコーディングパラメーター。

    TransMode

    string

    任意

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

    • onepass：アダプティブビットレート (ABR) ストリーミングに使用されます。エンコーディングは twopass よりも高速です。

    • twopass：可変ビットレート (VBR) ストリーミングに使用されます。エンコーディングは onepass よりも低速です。

    • CBR：固定ビットレートモード。

    デフォルト値：onepass。

    onepass
    IsCheckReso

    string

    任意

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail は相互排他的です。IsCheckResoFail が優先されます。

    • true：解像度を確認します。入力ビデオの解像度 (幅または高さ) が出力設定よりも小さい場合、入力解像度でトランスコーディングします。

    • false：解像度を確認しません。

    デフォルト値：false。

    true
    IsCheckResoFail

    string

    任意

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail は相互排他的です。IsCheckResoFail が優先されます。

    • true：解像度を確認します。入力ビデオの解像度 (幅または高さ) が出力設定よりも小さい場合、失敗を返します。

    • false：解像度を確認しません。

    デフォルト値：false。

    true
    IsCheckVideoBitrate

    string

    任意

    ビデオビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他的です。IsCheckVideoBitrateFail が優先されます。

    • true：ビットレートを確認します。入力ビデオのビットレートが出力設定よりも低い場合、入力ビットレートでトランスコーディングします。

    • false：ビットレートを確認しません。

    デフォルト値：false。

    true
    IsCheckVideoBitrateFail

    string

    任意

    ビデオビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他的です。IsCheckVideoBitrateFail が優先されます。

    • true：ビットレートを確認します。入力ビデオのビットレートが出力設定よりも低い場合、失敗を返します。

    • false：ビットレートを確認しません。

    デフォルト値：false。

    true
    IsCheckAudioBitrate

    string

    任意

    オーディオビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他的です。IsCheckAudioBitrateFail が優先されます。

    • true：ビットレートを確認します。入力オーディオのビットレートが出力設定よりも低い場合、入力ビットレートでトランスコーディングします。

    • false：ビットレートを確認しません。

    デフォルト値：

    • 空で、コーデックが入力ソースと異なる場合：false。

    • 空で、コーデックが入力ソースと一致する場合：true。

    true
    IsCheckAudioBitrateFail

    string

    任意

    オーディオビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他的です。IsCheckAudioBitrateFail が優先されます。

    • true：ビットレートを確認します。入力オーディオのビットレートが出力設定よりも低い場合、失敗を返します。

    • false：ビットレートを確認しません。

    デフォルト値：false。

    true
    AdjDarMethod

    string

    任意

    表示アスペクト比を調整するために使用されるメソッド。このパラメーターは、Width と Height の両方が指定されている場合にのみ有効です。LongShortMode と一緒に使用できます。

    有効な値：rescale、crop、pad、none。

    デフォルト値：none。

    none
    ImageWatermarks

    array<object>

    任意

    画像ウォーターマーク設定。

    array<object>

    任意

    画像ウォーターマーク設定。

    TemplateId

    string

    必須

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    任意

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Width

    string

    任意

    出力ビデオ上の画像ウォーターマークの幅。値は次のいずれかになります：

    • 整数：ウォーターマーク画像のピクセル幅。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの幅に対するウォーターマークの幅の比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    32
    Height

    string

    任意

    出力ビデオ上の画像ウォーターマークの高さ。値は次のいずれかになります：

    • 整数：ウォーターマーク画像のピクセル高さ。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの高さに対するウォーターマークの高さの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    32
    Dx

    string

    任意

    出力ビデオに対する画像ウォーターマークの水平オフセット。デフォルト値：0。

    値は次のいずれかになります：

    • 整数：ピクセル単位のオフセット。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの幅に対する水平オフセットの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    10
    Dy

    string

    任意

    出力ビデオに対する画像ウォーターマークの垂直オフセット。デフォルト値：0。

    値は次のいずれかになります：

    • 整数：ピクセル単位のオフセット。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの高さに対する垂直オフセットの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    10
    ReferPos

    string

    任意

    ウォーターマークの位置。

    • 有効な値：TopRight (右上)、TopLeft (左上)、BottomRight (右下)、BottomLeft (左下)。

    • デフォルト値：TopRight。

    TopLeft
    Timeline

    object

    任意

    動的ウォーターマークの表示時間設定。

    Start

    string

    任意

    ウォーターマークの開始時刻。

    • 単位：秒

    • 有効な値：数値

    • デフォルト値：0

    00:00:05
    Duration

    string

    任意

    ウォーターマークの持続時間。

    • 有効な値：[数値, ToEND]

    • デフォルト値：ToEND

    ToEND
    File

    object

    任意

    ウォーターマーク画像ファイル。

    Type

    string

    任意

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    任意

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    TextWatermarks

    array<object>

    任意

    テキストウォーターマーク設定。

    array<object>

    任意

    テキストウォーターマーク設定。

    TemplateId

    string

    必須

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    任意

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Content

    string

    任意

    ウォーターマークテキスト。Base64 エンコードする必要はありません。文字列は UTF-8 でエンコードする必要があります。

    测试水印
    FontName

    string

    任意

    フォント。デフォルト：SimSun。

    SimSun
    FontColor

    string

    任意

    色。

    #006400
    FontAlpha

    string

    任意

    フォントの透明度。

    • 有効な値：(0, 1]

    • デフォルト：1.0

    1.0
    Top

    string

    任意

    テキストの上マージン。

    • デフォルト：0

    • 有効な値：[0, 4096]

    10
    Left

    string

    任意

    テキストの左マージン。

    • デフォルト：0

    • 有効な値：[0, 4096]

    10
    FontSize

    integer

    任意

    フォントサイズ。

    • デフォルト値：16

    • 有効な値：(4, 120)

    16
    BorderWidth

    integer

    任意

    アウトライン幅。

    • デフォルト：0

    • 有効な値：(0, 4096]

    0
    BorderColor

    string

    任意

    アウトラインカラー。デフォルト：黒。その他の値については、BorderColor をご参照ください。

    #006400
    Adaptive

    string

    任意

    出力ビデオのサイズに基づいてフォントサイズを調整します。有効な値：true または false。デフォルト：false。

    false
    Subtitles

    array<object>

    任意

    字幕焼き付け設定。

    array<object>

    任意

    字幕焼き付け設定。

    TemplateId

    string

    必須

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    任意

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Format

    string

    任意

    字幕ファイル形式。

    vtt
    CharEnc

    string

    任意

    ファイルエンコーディング形式。

    UTF-8
    File

    object

    任意

    字幕ファイル。

    Type

    string

    任意

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    任意

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    Encryption

    object

    任意

    暗号化設定。

    EncryptType

    string

    任意

    暗号化タイプ。有効な値：

    • PrivateEncryption：Alibaba Cloud 専用の暗号化。

    • HLSEncryption：HLS 標準暗号化。

    PrivateEncryption
    CipherText

    string

    任意

    標準暗号化のためのキーの暗号文。

    MTYi00NDU0LTg5O****
    DecryptKeyUri

    string

    任意

    標準暗号化のための復号サービスエンドポイント。

    https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
    KeyServiceType

    string

    任意

    標準暗号化のためのキーサービスタイプ。有効な値：

    • KMS

    • Base64

    KMS
    CombineConfigs

    array<object>

    任意

    複数入力のマージ設定。

    object

    任意

    マージ設定。

    AudioIndex

    string

    必須

    音声ストリームインデックス。

    0 或 exclude
    VideoIndex

    string

    必須

    ビデオストリームインデックス。

    0 或 exclude
    Start

    number

    任意

    入力ストリームの開始時刻。デフォルト：0。

    0.0
    Duration

    number

    任意

    入力ストリームの持続時間。デフォルト：ビデオの持続時間。

    20.0
    UserData

    string

    任意

    JSON 形式のカスタム設定。長さは 512 バイトに制限されています。カスタム Webhook アドレス設定をサポートします。

    user-data
    ScheduleConfig

    object

    任意

    ジョブのスケジューリング情報。

    job-name
    PipelineId

    string

    任意

    MPS キュー ID。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    任意

    ジョブの優先度。数値が大きいほど優先度が高くなります。有効な値：1～10。

    5
    ClientToken

    string

    任意

    べき等性キー。リクエストのべき等性を保証します。

    ****12e8864746a0a398****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

    31E30781-9495-5E2D-A84D-759B0A01E262
    TranscodeParentJob

    object

    TranscodeParentJobWithSubJobDTO

    TranscodeJobList

    array<object>

    サブジョブのリスト。

    array<object>

    サブジョブの詳細。

    CreateTime

    string

    ジョブが作成された時刻。

    2022-01-12T08:49:41Z
    Name

    string

    ジョブ名。

    transcode-job
    ParentJobId

    string

    親ジョブ ID。

    8b2198504dd340b7b3c9842a74fc9baa
    JobId

    string

    サブジョブ ID。

    7d6a7e0d4db2457a8d45ff5d43e1bf0a
    JobIndex

    integer

    ジョブ全体におけるサブジョブのインデックス。

    0
    InputGroup

    array<object>

    ジョブの入力グループ。単一の入力はトランスコーディングジョブを作成します。複数の入力はメディアマージジョブを作成します。

    object

    ジョブ入力。

    Type

    string

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    InputUrl

    string

    入力ストリームパス：

    • このパラメーターは、Type が Media の場合にのみ有効です。メディアアセットから特定のファイルを入力として選択できます。

    • システムは、入力 URL がメディアアセットに存在するかどうかを確認します。

    oss://bucket/path/to/video.mp4

    ProcessConfig

    object

    トランスコーディング処理設定。

    Transcode

    object

    トランスコーディング設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Video

    object

    ビデオ設定。

    Codec

    string

    エンコード形式。

    H.264
    Profile

    string

    エンコードプロファイル。有効な値：baseline、main、high。

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

    • main：標準解像度デバイス向け。

    • high：高解像度デバイス向け。

    デフォルト値：high。

    Main
    Bitrate

    string

    平均ビデオビットレート。

    • 有効な値：[10, 50000]。

    • 単位：Kbps。

    3000
    Crf

    string

    固定レート係数 (CRF)。品質とビットレートのトレードオフを制御します。

    • 有効な値：[0, 51]。

    • デフォルト値：H.264 の場合は 23、H.265 の場合は 26。

    Crf を設定した場合、Bitrate の設定は無視されます。

    23
    Width

    string

    幅。

    • 有効な値：[128, 4096]。

    • 単位：px。

    • デフォルト値：元のビデオの幅。

    1920
    Height

    string

    高さ。

    • 有効な値：[128, 4096]。

    • 単位：px。

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

    1080
    Fps

    string

    フレームレート。

    • 有効な値：(0, 60]。

    • 入力ファイルのフレームレートが 60 を超える場合、システムは 60 を使用します。

    • デフォルト値：入力ファイルのフレームレート。

    25
    Gop

    string

    キーフレーム間の最大フレーム数。

    • 有効な値：[1, 1080000]。

    • デフォルト値：250。

    250
    Preset

    string

    ビデオエンコーダープリセット。H.264 のみがこのパラメーターをサポートします。有効な値：veryfast、fast、medium、slow、slower。デフォルト値：medium。

    medium
    ScanMode

    string

    スキャンモード。有効な値：interlaced および progressive。

    progressive
    PixFmt

    string

    ビデオカラーフォーマット。有効な値には yuv420p および yuvj420p が含まれます。

    yuv420p
    Remove

    string

    ビデオを削除するかどうかを指定します。

    false
    Crop

    string

    ビデオクロッピング方法。2つのオプションがあります。

    • 黒枠を自動的に検出してクロップします。これを border に設定します。

    • カスタムクロッピング。フォーマット：width:height:left:top。例：1280:800:0:140

    1280:800:0:140
    Pad

    string

    黒枠のパディング設定。

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

    • 例：1280:800:0:140

    1280:800:0:140
    LongShortMode

    string

    縦向きまたは横向きのビデオの自動回転（長辺/短辺モードとも呼ばれる）を有効にするかどうかを指定します。

    false
    Bufsize

    string

    バッファサイズ。

    • 有効な値：[1000, 128000]

    • デフォルト値：6000

    • 単位：Kb

    6000
    Maxrate

    string

    ピークビデオビットレート。有効な値：[10, 50000]。単位：Kbps。

    9000
    AbrMax

    string

    アダプティブビットレートストリーミング (ABR) の最大ビットレート。これはナローバンド HD 1 にのみ適用されます。有効な値：[10, 50000]。単位：Kbps。

    6000
    Audio

    object

    オーディオ設定。

    Codec

    string

    オーディオコーデック。有効な値：AAC、MP3、VORBIS、FLAC。デフォルト値：AAC。

    AAC
    Profile

    string

    オーディオエンコーディングプロファイル。Codec が AAC の場合、有効な値は aac_low、aac_he、aac_he_v2、aac_ld、aac_eld です。

    aac_low
    Samplerate

    string

    サンプルレート。

    • デフォルト値：44100

    • 有効な値：22050、32000、44100、48000、96000。

    • 単位：Hz

    44100
    Bitrate

    string

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

    • 有効な値：[8, 1000]

    • 単位：Kbps

    • デフォルト値：128

    128
    Channels

    string

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

    2
    Remove

    string

    音声ストリームを削除するかどうかを指定します。

    false
    Volume

    object

    音量コントロール。

    Method

    string

    音量調整方法。

    auto
    IntegratedLoudnessTarget

    string

    ターゲットラウドネスレベル。

    -6
    TruePeak

    string

    トゥルーピークレベル。

    -1
    LoudnessRangeTarget

    string

    ラウドネスレンジ。

    8
    Container

    object

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

    Format

    string

    コンテナフォーマット。

    mp4
    MuxConfig

    object

    多重化設定。

    Segment

    object

    セグメント設定。

    Duration

    string

    セグメント期間。

    10
    ForceSegTime

    string

    強制セグメントタイムポイント。

    2,3
    TransConfig

    object

    条件付きトランスコーディングパラメーター。

    TransMode

    string

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

    • onepass (デフォルト)：ABR に使用されます。エンコーディングは twopass よりも高速です。

    • twopass：VBR に使用されます。エンコーディングは onepass よりも低速です。

    • CBR：固定ビットレートモード。

    onepass
    IsCheckReso

    string

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail は相互排他的です。IsCheckResoFail が優先されます。

    • true：解像度を確認します。入力ビデオの解像度 (幅または高さ) が出力設定よりも小さい場合、入力解像度でトランスコーディングします。

    • false (デフォルト)：解像度を確認しません。

    true
    IsCheckResoFail

    string

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail は相互排他的です。このパラメーターが優先されます。

    • true：解像度を確認します。入力ビデオの解像度 (幅または高さ) が出力設定よりも小さい場合、失敗を返します。

    • false (デフォルト)：解像度を確認しません。

    true
    IsCheckVideoBitrate

    string

    ビデオビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他的です。IsCheckVideoBitrateFail が優先されます。

    • true：ビットレートを確認します。入力ビデオのビットレートが出力設定よりも低い場合、入力ビットレートでトランスコーディングします。

    • false (デフォルト)：ビットレートを確認しません。

    true
    IsCheckVideoBitrateFail

    string

    ビデオビットレートを確認するかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail は相互排他的です。このパラメーターが優先されます。

    • true：ビットレートを確認します。入力ビデオのビットレートが出力設定よりも低い場合、失敗を返します。

    • false (デフォルト)：ビットレートを確認しません。

    true
    IsCheckAudioBitrate

    string

    オーディオビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他的です。IsCheckAudioBitrateFail が優先されます。

    • true：ビットレートを確認します。入力オーディオのビットレートが出力設定よりも低い場合、入力ビットレートでトランスコーディングします。

    • false：ビットレートを確認しません。

    デフォルト値のルール：

    • 空で、コーデックが入力ソースと異なる場合：false。

    • 空で、コーデックが入力ソースと一致する場合：true。

    true
    IsCheckAudioBitrateFail

    string

    オーディオビットレートを確認するかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail は相互排他的です。このパラメーターが優先されます。

    • true：ビットレートを確認します。入力オーディオのビットレートが出力設定よりも低い場合、失敗を返します。

    • false (デフォルト)：ビットレートを確認しません。

    true
    AdjDarMethod

    string

    表示アスペクト比を調整するために使用されるメソッド。このパラメーターは、Width と Height の両方が指定されている場合にのみ有効です。LongShortMode と一緒に使用できます。

    有効な値：rescale、crop、pad、none。

    デフォルト値：none。

    none
    ImageWatermarks

    array<object>

    画像ウォーターマーク設定。

    array<object>

    画像ウォーターマーク設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Width

    string

    出力ビデオ上の画像ウォーターマークの幅。値は次のいずれかになります：

    • 整数：ウォーターマーク画像のピクセル幅。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの幅に対するウォーターマークの幅の比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    32
    Height

    string

    出力ビデオ上の画像ウォーターマークの高さ。値は次のいずれかになります：

    • 整数：ウォーターマーク画像のピクセル高さ。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの高さに対するウォーターマークの高さの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    32
    Dx

    string

    出力ビデオに対する画像ウォーターマークの水平オフセット。デフォルト値：0。

    値は次のいずれかになります：

    • 整数：ピクセル単位のオフセット。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの幅に対する水平オフセットの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    10
    Dy

    string

    出力ビデオに対する画像ウォーターマークの垂直オフセット。デフォルト値：0。

    値は次のいずれかになります：

    • 整数：ピクセル単位のオフセット。

      • 有効な値：[8, 4096]

      • 単位：px

    • 10 進数：出力ビデオの高さに対する垂直オフセットの比率。

      • 有効な値：(0, 1)

      • 小数点以下 4 桁までサポートされます (例：0.9999)。余分な桁は自動的に破棄されます。

    10
    ReferPos

    string

    ウォーターマークの位置。

    • 有効な値：TopRight (右上)、TopLeft (左上)、BottomRight (右下)、BottomLeft (左下)。

    • デフォルト値：TopRight。

    TopLeft
    Timeline

    object

    動的ウォーターマークの表示時間設定。

    Start

    string

    ウォーターマークの開始時刻。

    • 単位：秒

    • 有効な値：数値

    • デフォルト値：0

    00:00:05
    Duration

    string

    ウォーターマークの持続時間。

    • 有効な値：[数値, ToEND]

    • デフォルト値：ToEND

    ToEND
    File

    object

    ウォーターマーク画像ファイル。

    Type

    string

    メディアオブジェクトタイプ。有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディア値：

    • Type が OSS の場合、これは OSS または HTTP プロトコルをサポートする URL です。

    • Type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    TextWatermarks

    array<object>

    テキストウォーターマーク設定。

    array<object>

    テキストウォーターマーク設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Content

    string

    ウォーターマークテキスト。Base64 エンコードする必要はありません。文字列は UTF-8 でエンコードする必要があります。

    测试水印
    FontName

    string

    フォント。デフォルト：SimSun。

    SimSun
    FontColor

    string

    色。

    #006400
    FontAlpha

    string

    フォントの透明度。

    • 有効な値：(0, 1]

    • デフォルト：1.0

    1.0
    Top

    string

    テキストの上マージン。

    • デフォルト：0

    • 有効な値：[0, 4096]

    10
    Left

    string

    テキストの左マージン。

    • デフォルト：0

    • 有効な値：[0, 4096]

    10
    FontSize

    integer

    フォントサイズ。

    • デフォルト値：16

    • 有効な値：(4, 120)

    16
    BorderWidth

    integer

    アウトライン幅。

    • デフォルト：0

    • 有効値：(0,4096]

    0
    BorderColor

    string

    アウトラインカラー。 デフォルト：黒。 その他の値については、BorderColor をご参照ください。

    #006400
    Adaptive

    string

    出力ビデオのサイズに基づいてフォントサイズを調整します。デフォルトは false です。

    false
    Subtitles

    array<object>

    字幕の焼き付けに関する設定。

    array<object>

    字幕の焼き付けに関する設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きするパラメーター。これらを指定すると、テンプレート内の対応するパラメーターが置き換えられます。

    Format

    string

    字幕のファイル形式。

    vtt
    CharEnc

    string

    ファイルのエンコーディング形式。

    UTF-8
    File

    object

    字幕ファイル。

    Type

    string

    メディアオブジェクトのタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセットの ID。

    OSS
    Media

    string

    Media の値：

    • type が OSS の場合、値は URL です。URL は OSS および HTTP プロトコルをサポートします。

    • type が Media の場合、値はメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    Encryption

    object

    暗号化設定。

    EncryptType

    string

    暗号化タイプ。

    PrivateEncryption
    CipherText

    string

    標準暗号化のためのキーの暗号文。

    MTYi00NDU0LTg5O****
    DecryptKeyUri

    string

    標準暗号化のための復号サービスエンドポイント。

    https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
    KeyServiceType

    string

    キーサービスのタイプ。KMS と Base64 のみがサポートされています。

    KMS
    CombineConfigs

    array<object>

    複数の入力ストリームを混合するための設定。

    object

    ストリーム結合設定。

    AudioIndex

    string

    音声ストリームのインデックス。

    0 或 exclude
    VideoIndex

    string

    ビデオストリームのインデックス。

    0 或 exclude
    Start

    number

    入力ストリームの開始時刻。デフォルト値は 0 です。

    0.0
    Duration

    number

    入力ストリームの持続時間。デフォルト値はビデオの持続時間です。

    20.0
    Output

    object

    出力メディア設定。

    Type

    string

    メディアオブジェクトタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディアアセットの値：

    • type が OSS の場合、値は URL です。OSS および HTTP プロトコルがサポートされています。

    • type が Media の場合、値はメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    OutputUrl

    string

    出力ストリームのパス。
    このパラメーターは `Type` が `Media` に設定されている場合にのみ有効です。メディアアセットから特定のファイルを出力用に選択できます。
    以下のプレースホルダーがサポートされています：




    • {MediaId}：メディアアセットの ID。

    • {JobId}：トランスコーディングサブタスクの ID。

    • {MediaBucket}：メディアアセットが保存されているバケット。

    • {ExtName}：ファイル拡張子。値はトランスコーディングテンプレートで指定された出力フォーマットです。

    • {DestMd5}：出力ファイルの MD5 ハッシュ。
      注意：

    1. このパラメーターには {MediaId} と {JobId} のプレースホルダーを含める必要があります。

    2. 出力バケットは、メディアアセットが保存されているバケットと同じです。

    oss://bucket/path/to/{MediaId}/{JobId}.mp4

    UserData

    string

    ユーザーデータ。

    user-data
    ScheduleConfig

    object

    ジョブのスケジューリング情報。

    PipelineId

    string

    パイプラインの ID。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    タスクの優先度。値が大きいほど優先度が高くなります。値は 1 から 10 までの整数です。

    5
    Status

    string

    トランスコーディングジョブのステータス。

    • Init：ジョブが送信されました。

    • Processing：ジョブはトランスコード中です。

    • Success：トランスコーディングは成功しました。

    • Fail：トランスコーディングは失敗しました。

    • Deleted：ジョブは削除されました。

    Init
    OutFileMeta

    object

    ジョブによって生成されたビデオのメディア情報。

    FileBasicInfo

    object

    基本的なファイル情報。

    MediaId

    string

    メディアアセット ID。

    73e07de0f77171eca3fc7035d0b26402
    FileName

    string

    ファイルの名前。

    file.m3u8
    FileStatus

    string

    ファイルの状態。

    Normal
    FileType

    string

    ファイルタイプ。有効な値：source_file および transcode_file。

    source_file
    FileSize

    string

    ファイルのサイズ (バイト単位)。

    31737
    FileUrl

    string

    ファイルの URL。

    http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
    Region

    string

    ファイルが配置されているリージョン。

    cn-shanghai
    FormatName

    string

    ビデオフォーマットの名前。

    hls,applehttp
    Duration

    string

    ビデオの持続時間 (秒単位)。

    403.039999
    Bitrate

    string

    ビデオビットレート。

    888.563
    Width

    string

    出力ファイルの幅。

    848
    Height

    string

    高さ。

    478
    AudioStreamInfoList

    array<object>

    音声ストリーム情報。

    object

    音声ストリーム情報。

    Index

    string

    ストリームのインデックス。

    1
    CodecName

    string

    エンコード形式。

    aac
    CodecLongName

    string

    エンコード形式の名前。

    AAC (Advanced Audio Coding)
    CodecTimeBase

    string

    エンコーダーのタイムベース。

    1/44100
    CodecTagString

    string

    エンコーダータグ名。

    [15][0][0][0]
    CodecTag

    string

    エンコーダータグ。

    0x000f
    SampleFmt

    string

    サンプリングフォーマット。

    fltp
    SampleRate

    string

    サンプルレート (Hz)。

    44100
    Channels

    string

    サウンドチャンネルの数。

    2
    ChannelLayout

    string

    チャンネルレイアウト。

    stereo
    Timebase

    string

    タイムベース。

    1/90000
    StartTime

    string

    開始時刻。

    1.473556
    Duration

    string

    持続時間 (秒単位)。

    403.039989
    Bitrate

    string

    ビットレート。

    0.f
    Lang

    string

    言語。

    cn
    VideoStreamInfoList

    array<object>

    ビデオストリーム情報。

    object

    ビデオストリーム情報。

    Index

    string

    ストリームのインデックス。

    0
    Codec_name

    string

    エンコード形式。

    h264
    Codec_long_name

    string

    エンコード形式の名前。

    H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
    Profile

    string

    エンコーダープリセット。

    High
    Codec_time_base

    string

    コーデックタイムベース。

    1/50
    Codec_tag_string

    string

    エンコード形式タグのテキスト。

    [27][0][0][0]
    Codec_tag

    string

    エンコード形式タグ。

    0x001b
    Width

    string

    ビデオの幅。

    848
    Height

    string

    出力ビデオストリームの高さ。

    478
    Has_b_frames

    string

    B フレームが存在するかどうかを示します。 有効な値：

    • 0：B フレームなし。

    • 1：1 つの B フレーム。

    • 2：複数の連続した B フレーム。

    2
    Sar

    string

    サンプルアスペクト比。

    478:477
    Dar

    string

    アスペクト比の表示。

    16:9
    PixFmt

    string

    色保存形式。

    yuv420p
    Level

    string

    エンコードレベル。

    31
    Fps

    string

    フレームレート。

    25.0
    Avg_fps

    string

    平均フレームレート。

    25.0
    Time_base

    string

    タイムベース。

    1/90000
    Start_time

    string

    開始時刻。

    1.473556
    Duration

    string

    持続時間 (秒単位)。

    403.039989
    Bit_rate

    string

    ビットレート。

    888.563
    NumFrames

    string

    総フレーム数。

    10040
    Lang

    string

    言語。

    cn
    Rotate

    string

    ビデオの回転角度。有効な値：0、90、180、270。デフォルト値は 0 です。

    0
    SubmitResultJson

    object

    ジョブ送信の結果。

    {}
    SubmitTime

    string

    ジョブが送信された時刻。

    2022-01-12T08:49:41Z
    FinishTime

    string

    ジョブが完了した時刻。

    2022-01-12T08:49:41Z
    RequestId

    string

    ジョブを送信するリクエストの ID。

    31E30781-9495-5E2D-A84D-759B0A01E262
    CreateTime

    string

    ジョブが作成された時刻。フォーマットは yyyy-MM-ddTHH:mm:ssZ です。

    2022-01-12T08:49:41Z
    Name

    string

    ジョブの名前。

    transcode-job
    RequestId

    string

    リクエストの ID。

    31E30781-9495-5E2D-A84D-759B0A01E262
    ParentJobId

    string

    親ジョブの ID。

    8b2198504dd340b7b3c9842a74fc9baa
    JobCount

    integer

    サブジョブの数。

    1
    Status

    string

    ジョブのステータス。Success：すべてのサブジョブが完了した後、少なくとも 1 つのサブジョブが成功しました。Fail：すべてのサブジョブが失敗しました。

    Success
    TriggerSource

    string

    ジョブのソース。有効な値：`API`、`WorkFlow`、`Console`。

    API
    Percent

    integer

    ジョブの完了率。

    0
    SubmitTime

    string

    ジョブが送信された時刻。フォーマットは yyyy-MM-ddTHH:mm:ssZ です。

    2022-01-12T08:49:41Z
    FinishTime

    string

    ジョブが完了した時刻。フォーマットは yyyy-MM-ddTHH:mm:ssZ です。

    2022-01-12T08:49:41Z
    InputGroup

    array<object>

    ジョブの入力グループ。単一の入力はトランスコーディングジョブを作成します。複数の入力は音声とビデオストリームをマージするジョブを作成します。

    object

    ジョブ入力。

    Type

    string

    メディアオブジェクトのタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディアアセットの値：

    • type が OSS の場合、これは URL です。OSS と HTTP の両方のプロトコルがサポートされています。

    • type が Media の場合、これはメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    OutputGroup

    array<object>

    ジョブの出力グループ。

    array<object>

    ジョブ出力。

    Output

    object

    出力メディア設定。

    Type

    string

    メディアオブジェクトタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディアアセットの値：

    • type が OSS に設定されている場合、値は URL です。OSS および HTTP プロトコルがサポートされています。

    • type が Media に設定されている場合、値はメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    ProcessConfig

    object

    ジョブ処理設定。

    Transcode

    object

    トランスコーディング設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きパラメーター。指定した場合、これらのパラメーターはテンプレート内の対応するパラメーターを上書きします。

    Video

    object

    ビデオ設定

    Codec

    string

    エンコード形式。

    H.264
    Profile

    string

    エンコードプロファイル。 サポートされている値は baseline、main、high です。

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

    • main：標準解像度デバイス向け。

    • high：高解像度デバイス向け。

    デフォルト値：high。

    Main
    Bitrate

    string

    平均ビデオビットレート。

    • 値の範囲：[10, 50000]。

    • 単位：Kbps。

    3000
    Crf

    string

    固定レート係数 (CRF)。

    • 値は 0 から 51 までです。

    • デフォルト値は H264 エンコーディングで 23、H265 エンコーディングで 26 です。

    Crf を設定した場合、Bitrate の設定は無視されます。

    23
    Width

    string

    出力ビデオの幅。

    • 有効な値：128 から 4096。

    • 単位：px。

    • デフォルト値：ビデオの元の幅。

    1920
    Height

    string

    ビデオの高さ。

    • 有効な値：[128, 4096]。

    • 単位：px。

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

    1080
    Fps

    string

    フレームレート。

    • 有効な値：(0, 60]。

    • 入力ファイルのフレームレートが 60 を超える場合、フレームレートは 60 に制限されます。

    • デフォルト：入力ファイルのフレームレート。

    25
    Gop

    string

    2 つのキーフレーム間の最大フレーム数。

    • 値は [1, 1080000] の範囲内である必要があります。

    • デフォルト値は 250 です。

    250
    Preset

    string

    ビデオアルゴリズムプリセット。このパラメーターは H.264 でのみサポートされています。サポートされている値は veryfast、fast、medium、slow、slower です。デフォルト値は medium です。

    medium
    ScanMode

    string

    スキャンモード。有効な値はインターレースとプログレッシブです。

    progressive
    PixFmt

    string

    ビデオのピクセルフォーマット。yuv420p や yuvj420p などの標準フォーマットを含む有効な値。

    yuv420p
    Remove

    string

    ビデオを削除するかどうかを指定します。

    false
    Crop

    string

    ビデオフレームを切り抜きます。 2 つの方法があります。

    • 黒枠を自動的に検出して切り抜くには、パラメーターを「border」に設定します。

    • カスタムの切り抜き領域を指定するには、width:height:left:top 形式を使用します。 例：1280:800:0:140

    1280:800:0:140
    Pad

    string

    ビデオに黒枠を追加します。

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

    • 例：1280:800:0:140

    1280:800:0:140
    LongShortMode

    string

    横向きと縦向きの自動回転を有効にするかどうかを指定します (長辺と短辺のパターン)。

    false
    Bufsize

    string

    バッファサイズ。

    • 値の範囲：[1000, 128000]

    • デフォルト値：6000

    • 単位：Kb

    6000
    Maxrate

    string

    ピークビデオビットレート。

    • 値の範囲：[10, 50000]

    • 単位：Kbps

    9000
    AbrMax

    string

    アダプティブビットレート (ABR) ストリーミングの最大ビットレート。このパラメーターはナローバンド HD 1.0 でのみ有効です。

    • 値の範囲：[10, 50000]

    • 単位：Kbps

    6000
    Audio

    object

    オーディオ設定。

    Codec

    string

    オーディオコーデック形式。有効な値は AAC、MP3、VORBIS、FLAC です。 デフォルト値：AAC

    AAC
    Profile

    string

    オーディオエンコーディングプリセット。 Codec が AAC に設定されている場合、有効な値は aac_low、aac_he、aac_he_v2、aac_ld、aac_eld です。

    aac_low
    Samplerate

    string

    サンプルレート。

    • デフォルト値：44100。有効な値：22050、32000、44100、48000、96000。

    • 単位：Hz

    44100
    Bitrate

    string

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

    • 値の範囲：[8, 1000]

    • 単位：Kbps

    • デフォルト値：128

    128
    Channels

    string

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

    2
    Remove

    string

    音声ストリームを削除するかどうかを指定します。

    false
    Volume

    object

    音量コントロール設定。

    Method

    string

    音量調整方法。

    auto
    IntegratedLoudnessTarget

    string

    ターゲット音量。

    -6
    TruePeak

    string

    トゥルーピーク。

    -1
    LoudnessRangeTarget

    string

    ラウドネスレンジ。

    8
    Container

    object

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

    Format

    string

    コンテナフォーマット。

    mp4
    MuxConfig

    object

    カプセル化設定。

    Segment

    object

    セグメント設定。

    Duration

    string

    セグメントの長さ。

    10
    ForceSegTime

    string

    強制セグメンテーションの時間ポイント。

    2,3
    TransConfig

    object

    条件付きトランスコーディングパラメーター。

    TransMode

    string

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

    • onepass：通常、ABR に使用されます。エンコーディング速度は twopass よりも高速です。

    • twopass：通常、VBR に使用されます。エンコーディング速度は onepass よりも低速です。

    • CBR：固定ビットレートモード。

    デフォルト値：onepass。

    onepass
    IsCheckReso

    string

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso と IsCheckResoFail パラメーターは相互排他的です。IsCheckResoFail が優先されます。

    • true：解像度チェックを有効にします。入力ビデオの解像度 (幅または高さ) が出力解像度よりも低い場合、トランスコーディングジョブは入力解像度を使用します。

    • false：解像度チェックを無効にします。

    デフォルト値：false。

    true
    IsCheckResoFail

    string

    ビデオ解像度を確認するかどうかを指定します。IsCheckReso または IsCheckResoFail のいずれかを使用できますが、両方は使用できません。このパラメーターが優先されます。

    • true：解像度を確認します。入力ビデオの幅または高さが出力解像度よりも小さい場合、トランスコーディングジョブは失敗します。

    • false：解像度を確認しません。

    デフォルト値：false。

    true
    IsCheckVideoBitrate

    string

    ビデオビットレートを確認するかどうかを指定します。IsCheckVideoBitrate または IsCheckVideoBitrateFail のいずれかを設定できます。IsCheckVideoBitrateFail が優先されます。

    • true：ビットレートを確認します。入力ビデオのビットレートが出力ビットレートよりも低い場合、ビデオは入力ビットレートでトランスコーディングされます。

    • false：ビットレートを確認しません。

    デフォルト値：false。

    true
    IsCheckVideoBitrateFail

    string

    ビデオビットレートを確認するかどうかを指定します。このパラメーターと IsCheckVideoBitrate は相互排他的です。IsCheckVideoBitrateFail が優先されます。

    • true：チェックを有効にします。入力ビデオのビットレートが出力ビットレート設定よりも低い場合、トランスコーディングジョブは失敗します。

    • false：チェックを無効にします。

    デフォルト値：false。

    true
    IsCheckAudioBitrate

    string

    オーディオビットレートを確認するかどうかを指定します。このパラメーターまたは IsCheckAudioBitrateFail のいずれかを設定できます。IsCheckAudioBitrateFail が優先されます。

    • true：オーディオビットレートを確認します。入力オーディオビットレートが設定された出力ビットレートよりも低い場合、サービスはトランスコーディングに入力オーディオビットレートを使用します。

    • false：オーディオビットレートを確認しません。

    デフォルト値：

    • false：このパラメーターが空で、出力コーデックが入力コーデックと異なる場合。

    • true：このパラメーターが空で、出力コーデックが入力コーデックと同じ場合。

    true
    IsCheckAudioBitrateFail

    string

    オーディオビットレートを確認するかどうかを指定します。IsCheckAudioBitrate または IsCheckAudioBitrateFail のいずれかを設定できます。このパラメーターが優先されます。

    • true：入力オーディオビットレートが出力ビットレート設定よりも低い場合、トランスコーディングジョブは失敗します。

    • false：オーディオビットレートは確認されません。

    デフォルト値：false。

    true
    AdjDarMethod

    string

    解像度を調整する方法。この設定は、Width と Height の両方が指定されている場合にのみ有効です。LongShortMode と一緒に使用できます。

    有効な値：rescale、crop、pad、none。

    デフォルト値：none。

    none
    ImageWatermarks

    array<object>

    画像ウォーターマーク設定。

    array<object>

    画像ウォーターマーク設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    指定した場合、これらのパラメーターはテンプレート内の対応するパラメーターを上書きします。

    Width

    string

    出力ビデオ上のウォーターマーク画像の幅。 値は 2 つの形式で指定できます：

    • ウォーターマーク画像の幅をピクセルで指定する整数。

      • 範囲：[8, 4096]。

      • 単位：px。

    • 出力ビデオの幅に対するウォーターマークの幅を表す小数。

      • 範囲：(0, 1)。

      • 値は小数点以下 4 桁までサポートされます (例：0.9999)。4 桁を超える桁は自動的に破棄されます。

    32
    Height

    string

    出力ビデオ上の画像ウォーターマークの高さ。 値は 2 つの方法で指定できます：

    • ウォーターマークの高さをピクセルで表す整数。

      • 範囲：[8, 4096]。

      • 単位：px。

    • 出力ビデオの高さに対するウォーターマークの高さを比率で表す小数。

      • 範囲：(0, 1)。

      • 値は小数点以下 4 桁までサポートされます (例：0.9999)。4 桁を超える桁は自動的に破棄されます。

    32
    Dx

    string

    出力ビデオに対するウォーターマーク画像の水平オフセット。 デフォルト：0

    値は 2 つの形式で指定できます：

    • オフセットをピクセルで指定する整数。

      • 範囲：[8, 4096]

      • 単位：px

    • 出力ビデオの幅に対する水平オフセットの比率を指定する小数。

      • 範囲：(0, 1)

      • 値は小数点以下 4 桁まで可能です (例：0.9999)。システムは 4 桁目以降の桁を自動的に破棄します。

    10
    Dy

    string

    出力ビデオに対するウォーターマーク画像の垂直オフセット。 デフォルト値：0。

    値は次の 2 つの形式のいずれかになります：

    • オフセットをピクセルで指定する整数。

      • 範囲：[8, 4096]。

      • 単位：px。

    • 出力ビデオの高さに対する垂直オフセットの比率を指定する小数。

      • 範囲：(0, 1)。

      • 値は小数点以下 4 桁までサポートされます (例：0.9999)。追加の桁は自動的に破棄されます。

    10
    ReferPos

    string

    ウォーターマークの位置。

    • 有効な値：TopRight、TopLeft、BottomRight、BottomLeft。

    • デフォルト値：TopRight。

    TopLeft
    Timeline

    object

    動的ウォーターマークの表示時間設定。

    Start

    string

    ウォーターマークが表示される時間。

    • 単位：秒

    • 値は数値である必要があります。

    • デフォルト値：0

    00:00:05
    Duration

    string

    ウォーターマークの持続時間。

    • 有効な値：[数値, ToEND]

    • デフォルト値：ToEND

    ToEND
    File

    object

    ウォーターマークの画像ファイル。

    Type

    string

    メディアアセットのオブジェクトタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディアアセットの値：

    • type が OSS の場合、値は OSS および HTTP プロトコルをサポートする URL です。

    • type が Media の場合、値はメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    TextWatermarks

    array<object>

    テキストウォーターマーク設定。

    array<object>

    テキストウォーターマーク設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きパラメーター。指定した場合、これらのパラメーターはテンプレート内の対応するパラメーターを上書きします。

    Content

    string

    ウォーターマークテキスト。文字列は UTF-8 でエンコードする必要があります。Base64 エンコーディングは不要です。

    测试水印
    FontName

    string

    フォント。デフォルト：SimSun。

    SimSun
    FontColor

    string

    フォントの色。

    #006400
    FontAlpha

    string

    フォントの透明度。

    • 範囲：(0, 1]。

    • デフォルト：1.0。

    1.0
    Top

    string

    テキストの上マージン。

    • デフォルト：0。

    • 範囲：[0,4096]。

    10
    Left

    string

    テキストの左マージン。

    • デフォルト：0

    • 範囲：[0,4096]

    10
    FontSize

    integer

    フォントサイズ。

    • デフォルト値：16

    • 範囲：(4, 120)

    16
    BorderWidth

    integer

    罫線の幅。

    • デフォルト：0

    • 範囲：(0, 4096]

    0
    BorderColor

    string

    アウトラインカラー。 デフォルト：黒 その他の値については、BorderColor をご参照ください。

    #006400
    Adaptive

    string

    出力ビデオのサイズに基づいてフォントサイズを調整します。

    • 有効な値：true、false

    • デフォルト：false

    false
    Subtitles

    array<object>

    字幕焼き付け設定。

    array<object>

    字幕焼き付け設定。

    TemplateId

    string

    テンプレート ID。

    9547c6ad97cb4f2aaa29683ebd18d410
    OverwriteParams

    object

    上書きパラメーター。指定した場合、これらのパラメーターはテンプレート内の対応するパラメーターを上書きします。

    Format

    string

    字幕ファイル形式。

    vtt
    CharEnc

    string

    ファイルエンコーディング形式。

    UTF-8
    File

    object

    字幕ファイル。

    Type

    string

    メディアオブジェクトのタイプ。 有効な値：

    • OSS：OSS ファイル。

    • Media：メディアアセット ID。

    OSS
    Media

    string

    メディアアセットの値。type が OSS の場合、値は OSS および HTTP プロトコルをサポートする URL です。type が Media の場合、値はメディアアセット ID です。

    oss://bucket/path/to/video.mp4
    Encryption

    object

    暗号化設定。

    EncryptType

    string

    暗号化タイプ。

    PrivateEncryption
    CipherText

    string

    標準暗号化のためのキーの暗号文。

    MTYi00NDU0LTg5O****
    DecryptKeyUri

    string

    標準暗号化の復号エンドポイント。

    https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
    KeyServiceType

    string

    キーサービスのタイプ。KMS と Base64 のみがサポートされています。

    KMS
    CombineConfigs

    array<object>

    複数の入力ストリームを結合するための設定。

    object

    複数の入力ストリームを結合するための設定。

    AudioIndex

    string

    音声ストリームのインデックス。

    0 或 exclude
    VideoIndex

    string

    ビデオストリームのインデックス。

    0 或 exclude
    Start

    number

    入力ストリームの開始時刻。デフォルト値は 0 です。

    0.0
    Duration

    number

    入力ストリームの持続時間。デフォルトでは、これはビデオの持続時間です。

    20.0
    UserData

    string

    ユーザーデータ。

    user-data
    ScheduleConfig

    object

    ジョブスケジューリング設定。

    PipelineId

    string

    パイプライン ID。

    e37ebee5d98b4781897f6086e89f9c56
    Priority

    integer

    ジョブの優先度。値が大きいほど優先度が高くなります。値は 1 から 10 までの整数です。

    5

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "TranscodeParentJob": {
    "TranscodeJobList": [
      {
        "CreateTime": "2022-01-12T08:49:41Z",
        "Name": "transcode-job",
        "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
        "JobId": "7d6a7e0d4db2457a8d45ff5d43e1bf0a",
        "JobIndex": 0,
        "InputGroup": [
          {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4",
            "InputUrl": "oss://bucket/path/to/video.mp4\n"
          }
        ],
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "测试水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 或 exclude",
              "VideoIndex": "0 或 exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        },
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4\n"
        },
        "UserData": "user-data",
        "ScheduleConfig": {
          "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
          "Priority": 5
        },
        "Status": "Init",
        "OutFileMeta": {
          "FileBasicInfo": {
            "MediaId": "73e07de0f77171eca3fc7035d0b26402",
            "FileName": "file.m3u8",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "31737",
            "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
            "Region": "cn-shanghai",
            "FormatName": "hls,applehttp",
            "Duration": "403.039999",
            "Bitrate": "888.563",
            "Width": "848",
            "Height": "478"
          },
          "AudioStreamInfoList": [
            {
              "Index": "1",
              "CodecName": "aac",
              "CodecLongName": "AAC (Advanced Audio Coding)",
              "CodecTimeBase": "1/44100",
              "CodecTagString": "[15][0][0][0]",
              "CodecTag": "0x000f",
              "SampleFmt": "fltp",
              "SampleRate": "44100",
              "Channels": "2",
              "ChannelLayout": "stereo",
              "Timebase": "1/90000",
              "StartTime": "1.473556",
              "Duration": "403.039989",
              "Bitrate": "0.f",
              "Lang": "cn"
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "0",
              "Codec_name": "h264",
              "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "Profile": "High",
              "Codec_time_base": "1/50",
              "Codec_tag_string": "[27][0][0][0]",
              "Codec_tag": "0x001b",
              "Width": "848",
              "Height": "478",
              "Has_b_frames": "2",
              "Sar": "478:477",
              "Dar": "16:9",
              "PixFmt": "yuv420p",
              "Level": "31",
              "Fps": "25.0",
              "Avg_fps": "25.0",
              "Time_base": "1/90000",
              "Start_time": "1.473556",
              "Duration": "403.039989",
              "Bit_rate": "888.563",
              "NumFrames": "10040",
              "Lang": "cn",
              "Rotate": "0"
            }
          ]
        },
        "SubmitResultJson": {},
        "SubmitTime": "2022-01-12T08:49:41Z",
        "FinishTime": "2022-01-12T08:49:41Z",
        "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262"
      }
    ],
    "CreateTime": "2022-01-12T08:49:41Z",
    "Name": "transcode-job",
    "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
    "ParentJobId": "8b2198504dd340b7b3c9842a74fc9baa",
    "JobCount": 1,
    "Status": "Success",
    "TriggerSource": "API",
    "Percent": 0,
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "InputGroup": [
      {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      }
    ],
    "OutputGroup": [
      {
        "Output": {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4"
        },
        "ProcessConfig": {
          "Transcode": {
            "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
            "OverwriteParams": {
              "Video": {
                "Codec": "H.264",
                "Profile": "Main",
                "Bitrate": "3000",
                "Crf": "23",
                "Width": "1920",
                "Height": "1080",
                "Fps": "25",
                "Gop": "250",
                "Preset": "medium",
                "ScanMode": "progressive",
                "PixFmt": "yuv420p",
                "Remove": "false",
                "Crop": "1280:800:0:140",
                "Pad": "1280:800:0:140",
                "LongShortMode": "false",
                "Bufsize": "6000",
                "Maxrate": "9000",
                "AbrMax": "6000"
              },
              "Audio": {
                "Codec": "AAC",
                "Profile": "aac_low",
                "Samplerate": "44100",
                "Bitrate": "128",
                "Channels": "2",
                "Remove": "false",
                "Volume": {
                  "Method": "auto",
                  "IntegratedLoudnessTarget": "-6",
                  "TruePeak": "-1",
                  "LoudnessRangeTarget": "8"
                }
              },
              "Container": {
                "Format": "mp4"
              },
              "MuxConfig": {
                "Segment": {
                  "Duration": "10",
                  "ForceSegTime": "2,3"
                }
              },
              "TransConfig": {
                "TransMode": "onepass",
                "IsCheckReso": "true",
                "IsCheckResoFail": "true",
                "IsCheckVideoBitrate": "true",
                "IsCheckVideoBitrateFail": "true",
                "IsCheckAudioBitrate": "true",
                "IsCheckAudioBitrateFail": "true",
                "AdjDarMethod": "none"
              }
            }
          },
          "ImageWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Width": "32",
                "Height": "32",
                "Dx": "10",
                "Dy": "10",
                "ReferPos": "TopLeft",
                "Timeline": {
                  "Start": "00:00:05",
                  "Duration": "ToEND"
                },
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "TextWatermarks": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Content": "测试水印",
                "FontName": "SimSun",
                "FontColor": "#006400",
                "FontAlpha": "1.0",
                "Top": "10",
                "Left": "10",
                "FontSize": 16,
                "BorderWidth": 0,
                "BorderColor": "#006400",
                "Adaptive": "false"
              }
            }
          ],
          "Subtitles": [
            {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18d410",
              "OverwriteParams": {
                "Format": "vtt",
                "CharEnc": "UTF-8",
                "File": {
                  "Type": "OSS",
                  "Media": "oss://bucket/path/to/video.mp4"
                }
              }
            }
          ],
          "Encryption": {
            "EncryptType": "PrivateEncryption",
            "CipherText": "MTYi00NDU0LTg5O****",
            "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****",
            "KeyServiceType": "KMS"
          },
          "CombineConfigs": [
            {
              "AudioIndex": "0 或 exclude",
              "VideoIndex": "0 或 exclude",
              "Start": 0,
              "Duration": 20
            }
          ]
        }
      }
    ],
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    }
  }
}

    エラーコード

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

    変更履歴

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