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

Intelligent Media Management:TargetVideo

最終更新日:Jun 09, 2026

パラメーター

タイプ

説明

object

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

DisableVideo

boolean

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

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

  • false (デフォルト):ビデオストリームの生成を有効にします。

false

Stream

array

処理するソースビデオストリームのインデックス番号のリスト。このパラメーターが空 (デフォルト) の場合、システムはインデックス番号が最も小さいビデオストリーム (最初のビデオストリーム) を処理します。インデックス番号を 100 より大きい値に設定すると、システムはすべてのビデオストリームを処理します。

  • 例:[0,1] はインデックス番号 0 と 1 のビデオストリームを処理します。[1] はインデックス番号 1 のビデオストリームを処理します。[101] はすべてのビデオストリームを処理します。

説明

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

integer

処理するビデオストリームのインデックス番号。

0

TranscodeVideo

object

動画トランスコーディングのパラメーター。値が空の場合、ビデオ処理は無効になります。出力ファイルにビデオストリームは含まれません。

説明

このパラメーターを空にしてビデオ処理を無効にしないでください。

Codec

string

ビデオエンコーディング形式。有効な値は次のとおりです。

  • CreateMediaConvertTask API の場合:copy (デフォルト)、h264、h265、vp9。
    警告 このパラメーターを copy に設定すると、システムはビデオストリームを出力ファイルに直接コピーします。この場合、TranscodeVideo 配下の他のパラメーターは無効になります。copy 値は動画結合には使用できず、通常はコンテナフォーマット変換に使用されます。
  • GenerateVideoPlaylist API の場合:h264 (デフォルト) と h265。

h264

PixelFormat

string

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

  • yuv420p

  • yuv422p

  • yuv444p

  • yuv420p10le

  • yuv422p10le

  • yuv444p10le

  • yuva420p

説明

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

yuv420p

FrameRateOption

string

フレームレートのオプション。有効な値は次のとおりです。

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

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

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

デフォルト値:

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

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

説明

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

fixed

FrameRate

number

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

25

ResolutionOption

string

解像度のオプション。有効な値は次のとおりです。

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

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

  • fall:ソースビデオの解像度の面積が、指定されたターゲットビデオの解像度の面積より小さい場合、タスクは失敗します。

デフォルト値:

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

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

説明

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

fixed

Resolution

string

出力ビデオの解像度を 幅 × 高さ の形式で指定します。デフォルトでは、ソースビデオの再生解像度と同じです。幅と高さの両方、または幅か高さのいずれか一方を設定できます。このパラメーターを 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:ソースビデオのビットレートが指定されたターゲットビデオのビットレートより低い場合、タスクは失敗します。

デフォルト値:

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

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

説明

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

fixed

Bitrate

integer

ビデオストリームのビットレートを bps (ビット/秒) 単位で指定します。

説明

このパラメーターは CRF と相互に排他的です。このパラメーターと CRF パラメーターの両方が空の場合、システムは CRF 値 23 でビデオをエンコードします。

128000

GOPSize

integer

GOP (Group of Pictures) のサイズをフレーム単位で指定します。デフォルト値は 150 です。

説明

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

60

CRF

number

CRF (Constant Rate Factor) モードを指定します。このパラメーターは 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

LicensePlate

object

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

説明

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

Confidence

number

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

  • 値の範囲:0.0~1.0

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

0.4

MinSize

integer

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

0.4