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

:エフェクトの構成

最終更新日:Nov 16, 2025

エフェクトの構造は、そのタイプによって異なります。このトピックでは、さまざまなタイプのエフェクトの構造について説明します。

エフェクトタイプ: テキスト (バナーテキスト)

タイムラインの例: 字幕と字幕テンプレート

名前

タイプ

必須

説明

X

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。座標は、素材と出力ビデオのディメンションに基づいてスケーリングされます。

Y

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。座標は、素材と出力ビデオのディメンションに基づいてスケーリングされます。

TimelineIn

Float

いいえ

タイムライン上のバナーテキストの開始時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineIn と同じになります。

TimelineOut

Float

いいえ

タイムライン上のバナーテキストの終了時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineOut と同じになります。

Content

String

はい

バナーテキストの内容。

Font

String

いいえ

バナーテキストのフォント。サポートされているフォントのリストについては、「フォントリスト」をご参照ください。デフォルトのフォントは SimSun です。

FontSize

Int

はい

バナーテキストのフォントサイズ。このフォントサイズは、素材と出力ビデオのディメンションに基づいてスケーリングされます。デフォルト値は 0 です。最大値は 5000 です。

注:

  • FontSize または FixedFontSize のいずれかを指定できます。両方を指定した場合、FontSize のみ有効になります。

SizeRequestType

String

いいえ

フォントサイズからテキストの実際のレンダリングサイズを計算するために使用されるメソッド。デフォルト値は RealDim です。

  • Nominal: 字幕のレンダリングされた高さ (ピクセル単位) はフォントサイズ (FontSize) と同じです。

  • RealDim: 一部のフォントでは、字幕のレンダリングされた高さ (ピクセル単位) がフォントサイズ (FontSize) よりも小さい場合があります。

FixedFontSize

Int

はい

テロップテキストのフォントサイズ。このフォントサイズは、素材と出力ビデオのディメンションに基づいてスケーリングされません。

注:

  • FontSize または FixedFontSize のいずれかを指定できます。両方を指定した場合、FontSize のみ有効になります。

FixedX

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。この座標は、素材と出力ビデオのディメンションに基づいてスケーリングされません。

FixedY

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。この座標は、素材と出力ビデオのディメンションに基づいてスケーリングされません。

FontColor

String

いいえ

テロップテキストの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。

FontColorOpacity

String

いいえ

テロップテキストの不透明度。値の範囲は 0 から 1 です。値 1 はテキストが不透明であることを意味します。値 0 はテキストが完全に透明であることを意味します。デフォルト値は 1 です。

FontFace

FontFace

いいえ

バナーテキストのフォントフェイス。

Spacing

Integer

いいえ

バナーテキストの文字間隔 (ピクセル単位)。デフォルト値は 0 です。

LineSpacing

Integer

いいえ

バナーテキストの行間 (ピクセル単位)。デフォルト値は 0 です。

Angle

Float

いいえ

バナーテキストの反時計回りの回転角度 (度単位)。デフォルト値は 0 です。

BorderStyle

Int

いいえ

バナーテキストの罫線と影のスタイル。有効な値は 1 と 3 です。1: 罫線と影。3: 不透明なバックグラウンドボックス。デフォルト値は 1 です。

Outline

Int

いいえ

バナーテキストのアウトラインの幅 (ピクセル単位)。デフォルト値は 0 です。

OutlineColour

String

いいえ

テロップテキストのアウトラインの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。

Shadow

Int

いいえ

バナーテキストによってキャストされる影の深さ (ピクセル単位)。デフォルト値は 0 です。

BackColour

String

いいえ

テロップテキストの影の色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。

Alignment

String

いいえ

テロップテキストの配置。デフォルト値は TopLeft です。有効な値:

  • TopLeft: ビデオの左上隅。

  • TopCenter: ビデオの上部中央。

  • TopRight: ビデオの右上隅。

  • CenterLeft: ビデオの左中央。

  • CenterCenter: ビデオの中央。

  • CenterRight: ビデオの右中央。

  • BottomLeft: ビデオの左下隅。

  • BottomCenter: ビデオの下部中央。

  • BottomRight: ビデオの右下隅。

