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

Intelligent Media Management:TargetVideo

最終更新日:Jul 16, 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

WidthxHeight フォーマットの出力ビデオの解像度。デフォルト値はソースビデオの再生解像度と同じです。幅と高さの両方を設定することも、幅または高さのみを設定することもできます。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 パラメーターのフォーマットは LongSide×ShortSide です。

  • false (デフォルト): 無効。Resolution パラメーターのフォーマットは Width×Height です。

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

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

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

1: Narrowband HD モードを使用してトランスコード中。

説明

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

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

0

FilterVideo

object

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

説明

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

Watermarks

array

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

object

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

Type

string

ウォーターマークのタイプ。有効な値は次のとおりです。

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

  • file:画像またはアニメーション画像のウォーターマーク。

text

Dx

number

値が整数か小数かによって、このパラメーターの意味は異なります。

  • 0 (デフォルト):ピクセルオフセットは 0 です。水平オフセットと出力ビデオの幅の比率も 0 です。

  • 整数:ピクセル (px) 単位のオフセット。値の範囲は 1~4096 です。

  • 小数:水平オフセットと出力ビデオの幅の比率。値の範囲は (0, 1) です。

0

Dy

number

値が整数か小数かによって、このパラメーターの意味は異なります。

  • 0 (デフォルト):ピクセルオフセットは 0 です。垂直オフセットと出力ビデオの高さの比率も 0 です。

  • 整数:ピクセル (px) 単位のオフセット。値の範囲は 1~4096 です。

  • 小数:垂直オフセットと出力ビデオの高さの比率。値の範囲は (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 URL。サポートされている形式は PNG と MOV です。

OSS URL は oss://<bucket>/<object> の形式である必要があります。ここで、<bucket> は現在のプロジェクトと同じリージョンにある OSS バケットの名前、<object> はファイル拡張子を含むファイルのフルパスです。

重要

このパラメーターは、Type パラメーターが file に設定されている場合にのみ有効です。

oss://test-bucket/watermark.jpg

Width

number

ウォーターマーク画像の幅。デフォルトでは、元のウォーターマーク画像の幅になります。値が整数か小数かによって、このパラメーターの意味は異なります。

  • 整数:ピクセル (px) 単位のウォーターマークの幅。値の範囲は 1~4096 です。

  • 小数:ウォーターマークの幅と出力ビデオの幅の比率。値の範囲は (0, 1) です。

80

Height

number

ウォーターマーク画像の高さ。デフォルトでは、元のウォーターマーク画像の高さになります。値が整数か小数かによって、このパラメーターの意味は異なります。

  • 整数:ピクセル (px) 単位のウォーターマークの高さ。値の範囲は 1~4096 です。

  • 小数:ウォーターマークの高さと出力ビデオの高さの比率。値の範囲は (0, 1) です。

40

Delogos

array

ビデオの矩形エリアにモザイク処理を適用して、ロゴや局ウォーターマークを除去します。

object

ビデオモザイク処理パラメーター。

StartTime

number

モザイクを追加する開始時間を秒 (s) 単位で指定します。デフォルトでは、ビデオの冒頭からモザイクが追加されます。

0

Duration

number

モザイクが表示される期間を秒 (s) 単位で指定します。デフォルトでは、ビデオの最後までモザイクが表示されます。

15

Dx

number

値が整数か小数かによって、このパラメーターの意味は異なります。

  • 0 (デフォルト):ピクセルオフセットは 0 です。水平オフセットと出力ビデオの幅の比率も 0 です。

  • 整数:ピクセル (px) 単位のオフセット。値の範囲は 1~4096 です。

  • 小数:水平オフセットと出力ビデオの幅の比率。値の範囲は (0, 1) です。

0

Dy

number

デフォルト値は 0 です。値が整数か小数かによって、このパラメーターの意味は異なります。

  • 0 (デフォルト):ピクセルオフセットは 0 です。垂直オフセットと出力ビデオの高さの比率も 0 です。

  • 整数:ピクセル (px) 単位のオフセット。値の範囲は 1~4096 です。

  • 小数:垂直オフセットと出力ビデオの高さの比率。値の範囲は (0, 1) です。

0

Width

number

モザイクの幅。デフォルト値は小数 1.0 で、出力ビデオの幅全体を埋めることを意味します。値が整数か小数かによって、このパラメーターの意味は異なります。

  • 整数:ピクセル (px) 単位の幅。値の範囲は 1~4096 です。

  • 小数:モザイクの幅と出力ビデオの幅の比率。値の範囲は (0, 1) です。

100

Height

number

モザイクの高さ。デフォルト値は小数 1.0 で、出力ビデオの高さ全体を埋めることを意味します。値が整数か小数かによって、このパラメーターの意味は異なります。

  • 整数:ピクセル (px) 単位の高さ。値の範囲は 1~4096 です。

  • 小数:モザイクの高さと出力ビデオの高さの比率。値の範囲は (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

BlurRadius

integer

Transparency

number

LicensePlate

object

ナンバープレートの非識別化の設定。

説明

この機能はパブリックプレビューです。ご不明な点がございましたら、フィードバックのために DingTalk グループにご参加ください。DingTalk グループ番号については、「お問い合わせ」をご参照ください。

Confidence

number

ナンバープレート認識の信頼度のしきい値。これは信頼度レベルの下限を設定します。検出されたナンバープレートの信頼度レベルがこのしきい値を下回る場合、そのナンバープレートは非識別化されません。

  • 値の範囲:0.0~1.0

  • デフォルト値:0.0 (信頼度によるフィルタリングなし)

0.4

MinSize

integer

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

0.4

ScaleRatio

number

BlurRadius

integer

Transparency

number