すべてのプロダクト
Search

このプロダクト

    Intelligent Media Management:TargetVideo

    ドキュメントセンター

    Intelligent Media Management:TargetVideo

    最終更新日:Aug 28, 2026

    パラメーター

    タイプ

    説明

    例

    object

    ビデオ処理のパラメータ設定。

    DisableVideo

    boolean

    ビデオストリームの生成を無効にするかどうかを指定します。有効な値:

    • true: 無効。出力ファイルにビデオストリームは含まれません。

    • false (デフォルト): 無効にしません。

    false
    Stream

    array

    ソースファイルから処理するビデオストリームのインデックス番号のリスト。空の値 (デフォルト) は、最小のインデックス番号を持つビデオストリーム (最初のビデオストリーム) がプロセスされることを示します。100 より大きいインデックス番号は、すべてのビデオストリームがプロセスされることを示します。

    • 例: [0,1] はインデックス番号 0 および 1 のビデオストリームをプロセスします。[1] はインデックス番号 1 のビデオストリームをプロセスします。[101] はすべてのビデオストリームをプロセスします。

    説明

    既存のインデックス番号を持つビデオストリームのみがプロセスされます。インデックス番号に対応するビデオストリームが存在しない場合、そのインデックス番号は無視されます。

    integer

    プロセスするビデオストリームのインデックス番号。

    0
    TranscodeVideo

    object

    トランスコード中のパラメーター。空の値は、ビデオ処理が無効であり、出力ファイルにビデオストリームが含まれないことを示します。

    説明

    ビデオ処理を無効にするためにこのパラメーターを空の値にセットすることは推奨されません。

    Codec

    string

    ビデオエンコーディングフォーマット。有効な値:

    • CreateMediaConvert API の場合: copy (デフォルト)、h264、h265、vp9。
      警告 このパラメーターが copy にセットされている場合、処理対象のビデオストリームは出力ファイルに直接コピーされ、TranscodeVideo 配下の他のパラメーターは効果がありません。copy はビデオ連結には使用できず、通常はコンテナフォーマット変換シナリオで使用されます。

    • GenerateVideoPlaylist API の場合: h264 (デフォルト)、h265。

    h264
    PixelFormat

    string

    ピクセルフォーマット。デフォルト値はソースビデオと同じです。有効な値:

    • yuv420p

    • yuv422p

    • yuv444p

    • yuv420p10le

    • yuv422p10le

    • yuv444p10le

    • yuva420p

    説明

    yuva420p は CreateMediaConvert API でのみ使用可能であり、Codec パラメーターを vp9 に設定する必要があります。

    yuv420p
    FrameRateOption

    string

    フレームレートオプション。有効な値:

    • fixed: 常に指定されたターゲットビデオフレームレートを使用します。

    • adaptive: ソースビデオのフレームレートが指定されたターゲットビデオフレームレートより低い場合に、ソースビデオのフレームレートを使用します。

    • fall: ソースビデオのフレームレートが指定されたターゲットビデオフレームレートより低い場合に、失敗を返します。

    デフォルト値:

    • CreateMediaConvert API の場合、デフォルト値は fixed です。

    • GenerateVideoPlaylist API の場合、デフォルト値は adaptive です。

    説明

    このパラメーターは FrameRate パラメーターと一緒にセットする必要があります。

    fixed
    FrameRate

    number

    ビデオフレームレート。デフォルト値はソースビデオと同じです。

    25
    ResolutionOption

    string

    解像度オプション。有効な値:

    • fixed: 常に指定されたターゲットビデオ解像度を使用します。

    • adaptive: ソースビデオの解像度エリアが指定されたターゲットビデオ解像度エリアより小さい場合に、ソースビデオの解像度を使用します。

    • fall: ソースビデオの解像度エリアが指定されたターゲットビデオ解像度エリアより小さい場合に、失敗を返します。

    デフォルト値:

    • CreateMediaConvert API の場合、デフォルト値は fixed です。

    • GenerateVideoPlaylist API の場合、デフォルト値は adaptive です。

    説明

    このパラメーターは Resolution パラメーターと一緒にセットする必要があります。

    fixed
    Resolution

    string

    幅 x 高さ のフォーマットでの出力ビデオの解像度。デフォルト値はソースビデオの再生解像度と同じです。幅と高さの両方を指定することも、幅または高さのみを指定することもできます。AdaptiveResolutionDirection パラメーターを使用して、長辺と短辺の両方、または長辺のみか短辺のみを指定することもできます。単一辺の有効値範囲は (0,4096] です。

    • 例 1: AdaptiveResolutionDirection が false の場合、1280x720 は幅を 1280、高さを 720 にセットします。1280x は幅を 1280 にセットし、高さをソースビデオと同じに保ちます。x720 は高さを 720 にセットし、幅をソースビデオと同じに保ちます。

    • 例 2: AdaptiveResolutionDirection が true の場合、1280x720 は長辺を 1280、短辺を 720 にセットします。1280x は長辺を 1280 にセットし、短辺をソースビデオと同じに保ちます。x720 は短辺を 720 にセットし、長辺をソースビデオと同じに保ちます。

    説明

    ソースビデオに回転情報が含まれている場合、幅/高さおよび長辺/短辺の判定は回転後の状態 (再生解像度) に基づいて行われます。

    640x480
    AdaptiveResolutionDirection

    boolean

    適応型長辺/短辺モードを有効にするかどうかを指定します。有効な値:

    • true: 有効。Resolution パラメーターのフォーマットは 長辺 × 短辺 となります。

    • false (デフォルト): 無効。Resolution パラメーターのフォーマットは 幅 × 高さ となります。

    true
    ScaleType

    string

    スケーリングモード。有効な値:

    • stretch (デフォルト): 固定幅/高さまたは長辺/短辺。強制的にスケーリングを行い、空白エリアを引き伸ばして塗りつぶします。

    • crop: 比例スケーリング。指定された幅/高さまたは長辺/短辺の矩形を超える最小値の解像度までスケーリングし、余分な部分をセンターからクロップします。

    • fill: 比例スケーリング。指定された幅/高さまたは長辺/短辺の矩形内の最大値の解像度までスケーリングし、センター配置で空白エリアを黒で塗りつぶします。

    • fit: 比例スケーリング。指定された幅/高さまたは長辺/短辺の矩形内の最大値の解像度までスケーリングします。

    説明

    このパラメーターは Resolution パラメーターと一緒にセットする必要があります。

    crop
    Rotation

    integer

    ビデオの時計回りの回転次数。有効な値:

    • 0 (デフォルト)

    • 90

    • 180

    • 270

    90
    BitrateOption

    string

    ビデオビットレートオプション。有効な値:

    • fixed: 常に指定されたターゲットビデオビットレートを使用します。

    • adaptive: ソースビデオのビットレートが指定されたターゲットビデオビットレートより低い場合に、ソースビデオのビットレートを使用します。

    • fall: ソースビデオのビットレートが指定されたターゲットビデオビットレートより低い場合に、失敗を返します。

    デフォルト値:

    • CreateMediaConvert API の場合、デフォルト値は fixed です。

    • GenerateVideoPlaylist API の場合、デフォルト値は adaptive です。

    説明

    このパラメーターは Bitrate パラメーターと一緒にセットする必要があります。

    fixed
    Bitrate

    integer

    ビデオストリームのビットレート (ビット/秒 (bit/s))。

    説明

    このパラメーターは CRF と相互排他です。このパラメーターと CRF の両方が空の場合、CRF 値 23 でエンコーディングが実行されます。

    128000
    GOPSize

    integer

    キーフレーム間のフレーム数。デフォルト値: 150。

    説明

    このパラメーターは GenerateVideoPlaylist API ではサポートされていません。

    60
    CRF

    number

    定数品質モードを指定します。このパラメーターは Bitrate パラメーターと相互排他です。有効値範囲は [0,51] です。値が大きいほどビデオ品質は低くなります。推奨値範囲は [18,38] です。

    18
    BufferSize

    integer

    変数ビットレートのデコードバッファーサイズ (ビット/秒 (bps))。

    説明

    このパラメーターは CRF パラメーターと一緒に使用した場合にのみ効果があります。

    4000000
    MaxBitrate

    integer

    変数ビットレートの最大値ビットレート制限。このパラメーターを使用する場合、BufferSize パラメーターを指定する必要があります。

    説明

    このパラメーターは CRF パラメーターと一緒に使用した場合にのみ効果があります。

    128000
    BFrames

    integer

    連続する B フレームの数。デフォルト値: 3。

    3
    Refs

    integer

    リファレンスフレームの数。デフォルト値: 2。

    2
    VideoSlim

    integer

    軽量 HD モードを有効にします。有効な値:

    0: デフォルト値。無効。

    1: トランスコード中に軽量 HD モードを使用します。

    説明

    最適な結果を得るには、軽量 HD を使った動画トランスコーディングエンコーディング用に公式に推奨されている Bitrate または CRF パラメーターを使用してください。

    重要 軽量 HD は h.264/h.265 フォーマットのみをサポートし、yuv420p、8 ビット深さのみに対応しており、マルチターゲット動画トランスコーディング出力やビデオ連結はサポートしていません。詳細については、「軽量 HD プロダクト概要」を参照してください。

    0
    FilterVideo

    object

    ビデオ処理パラメーター。TranscodeVideo パラメーターが空の場合、または TranscodeVideo.Codec が copy に設定されている場合、このパラメーターは効果がありません。

    説明

    GenerateVideoPlaylist API では、このパラメーターはサポートされていません。

    Watermarks

    array

    ビデオウォーターマークのリスト。

    object

    ビデオウォーターマーク情報。

    Type

    string

    ウォーターマークのタイプ。有効な値:

    • text (デフォルト): テキストウォーターマーク。

    • file: イメージまたはアニメーションイメージウォーターマーク。

    text
    Dx

    number

    値が整数か 10 進数かによって意味が異なります。

    • 0 (デフォルト): ピクセル単位のオフセットと、水平オフセットの出力解像度高さに対する比率の両方が 0 です。

    • 整数: ピクセル (px) 単位のオフセット。有効値: [1,4096]。

    • 10 進数: 水平オフセットの出力解像度高さに対する比率。有効値: (0,1)。

    0
    Dy

    number

    値が整数か 10 進数かによって意味が異なります。

    • 0 (デフォルト): ピクセル単位のオフセットと、垂直オフセットの出力解像度高さに対する比率の両方が 0 です。

    • 整数: ピクセル (px) 単位のオフセット。有効値: [1,4096]。

    • 10 進数: 垂直オフセットの出力解像度高さに対する比率。有効値: (0,1)。

    0
    StartTime

    number

    ウォーターマークを追加する開始時刻で、単位は秒 (s) です。デフォルト値はビデオの開始時刻です。

    0
    Duration

    number

    ウォーターマークが表示される持続時間で、単位は秒 (s) です。デフォルト値はビデオの終了までです。

    0
    ReferPos

    string

    ウォーターマークを追加するためのリファレンス位置。有効な値:

    • topleft (デフォルト): 左上隅

    • topright: 右上隅

    • bottomright: 右下隅

    • bottomleft: 左下隅

    topleft
    Content

    string

    テキストウォーターマークの内容。デフォルト値は空です。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    example
    FontName

    string

    テキストウォーターマークのフォント名。有効な値:

    • SourceHanSans-Regular (デフォルト)

    • SourceHanSans-Bold

    • SourceHanSerif-Regular

    • SourceHanSerif-Bold

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    SourceHanSans-Bold
    FontSize

    integer

    テキストウォーターマークのフォントサイズ。デフォルト値: 16。値は整数である必要があります。有効値: (4,120)。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    18
    FontColor

    string

    ウォーターマークテキストのフォント色。フォーマットは #RRGGBB です。デフォルト値: #000000。"red" や "green" などの値もサポートされています。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    red
    FontApha

    number

    テキストウォーターマークのフォントの透明度。有効値: (0,1]。デフォルト値: 1 で、完全に不透明であることを示します。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    0.8
    BorderWidth

    integer

    テキストウォーターマークの罫線の幅で、単位はピクセル (px) です。値は整数である必要があります。有効値: [0,4096]。デフォルト値: 0。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    2
    BorderColor

    string

    ウォーターマークテキストの罫線の色。フォーマットは #RRGGBB です。デフォルト値: #000000。"red" や "green" などの値もサポートされています。

    重要 このパラメーターは、Type パラメーターが text に設定されている場合に効果があります。

    red
    URI

    string

    ウォーターマークファイルの OSS URI。サポートされているフォーマットは PNG および MOV です。

    OSS URI のフォーマットは oss://<bucket>/<object> で、<bucket> は現在のプロジェクトと同じリージョンにある OSS バケットの名前、<object> はファイル拡張子を含むオブジェクトの完全なパスです。

    重要 このパラメーターは、Type パラメーターが file に設定されている場合に効果があります。

    oss://test-bucket/watermark.jpg
    Width

    number

    ウォーターマークイメージの幅。デフォルト値はウォーターマークイメージの元の幅です。値が整数か 10 進数かによって意味が異なります。

    • 整数: ロゴ除去幅の画素値で、単位はピクセル (px) です。有効値: [1,4096]。

    • 10 進数: 出力ビデオ解像度の幅に対する比率。有効値: (0,1)。

    80
    Height

    number

    ウォーターマークイメージの高さ。デフォルト値はウォーターマークイメージの元の高さです。値が整数か 10 進数かによって意味が異なります。

    • 整数: ロゴ除去高さの画素値で、単位はピクセル (px) です。有効値: [1,4096]。

    • 10 進数: 出力ビデオ解像度の高さに対する比率。有効値: (0,1)。

    40
    Delogos

    array

    ビデオの長方形のエリアにぼかしを適用して、ロゴ、局マーク、および同様の要素を除去します。

    object

    ビデオぼかし処理パラメーター。

    StartTime

    number

    モザイクを追加する開始時刻で、単位は秒 (s) です。デフォルト値はビデオの開始時刻です。

    0
    Duration

    number

    モザイクが適用される持続時間で、単位は秒 (s) です。デフォルト値はビデオの終了までです。

    15
    Dx

    number

    値が整数か 10 進数かによって意味が異なります。

    • 0 (デフォルト): ピクセル単位のオフセットと、水平オフセットの出力解像度高さに対する比率の両方が 0 です。

    • 整数: ピクセル (px) 単位のオフセット。有効値: [1,4096]。

    • 10 進数: 水平オフセットの出力解像度高さに対する比率。有効値: (0,1)。

    0
    Dy

    number

    デフォルト値: 0。値が整数か 10 進数かによって意味が異なります。

    • 0 (デフォルト): ピクセル単位のオフセットと、垂直オフセットの出力解像度高さに対する比率の両方が 0 です。

    • 整数: ピクセル (px) 単位のオフセット。有効値: [1,4096]。

    • 10 進数: 垂直オフセットの出力解像度高さに対する比率。有効値: (0,1)。

    0
    Width

    number

    モザイクの幅。デフォルト値は 10 進数の 1.0 で、出力ビデオの幅全体を塗りつぶします。値が整数か 10 進数かによって意味が異なります。

    • 整数: 画素値で、単位はピクセル (px) です。有効値: [1,4096]。

    • 10 進数: 出力ビデオ解像度の幅に対する比率。有効値: (0,1)。

    100
    Height

    number

    モザイクの高さ。デフォルト値は 10 進数の 1.0 で、出力ビデオの高さ全体を塗りつぶします。値が整数か 10 進数かによって意味が異なります。

    • 整数: 画素値で、単位はピクセル (px) です。有効値: [1,4096]。

    • 10 進数: 出力ビデオ解像度の高さに対する比率。有効値: (0,1)。

    40
    ReferPos

    string

    モザイクを追加するためのリファレンス位置。有効な値:

    • topleft (デフォルト): 左上隅

    • topright: 右上隅

    • bottomright: 右下隅

    • bottomleft: 左下隅

    topleft
    Speed

    number

    ビデオ再生速度の設定。有効値: [0.5,1.0]。デフォルト値: 1.0。

    説明

    • これはソースメディアファイルのデフォルト再生速度に対するトランスコード中メディアファイルの再生速度の比率であり、高速トランスコーディングではありません。

    重要

    • このパラメーターは CreateMediaConvertTask API にのみ適用されます。

    1.0
    Desensitization

    object

    ビデオの秘匿化構成。

    重要

    • このパラメーターは CreateMediaConvertTask API にのみ適用されます。

    Face

    object

    顔の秘匿化構成。

    説明

    この特徴はパブリックプレビュー中です。ご質問がある場合は、DingTalk グループに参加してフィードバックをお寄せください。DingTalk グループ番号については、「お問い合わせ」をご参照ください。

    Confidence

    number

    顔の信頼度のしきい値で、顔認識の信頼度の下限を設定します。検出された顔の信頼度がこのしきい値より低い場合、その顔は秘匿化されません。

    • 有効値: 0.0 ～ 1.0。

    • デフォルト値: 0.0 (信頼度によるフィルタリングは実行されません)。

    0.4
    MinSize

    integer

    最小顔サイズしきい値で、秘匿化する顔の最小サイズを設定します。検出された顔の幅または高さがこのしきい値より小さい場合、その顔は秘匿化されません。単位: ピクセル。デフォルト値: 0 で、顔サイズの制限がないことを示します。

    0.4
    ScaleRatio

    number

    検出ボックスのスケーリング比率。有効値: 0.1 ～ 5.0。検出ボックスのセンターに基づいて、検出ボックスの幅と高さの両方をスケーリングします。 • > 1.0: ぼかしエリアを拡大します。 • < 1.0: ぼかしエリアを縮小します。 • = 1.0: 元の検出ボックスを使用します。

    1.0
    BlurRadius

    integer

    ぼかしの半径。有効値: 1 ～ 100。値が大きいほど、通常、エリアのぼかしが強くなります。

    100
    Transparency

    number

    ぼかしエリアの透明度およびエッジのフェザリング強度。有効値: 0.0 ～ 1.0。 • 0.0: 完全なぼかし効果を表示します。 • 1.0: ぼかし処理は実行されません。元のイメージのみが表示されます。 • 0.0 ～ 1.0: 値が大きいほど、元のイメージの割合が高くなり、実際のぼかし半径が小さくなり、通常はエッジのフェザリング範囲が大きくなります。

    0.0
    LicensePlate

    object

    ナンバープレートの秘匿化構成。

    説明

    この特徴はパブリックプレビュー中です。ご質問がある場合は、DingTalk グループに参加してフィードバックをお寄せください。DingTalk グループ番号については、「お問い合わせ」をご参照ください。

    Confidence

    number

    ナンバープレートの信頼度のしきい値で、ナンバープレート認識の信頼度の下限を設定します。検出されたナンバープレートの信頼度がこのしきい値より低い場合、そのナンバープレートは秘匿化されません。

    • 有効値: 0.0 ～ 1.0。

    • デフォルト値: 0.0 (信頼度によるフィルタリングは実行されません)。

    0.4
    MinSize

    integer

    最小ナンバープレートサイズしきい値で、秘匿化するナンバープレートの最小サイズを設定します。検出されたナンバープレートの幅または高さがこのしきい値より小さい場合、そのナンバープレートは秘匿化されません。単位: ピクセル。デフォルト値: 0 で、ナンバープレートサイズの制限がないことを示します。

    0.4
    ScaleRatio

    number

    検出ボックスのスケーリング比率。有効値: 0.1 ～ 5.0。検出ボックスのセンターに基づいて、検出ボックスの幅と高さの両方をスケーリングします。 • > 1.0: ぼかしエリアを拡大します。 • < 1.0: ぼかしエリアを縮小します。 • = 1.0: 元の検出ボックスを使用します。

    1.0
    BlurRadius

    integer

    ぼかしの半径。有効値: 1 ～ 100。値が大きいほど、通常、エリアのぼかしが強くなります。

    100
    Transparency

    number

    ぼかしエリアの透明度およびエッジのフェザリング強度。有効値: 0.0 ～ 1.0。 • 0.0: 完全なぼかし効果を表示します。 • 1.0: ぼかし処理は実行されません。元のイメージのみが表示されます。 • 0.0 ～ 1.0: 値が大きいほど、元のイメージの割合が高くなり、実際のぼかし半径が小さくなり、通常はエッジのフェザリング範囲が大きくなります。

    0.0