異なる配置の字幕を正確に配置するには、次のように配置を設定します。

  • 左: 左揃え。X と Y を、ビデオの左上隅を基準とした字幕の左上頂点の座標に設定します。

  • 中央: 中央揃え。X と Y を、ビデオの左上隅を基準とした字幕の中心軸と上罫線の交点の座標に設定します。

  • 右: 右揃え。X と Y を、ビデオの左上隅を基準とした字幕の右上頂点の座標に設定します。

AdaptMode

String

いいえ

ビデオの幅または指定された TextWidth を超えるバナーテキストを処理する方法:

  • AutoWrap: テキストを自動的に折り返します。

  • AutoScale: テキストを自動的にスケーリングします。

  • AutoWrapAtSpaces: スペースでのみテキストを自動的に折り返します。これは、英語のみの字幕を自動で折り返すのに適しています。

TextWidth

String

いいえ

字幕テキストボックスの幅。このパラメーターは、AdaptMode が設定されている場合にのみ有効になります。テキストは、この幅に基づいて折り返されるか、スケーリングされます。このパラメーターを指定しない場合、テキストはビデオの幅に基づいて折り返されるか、スケーリングされます。(0, 1] の開閉区間の値は、出力ビデオの幅のパーセンテージを表します。1 より大きい値は、絶対ピクセル値を表します。

FontUrl

String

いいえ

バナーテキストに使用する OSS バケット内のフォントファイルのパス。TTF、OTF、および WOFF 形式がサポートされています。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

いいえ

バナーテキストのアートテキストスタイルタイプ。詳細については、「アートテキストエフェクトの例」をご参照ください。

SubtitleEffects

SubtitleEffect[]

いいえ

バナーテキストの多層エフェクト。多層アウトライン、多層シャドウ、ガウスぼかし (シャドウのみ)、および字幕バックグラウンドエフェクトを設定できます。

注:

  • SubtitleEffects を設定した場合、字幕トラックの Outline および Shadow フィールドは有効になりません。

  • 多層アウトライン、シャドウ、またはバックグラウンドエフェクトを設定する場合、SubtitleEffects 配列の順序によってレイヤーの順序が決まります。配列の最初の SubtitleEffect は最下層にレンダリングされ、最後の SubtitleEffect は最上層にレンダリングされます。

AaiMotionInEffect

String

いいえ

バナーテキストの入場エフェクトタイプ。詳細については、「字幕エフェクトの例」をご参照ください。

AaiMotionIn

Float

いいえ

バナーテキストの入場エフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 0.5 秒です。テキストの期間が 0.5 秒未満の場合、入場エフェクトの期間は、合計期間から退場エフェクトの期間を引いたものになります。

AaiMotionOutEffect

String

いいえ

バナーテキストの退場エフェクトタイプ。詳細については、「字幕エフェクトの例」をご参照ください。

AaiMotionOut

Float

いいえ

バナーテキストの退場エフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 0.5 秒です。テキストの期間が 0.5 秒未満の場合、退場エフェクトの期間はテキストの合計期間になります。

AaiMotionLoopEffect

String

いいえ

バナーテキストのループエフェクトタイプ。このエフェクトは、入場または退場エフェクトと併用することはできません。詳細については、「字幕エフェクトの例」をご参照ください。

Ratio

Float

いいえ

バナーテキストのループエフェクトの再生速度。値は小数点以下 4 桁まで正確です。デフォルト値は 1 です。1 より大きい値はループが速いことを示します。1 より小さい値はループが遅いことを示します。

TextureURL

String

いいえ

字幕のテクスチャエフェクト。PNG、JPG、JPEG、および BMP 形式がサポートされています。OSS ファイルを使用する必要があります。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

BubbleStyleId

String

いいえ

バナーテキストの吹き出しテキストスタイルタイプ。吹き出しのタイプとエフェクトについては、「吹き出しテキストの例」をご参照ください。

BubbleWidth

Float

いいえ

このパラメーターは、吹き出しテキストを使用する場合にのみ有効になります。出力ビデオに対する吹き出しバックグラウンドの幅を指定します。1 より大きい値は絶対ピクセル値を表します。1 以下の値は相対値を表します。

BubbleHeight

Float

いいえ

このパラメーターは、吹き出しテキストを使用する場合にのみ有効になります。出力ビデオに対する吹き出しバックグラウンドの高さを指定します。1 より大きい値は絶対ピクセル値を表します。1 以下の値は相対値を表します。

エフェクトタイプ: DeWatermark (マスキング)

名前

タイプ

必須

説明

X

Float

いいえ

マスキングエリアの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。

Y

Float

いいえ

マスキングエリアの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。

Width

Float

はい

出力ビデオ内のマスキングエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Height

Float

はい

出力ビデオ内のマスキングエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

エフェクトタイプ: トリミング

タイムラインの例: ビデオのトリミング

名前

タイプ

必須

説明

X

Float

いいえ

トリミングされたエリアの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。

Y

Float

いいえ

トリミングされたエリアの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。

Width

Float

はい

出力ビデオ内のトリミングされたエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Height

Float

はい

出力ビデオ内のトリミングされたエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

エフェクトタイプ: スケール

注: スケールエフェクトを指定せず、素材の縦横比が出力ビデオの縦横比と一致しない場合、素材は出力ビデオの幅または高さのいずれかに合わせて自動的にスケーリングされます。上下または左右に黒いバーが追加され、素材は中央に配置されます。

タイムラインの例: スケール構成

名前

タイプ

必須

説明

Width

Float

はい

出力ビデオ内のスケーリングされたエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

Height

Float

はい

出力ビデオ内のスケーリングされたエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

エフェクトタイプ: Pad (パディング)

注: Pad エフェクトを指定せず、素材の縦横比が出力ビデオの縦横比と一致しない場合、素材は出力ビデオの幅または高さのいずれかに合わせて自動的にスケーリングされます。上下または左右に黒いバーが追加され、素材は中央に配置されます。

タイムラインの例: 横長のビデオを縦長のビデオに変換し、上下にぼかしエリアを追加する

名前

タイプ

必須

説明

Left

Float

いいえ

素材の左端から出力ビデオの左端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

Right

Float

いいえ

素材の右端から出力ビデオの右端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

Top

Float

いいえ

素材の上端から出力ビデオの上端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

Bottom

Float

いいえ

素材の下端から出力ビデオの下端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。

Color

String

いいえ

パディングの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #000000。デフォルトの色は黒です。

エフェクトタイプ: バックグラウンド

バックグラウンド設定には、バックグラウンドのぼかしとバックグラウンドカラーが含まれます。素材のディメンションが出力ビデオのディメンションと一致しない場合、このエフェクトを使用して空のエリアを構成できます。

バックグラウンドエフェクトは、トリミング、スケール、VFX、トランジションなどの他のエフェクトと併用できます。

タイムラインの例: 横長のビデオを縦長のビデオに変換し、バックグラウンドカラーを設定する

名前

タイプ

必須

説明

SubType

String

はい

サブタイプ。有効な値:

Blur: バックグラウンドのぼかし

Color: バックグラウンドカラー

Radius

Float

いいえ

ぼかしの半径。このパラメーターは、SubType が Blur に設定されている場合にのみ有効になります。値の範囲は 0.01 から 1 です。

Color

String

いいえ

色の値。このパラメーターは、SubType が Color に設定されている場合にのみ有効になります。16 進数の RGB 形式で色を指定します。例: #FFFFFF

エフェクトタイプ: トランジション

重要

このトランジションは、2 つの連続する素材のレイヤーを重ねることで作成されるため、最終的なビデオの期間が短くなります。これを避けるには、このトピックの後半で説明する DLTransition (期間ロックトランジション) エフェクトを使用します。

トランジションエフェクトは、2 つの素材の間で発生します。最初の素材にトランジションの期間を設定するだけで済みます。エフェクトは、最初の素材の終わりと 2 番目の素材の始まりに適用されます。トランジション中、ビデオフレームは重複し、トランジションの長さだけ合計期間が短縮されます。

たとえば、ビデオトラックに 2 つのクリップ、Clip1 (10 秒) と Clip2 (8 秒) が含まれており、それらの間に 4 秒のトランジションを追加すると、ビデオトラックの合計期間は 18 秒から 14 秒に短縮されます。

次の表に、トランジションのプロパティを示します。トランジションエフェクトの詳細については、「トランジションエフェクトの例」をご参照ください。

タイムラインの例: トランジションタイムライン構成の例

名前

タイプ

必須

説明

SubType

String

はい

トランジションのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: directional。値とそのエフェクトの完全なリストについては、「トランジションエフェクトの例」をご参照ください。

Duration

Float

いいえ

トランジションエフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 1 秒です。

エフェクトタイプ: DLTransition (期間ロックトランジション)

標準のトランジションエフェクトとは異なり、期間ロックトランジション (DLTransition) エフェクトは、トランジション期間を静止フレームで埋めるため、最終的なビデオの期間を短縮しません。

このエフェクトのパラメーターは、トランジションエフェクトのパラメーターと同じです。

名前

タイプ

必須

説明

SubType

String

はい

トランジションのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: directional。値とそのエフェクトの完全なリストについては、「トランジションエフェクトの例」をご参照ください。

Duration

Float

いいえ

トランジションエフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 1 秒です。

エフェクトタイプ: VFX

タイムラインの例: VFX エフェクト

名前

タイプ

必須

説明

SubType

String

はい

VFX サブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: colorfulradial。値とそのエフェクトの完全なリストについては、「VFX エフェクトの例」をご参照ください。

X

Float

いいえ

このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。エフェクトエリアの左上隅から出力ビデオの左上隅までの水平距離。

注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Y

Float

いいえ

このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。

エフェクトエリアから出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Width

Float

いいえ

このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。出力ビデオ内のエフェクトエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Height

Float

いいえ

このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。出力ビデオ内のエフェクトエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

ExtParams

String

いいえ

エフェクトの拡張パラメーター。このフィールドは、SubType が mask_circle、mask_rec、mask_linear、または mask_minor に設定されているマスキングシナリオでのみ有効になります。マスキングの ExtParams 構成については、次のセクションをご参照ください。

マスキングとその結果のエフェクトの例については、「マスキングエフェクト」をご参照ください。

重要

以下のマスキングパラメーターについて、パラメーターが浮動小数点数の場合は、0.5 や 2.0 などの浮動小数点形式で指定する必要があります。

円形マスクエフェクトのパラメーター

SubType=mask_circle

ExtParams パラメーター

パラメータ

タイプ

値の範囲

デフォルト値

説明

x

float

[0.0, 素材の幅]

0.5

素材の左上隅を基準としたマスクの中心の x 座標。0.0 から 1.0 までの値は、素材の幅に基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

y

float

[0.0, 素材の高さ]

0.5

素材の左上隅を基準としたマスクの中心の y 座標。0.0 から 1.0 までの値は、素材の高さに基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

width

float

[0.0, 素材の幅]

0.8

素材の幅に対する楕円マスクの幅。0.0 から 1.0 までの値は、素材の幅に基づいた相対的な幅を表します。1.0 より大きい値は、絶対ピクセル値を表します。

height

float

[0.0, 素材の高さ]

0.8

素材の幅に対する楕円マスクの高さ。0.0 から 1.0 までの値は、素材の高さに基づいた相対的な高さを表します。1.0 より大きい値は、絶対ピクセル値を表します。

antialias

float

[0.0, 1.0]

0.1

楕円マスクのアンチエイリアスパラメーター。値が大きいほど、エッジのぼかしの度合いが高くなります。

angle

float

[-9999.0, 9999.0]

0.0

回転角度。

矩形マスクエフェクトのパラメーター

SubType=mask_rec

ExtParams パラメーター

パラメータ

タイプ

値の範囲

デフォルト値

説明

x

float

[0.0, 素材の幅]

0.5

ビデオ素材の左上隅を基準とした矩形マスクの中心の x 座標。0.0 から 1.0 までの値は、素材の幅に基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

y

float

[0.0, 素材の高さ]

0.5

ビデオ素材の左上隅を基準とした矩形マスクの中心の y 座標。0.0 から 1.0 までの値は、素材の高さに基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

width

float

[0.0, 素材の幅]

0.8

矩形マスクの幅。0.0 から 1.0 までの値は、素材の幅に基づいた相対的な幅を表します。1.0 より大きい値は、絶対ピクセル値を表します。

height

float

[0.0, 素材の高さ]

0.8

矩形マスクの高さ。0.0 から 1.0 までの値は、素材の高さに基づいた相対的な高さを表します。1.0 より大きい値は、絶対ピクセル値を表します。

antialias

float

[0.0, 1.0]

0.1

矩形マスクのアンチエイリアスパラメーター。値が大きいほど、エッジのぼかしの度合いが高くなります。

radius

float

[0.0, 素材の幅または高さの大きい方]

0.1

矩形マスクの角半径。0.0 から 1.0 までの値は、素材の幅または高さの大きい方に対する半径を表します。1.0 より大きい値は、絶対ピクセル値を表します。

angle

float

[-9999.0, 9999.0]

0.0

回転角度。

線形マスクエフェクトのパラメーター

SubType=mask_linear

ExtParams パラメーター

パラメータ

タイプ

値の範囲

デフォルト値

説明

x

float

[0.0, 素材の幅]

0.5

素材の左上隅を基準とした線形マスクの中心参照点の x 座標。0.0 から 1.0 までの値は、素材の幅に基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

y

float

[0.0, 素材の高さ]

0.5

ビデオの左上隅を基準とした線形マスクの中心参照点の y 座標。0.0 から 1.0 までの値は、素材の幅に基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

antialias

float

[0.0, 1.0]

0.1

線形マスクのアンチエイリアスパラメーター。値が大きいほど、エッジのぼかしの度合いが高くなります。

angle

float

[-9999.0, 9999.0]

0.0

回転角度。

ミラーマスクエフェクトのパラメーター

SubType=mask_minor

ExtParams パラメーター

パラメータ

タイプ

値の範囲

デフォルト値

説明

x

float

[0.0, 素材の幅]

0.5

素材の左上隅を基準としたミラーマスクの中心参照点の x 座標。0.0 から 1.0 までの値は、素材の幅に基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

y

float

[0.0, 素材の高さ]

0.5

素材の左上隅を基準としたミラーマスクの中心参照点の y 座標。0.0 から 1.0 までの値は、素材の高さに基づいた相対座標を表します。1.0 より大きい値は、絶対ピクセル値を表します。

antialias

float

[0.0, 1.0]

0.1

ミラーマスクのアンチエイリアスパラメーター。値が大きいほど、エッジのぼかしの度合いが高くなります。

angle

float

[-9999.0, 9999.0]

0.0

回転角度。

エフェクトタイプ: フィルター

タイムラインの例: フィルターエフェクト

名前

タイプ

必須

説明

SubType

String

はい

フィルターのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: M1。値とそのエフェクトの完全なリストについては、「フィルターエフェクトの例」をご参照ください。

TimelineIn

Float

いいえ

タイムライン上のフィルターの開始時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineIn と同じになります。

TimelineOut

Float

いいえ

タイムライン上のフィルターの終了時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineOut と同じになります。

ExtParams

String

いいえ

フィルターの拡張パラメーター。このフィールドは、SubType が color (カラーフィルター) に設定されている場合にのみ有効になります。カラーフィルターの ExtParams 構成については、次のセクションをご参照ください。

カラーフィルターの ExtParams

タイムラインの例: カラーフィルターを使用する

ExtParams パラメーター

パラメータ

タイプ

値の範囲

説明

デフォルト値

brightness

int

[-255,255]

輝度

0

contrast

int

[-100,100]

コントラスト

0

saturation

int

[-100,100]

彩度

0

kelvin_temperature

int

[1000,40000]

温度。このパラメーターは

temperature_ratio パラメーターと連動して有効になります。

6000

temperature_ratio

int

[0,100]

温度比

0

tint

int

[-100,100]

色合い

0

dark_corner_ratio

int

[0,100]

ダークコーナー比

0

エフェクトタイプ: ボリューム

タイムラインの例: ビデオ全体をミュートするビデオとオーディオのボリュームを調整する

名前

タイプ

必須

説明

Gain

Float

はい

ボリュームゲイン。値の範囲は 0 から 10 です。値が小さいほどボリュームが低くなります。値が 0 の場合はオーディオをミュートします。値が 1 の場合は元のボリュームを維持します。値が 1 未満の場合はボリュームを下げます。値が 1 より大きい場合はボリュームを上げます。オーディオの歪みを避けるため、ゲインを高く設定しすぎないでください。

エフェクトタイプ: AFade (オーディオフェードイン/フェードアウト)

タイムラインの例: オーディオのみのクリップとビデオクリップ内のオーディオのフェードイン/フェードアウトを構成する

名前

タイプ

必須

説明

SubType

String

はい

オーディオのフェードイン/フェードアウトのサブタイプ。有効な値:

  • In (フェードイン)

  • Out (フェードアウト)

Duration

Float

いいえ

フェードインまたはフェードアウトエフェクトの期間。フェードインエフェクトは素材セグメントの開始時に適用されます。フェードアウトエフェクトは素材セグメントの終了時に適用されます。デフォルト値は 0 で、エフェクトが無効であることを意味します。

Curve

String

いいえ

フェードイン/フェードアウトエフェクトのボリュームカーブ。デフォルト値は exp です。

有効な値:

  • exp (指数関数的なボリュームの増減)

  • tri (線形的なボリュームの増減)

エフェクトタイプ: AI_ASR (音声テキスト変換)

このエフェクトは、オーディオから字幕を生成します。このエフェクトは、ビデオまたはオーディオトラックの Effects オブジェクトに追加できます。パラメーターは、「エフェクトタイプ: テキスト (バナーテキスト)」のパラメーターと同じです。デフォルトでは、字幕はビデオの下部中央に配置されます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。

名前

タイプ

必須

説明

X

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Y

Float

いいえ

バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。

Font

String

いいえ

バナーテキストのフォント。サポートされているフォントのリストについては、「フォントリスト」をご参照ください。デフォルトのフォントは SimSun です。

FontSize

Int

はい

バナーテキストのフォントサイズ。

FontColor

String

いいえ

テロップテキストの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。

FontColorOpacity

String

いいえ

テロップテキストの不透明度。値の範囲は 0 から 1 です。値 1 はテキストが不透明であることを意味します。値 0 はテキストが完全に透明であることを意味します。デフォルト値は 1 です。

FontFace

FontFace

いいえ

バナーテキストのフォントフェイス。

NeedHighlighting

Boolean

いいえ

ASR 字幕の自動ハイライトを有効にするかどうかを指定します。

HighlightingStyle

Style

いいえ

ハイライトされた字幕のスタイル。

エフェクトタイプ: Rotate (素材の回転)

このエフェクトは、指定された角度で素材を回転させます。90°、180°、270° の回転のみがサポートされています。このエフェクトは、ビデオトラック上のビデオまたはイメージ素材の Effects オブジェクトに追加できます。

タイムラインの例: 素材の回転

名前

タイプ

必須

説明

Degree

Integer

はい

素材の時計回りの回転角度。90、180、270 のみがサポートされています。

エフェクトタイプ: AI_Matting (イメージマット)

このエフェクトは、グリーンまたはブルーのスクリーンバックグラウンドからオブジェクトを抽出し、別のバックグラウンドビデオまたはイメージに重ね合わせます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。

名前

タイプ

必須

説明

Color

String

はい

バックグラウンドカラー。グリーン (グリーンバックキーイング) とブルー (ブルーバックキーイング) のみがサポートされています。

Auto

Integer

はい

背景色を自動的に検出するかどうかを指定します。有効な値:

  • 0: しきい値に基づいて検出します。

  • 1: 自動的に検出します。

Thres

Float

いいえ

バックグラウンドカラー検出のしきい値。値が大きいほど、検出が緩やかになります。値の範囲は 0 から 10 です。

エフェクトタイプ: AI_RealMatting (リアルシーンマット)

このエフェクトは、ビデオ内の実世界のシーンから人物を抽出し、別のバックグラウンドビデオまたはイメージに重ね合わせます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。

名前

タイプ

必須

説明

Thres

Float

いいえ

バックグラウンドカラー検出のしきい値。値が大きいほど、検出が緩やかになります。値の範囲は 0 から 10 です。デフォルト値は 2 です。

エフェクトタイプ: AI_Delogo (インテリジェントロゴ除去)

このエフェクトは、ビデオから放送局のロゴをインテリジェントに認識して削除します。この機能は、中国 (北京) および中国 (上海) リージョンでのみ利用できます。

エフェクトタイプ: Clip (ランダムクリッピング)

このエフェクトは、クリッピング機能を提供します。現在、ランダムクリッピングのみがサポートされています。元の素材からランダムな期間のセグメントがクリップされ、タイムラインに追加されます。

名前

種類

必須

説明

SubType

String

はい

クリッピングタイプ。現在、ランダムクリッピングのみがサポートされています: RandomClip。

ClipDuration

Float

はい

クリップされたセグメントのデュレーション。

エフェクトタイプ: 反転

このエフェクトは、ビデオトラック上のビデオまたはイメージのフレームを水平または垂直に反転させます。

タイムラインの例: 水平反転と垂直反転

名前

種類

必須

説明

Direction

String

はい

  • horizontal: フレームを水平に反転させます。

  • vertical: フレームを垂直に反転させます。

エフェクトタイプ: KenBurns (パンとズーム)

このエフェクトは、ビデオトラック上のビデオまたはイメージにパンとズームのエフェクトを適用します。

制限:

  • このエフェクトは、イメージとビデオに適用されます。VFX、フィルター、トランジションエフェクトと併用できます。

  • このエフェクトでは、出力フレームの幅と高さを設定できます (以下の WindowW/WindowH パラメーターを参照)。したがって、トリミング、スケール、Pad、またはバックグラウンドエフェクトと併用することはできません。

名前

タイプ

必須

説明

Duration

Float

いいえ

エフェクトの期間 (秒単位)。デフォルト値はクリップの期間です。最大値は 10 です。

5

WindowW

Float

いいえ

最終出力セグメントの幅 (ピクセル単位)。デフォルト値は出力ビデオの幅です。

開閉区間 (0, 1] の値は相対値を表します。1 より大きい値は絶対値を表します。

1

WindowH

Float

いいえ

最終出力セグメントの高さ (ピクセル単位)。デフォルト値は出力ビデオの高さです。

開閉区間 (0, 1] の値は相対値を表します。

> 1 は絶対値を表します。

1

Start

String

いいえ

エフェクト開始時の元の素材におけるフレームの左上隅の位置 (x 座標、y 座標、幅、高さ)。値はコンマで区切られます。すべての値はオプションです。

"StartX,StartY,StartW,StartH"

制限:

0 < StartX + StartW <=1

0 < StartY + StartH <=1

"0,0,0.9,0.9"

StartX

Float

いいえ

エフェクト開始時の元の素材におけるフレームの左上隅の x 座標 (ピクセル単位)。

閉開区間 [0, 1) の値は相対値を表します。

1 以上の値は絶対値を表します。

0

StartY

Float

いいえ

エフェクト開始時の元の素材におけるフレームの左上隅の y 座標 (ピクセル単位)。

閉開区間 [0, 1) の値は相対値を表します。

1 以上の値は絶対値を表します。

0

StartW

Float

いいえ

エフェクト開始時の元の素材におけるフレームの幅 (ピクセル単位)。

開閉区間 (0, 1] の値は相対値を表します。

1 より大きい値は絶対値を表します。

0.9

StartH

Float

いいえ

エフェクト開始時の元の素材におけるフレームの高さ (ピクセル単位)。

開閉区間 (0, 1] の値は相対値を表します。

> 1 は絶対値を示します。

0.9

End

String

いいえ

エフェクト終了時の元の素材におけるフレームの左上隅の位置 (x 座標、y 座標、幅、高さ)。値はコンマで区切られます。すべての値はオプションです。

"EndX,EndY,EndW,EndH"

制限:

0 < EndX + EndW <=1

0 < EndY + EndH <=1

"0,0,1,1"

EndX

Float

いいえ

エフェクト終了時の元の素材におけるフレームの左上隅の x 座標 (ピクセル単位)。

閉開区間 [0, 1) の値は相対値を表します。

1 以上の値は絶対値を表します。

0

EndY

Float

いいえ

エフェクト終了時の元の素材におけるフレームの左上隅の y 座標 (ピクセル単位)。

閉開区間 [0, 1) の値は相対値を表します。

1 以上の値は絶対値を表します。

0

EndW

Float

いいえ

エフェクト終了時の元の素材におけるフレームの幅 (ピクセル単位)。

開閉区間 (0, 1] の値は相対値を表します。

> 1 は絶対値を表します。

1

EndH

Float

いいえ

エフェクト終了時の元の素材におけるフレームの高さ (ピクセル単位)。

開閉区間 (0, 1] の値は相対値を表します。

> 1 の値は絶対値を示します。

1

エフェクトタイプ: ADenoise (オーディオノイズ除去)

このエフェクトは、ビデオトラック上のビデオ内のオーディオ、またはオーディオトラック上のオーディオクリップに対してノイズ除去を実行します。

名前

種類

必須

説明

Mode

Integer

いいえ

  • 0: 処理なし (デフォルト)。

  • 1: 軽微なノイズ除去。

  • 2: 音楽を保持しながら定常ノイズを除去します。音楽コンテンツに適しています。

  • 3: 定常ノイズを強力に除去します。音楽のない音声コンテンツに適しています。

  • 4: 音声抽出。定常および非定常ノイズを除去します。非音楽コンテンツに適しています。

エフェクトタイプ: ズーム

このエフェクトは、対応するクリップにズームエフェクトを追加します。

重要

このエフェクトは、VideoTrack 上のクリップにのみ使用できます。

名前

種類

必須

説明

StartRate

Float

いいえ

  • 開始ズーム率。

  • デフォルト値: 1.0。

  • 値の範囲: [1.0, 5.0]。

EndRate

Float

いいえ

  • 終了ズーム率。

  • デフォルト値: StartRate + 0.3。

  • 値の範囲: [StartRate, 5.0]。

Duration

Float

いいえ

  • エフェクトの期間。

  • デフォルト値: 現在のクリップのレンダリングデュレーション。

  • 値の範囲: [0, 現在のクリップのレンダリング期間]。

エフェクトタイプ: Harmonization (バックグラウンドブレンド)

このエフェクトは、対応するクリップにバックグラウンドブレンドエフェクトを追加します。このエフェクトは、主にデジタルヒューマンビデオクリップに使用されます。このエフェクトをデジタルヒューマンビデオクリップに追加すると、バックグラウンドイメージの照明、輝度、色温度に適応し、デジタルヒューマンビデオクリップとバックグラウンドイメージの間のよりシームレスなブレンドを作成します。

重要
  1. このエフェクトは、VideoTrack 上のクリップにのみ使用できます。

  2. 1 回のビデオ編集リクエストで追加できる Harmonization エフェクトは 1 つだけです。

このエフェクトには他の入力パラメーターはありません。

エフェクトタイプ: ALoudNorm (ラウドネス正規化)

ALoudNorm は、単一のオーディオまたはビデオ素材にのみ適用されます。複数のオーディオまたはビデオ素材があり、それらを同じラウドネスにしたい場合は、各素材に個別に ALoudNorm を構成する必要があります。

説明

このエフェクトは、オーディオおよびビデオクリップにのみ適用されます。ALoudNorm が ADenoise または Volume と一緒に使用される場合、適用順序は ADenoise > Volume > ALoudNorm です。

タイムラインの例: ラウドネス正規化

名前

タイプ

必須

説明

Loudness

Float

いいえ

ターゲットラウドネス。ボリュームレベルを決定し、EBU R 128 規格に準拠します。値の範囲は -70.0 から -5.0 です。デフォルト値は -24.0 です。

TruePeak

Float

いいえ

トゥルーピークレベル。オーディオ信号の最高ピークレベルを制限します。値の範囲は -9.0 から +0.0 です。デフォルト値は -2.0 です。

エフェクトタイプ: AEqualize (オーディオイコライゼーション)

このエフェクトは、グローバルエフェクトとしてエフェクトトラックに適用されます。プロジェクト全体のオーディオに均一なオーディオイコライゼーションを実行します。

説明

このエフェクトはグローバルにのみ適用され、個々のクリップにはサポートされていません。

タイムラインの例: オーディオイコライゼーション

名前

タイプ

必須

説明

Peak

Float

いいえ

オーディオのターゲットピークレベル。デフォルト値は 0.95 です。この値を超えないことをお勧めします。

値は開区間 (0, 1) 内である必要があります。

Gain

Float

いいえ

最大ゲイン係数。値の範囲は 1.0 から 100.0 です。デフォルト値は 10.0 です。

動的オーディオノーマライザーは、クリッピングや歪みを引き起こさない各入力フレームの最大可能 (ローカル) ゲイン係数を決定します。

エフェクトタイプ: FreezeFrame (フリーズフレーム)

このエフェクトは、ビデオトラック上のビデオ素材に適用されます。ビデオの最後のフレームをフリーズさせます。

説明

このエフェクトは、ビデオトラック上のビデオ素材にのみ適用されます。ビデオトラック上のイメージ素材やオーディオトラック上の素材には適用されません。

エフェクトタイプ: トランジションエフェクトと併用することはできません。

タイムラインの例: ビデオのフリーズフレーム

名前

タイプ

必須

説明

Duration

Float

いいえ

フリーズフレームの期間 (秒単位)。デフォルト値は 0 です。