NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
動画

動画オーバーレイ

最大 20 個の画像や動画のレイヤーを、それぞれ指定した時間だけ動画に重ねます。動画を縦に重ねるレイアウトやピクチャーインピクチャーも使えます。ライブプレビューで確認でき、オーディオはそのまま残ります。

動画オーバーレイノードは、動画の上に画像や動画を重ね、それぞれを指定した時間だけ表示します。ロゴ、商品写真、スクリーンショット、ナレーションに合わせたカードなどに使います。また、2 つの動画を組み合わせるとき(縦長のフレームの下に横長のクリップ、2 つのクリップを縦に重ねる、ピクチャーインピクチャー)にも使います。ノードはファイルをそのまま正確に動画の上に描き、元のオーディオを残し、ノード上にライブプレビューを表示します。これらはすべて、AI モデルを使わずに行われます。

使いどころ

  • UGC 広告で、話し手が商品カード、アプリのスクリーンショット、Web ページに触れている間に、それらを表示します。
  • 動画全体を通して、ロゴやチャンネルのハンドル名を画面に表示します。
  • 縦長のフレームの下に横長のクリップを置き、その上にタイトルカードを表示します。
  • リアクションやビフォーアフターのために、2 つのクリップを縦に重ねます。
  • ゲスト、画面録画、カメラのインセットなど、固定のピクチャーインピクチャーを表示します。
  • 商品のクリップに、値札や「NEW」(新着)バッジを重ねます。

クイックスタート

ノードを追加する

キャンバス上で Tab を押し、動画 › タイトル、グラフィック、字幕 › 動画オーバーレイを選びます。

動画とレイヤーを接続する

ベースの動画を動画入力に接続します。各画像または動画を、それぞれのレイヤーの入力(レイヤー 1、レイヤー 2 など)に接続します。ノードには、最初はレイヤーの入力が 4 つあります。

レイアウトを選び、各レイヤーのタイミングと位置を決める

設定パネルを開きます。2 つの動画を組み合わせるときは、先にレイアウトを選びます。レイヤーごとに開始(秒)と終了(秒)を設定し、配置を選びます。ノードのプレビューでレイヤーをドラッグすると移動でき、角のハンドルを引っ張るとサイズを変えられます。

実行する

実行をクリックします。ノードが、すべてのレイヤーをそれぞれの時間に表示した動画をレンダリングします。プレビューのラベルが、プレビューから結果に変わります。

動画レイヤー 1レイヤー 2動画動画アップロード9:16 の自撮り画像アップロード料金ページのスクリーンショット画像アップロードロゴの PNG動画オーバーレイカード + コーナーバッジ字幕を追加TikTok 投稿
スクリーンショットがカードとしてポップアップし、ロゴは隅に表示され続けます。その上に字幕を重ねてから、動画を投稿します。

入力

入力接続できるノード説明
動画動画アップロード、動画生成などの動画ノードベースの動画です。必須です。
レイヤー 1〜レイヤー 12画像アップロード、画像生成、画像オーバーレイなどの画像ノードと、動画アップロード、動画生成などの動画ノードレイヤーごとに 1 枚の画像または 1 本の動画です。レイヤー 1 が 1 番目の入力、レイヤー 2 が 2 番目の入力というように続きます。
レイヤープランレイヤーの JSON リスト任意です。それぞれ独自の画像または動画の URL を持つ、タイミング付きのレイヤーを追加します。レイヤープラン入力を参照してください。

出力の動画は、レイヤーを描き込んだ動画で、形式は MP4 です。

設定パネルの + レイヤーと − レイヤーボタンで、表示するレイヤーの入力の数を 1〜12 の範囲で変えられます。番号の大きい入力に接続したときも、数は自動で増えます。レイヤーには、接続の代わりに画像または動画の URL を持たせることもできます。API、MCP、テンプレートはこれを使い、レイヤー 13 以降もこの方法で作られます。レイヤーの入力にノードを接続すると、その URL は置き換えられます。

レイヤープラン入力

レイヤープラン入力には、ノード自身のレイヤー形式で書いたレイヤーの JSON リストを渡します。形式は imageUrl または videoUrl、start、end、sound と、ボックスのフィールド anchor、x、y、width、height、fit です。たとえば、UGC カードのように、スクリーンショットのカードをナレーションに合わせてタイミングを決めるノードと組み合わせて使います。

  • プランのレイヤーは、入力のレイヤーの下に描かれます。そのため、入力につないだロゴのバッジは上に表示されたままです。
  • プランの各レイヤーには、独自の imageUrl または videoUrl が必要です。プランのレイヤーが入力からファイルを受け取ることはありません。どちらもないプランのレイヤーは、実行を失敗させます。メッセージは「Plan layer 1: no image or video」(プランのレイヤー 1:画像も動画もありません)で始まります。
  • プランのレイヤーも上限に数えられます。プランのレイヤーと入力のレイヤーは、合わせて最大 20 個で、そのうち動画のレイヤーは合わせて最大 2 個です。
  • プレビューにはプランのレイヤーも表示されます。読み取り専用のレイヤーで、レイヤープランからと表示されます。
  • 空のプランでは、動画がそのまま出力されます。レイヤープランが接続されていて描くレイヤーがない場合、ノードは動画を変更せずに、無料で出力します。

ライブプレビュー

ベースの動画を接続すると、ノードにその動画の 1 フレームが表示され、レンダリング時と同じ位置にレイヤーが描かれます。動画のレイヤーは、最初のフレームが表示されます。

  • レイヤーを選ぶ:設定パネルのタイムラインで、レイヤーのバーをクリックします。プレビューはそのレイヤーの開始位置に移動し、その時点で表示されているレイヤーだけを表示します。
  • レイヤーをドラッグする:ドラッグで移動し、角のハンドルを引っ張ってサイズを変えます。ドラッグするたびに新しいパーセント値がレイヤーの設定に書き込まれるので、プレビューと実行では同じ数値が使われます。
  • ベース動画を動かす:ベース動画のカードのプレビューで移動で選んでから、同じように動かします。ベース動画を参照してください。
  • 結果と結果(古い):実行が終わると、ノードに結果と表示されます。ノード自体の実行、ワークフローの実行、スケジュール、Webhook、アプリの実行など、どの方法で始めた実行でも同じです。その後、レイヤーを動かしたり、別の画像や動画を接続したり、別のレイアウトを選んだりして設定を変えると、もう一度実行するまで、ラベルは結果(古い)になります。

レイヤーの設定

設定パネルでは、各レイヤーに専用のカードがあり、レイヤー 1、レイヤー 2 などの見出しが付いています。

設定説明
開始(秒)レイヤーが表示される時点を、動画の先頭からの秒数で指定します。デフォルトは 0 です。
終了(秒)レイヤーが消える時点です。開始(秒)より後にする必要があります。空欄にすると、動画の最後までレイヤーが表示されます。
配置カード、コーナーバッジ、全画面、カスタムのいずれかです。接続したまま変更していないレイヤーは、動画全体を通して右下のコーナーバッジになります。
コーナーコーナーバッジ用です。左上、右上、左下、右下(デフォルト)のいずれかです。
アンカー、オフセット X、オフセット Y、幅、高さ(フレームに対する %、任意)、フィット(高さを指定した場合)カスタム用です。カスタムのボックスを参照してください。
レイヤーの順序(z)0〜100 です。値が大きいレイヤーほど上に描かれます。空欄の場合はレイヤー番号が使われるので、レイヤー 1 が最も下になります。プレビューの上下のボタンでも設定できます。
不透明度0〜100% です。デフォルトは 100% です。
表示・非表示をアニメーションレイヤーは 0.15 秒かけて、大きさを 96% から 100% に広げながらフェードインし、終了時にはその逆の動きをします。画像のレイヤーではデフォルトでオン、動画のレイヤーではオフです。
音声 › この動画の音声を再生、音量動画のレイヤー専用です。デフォルトはオフです。音声を参照してください。

動画のレイヤーで表示・非表示をアニメーションがデフォルトでオフなのは、フェードが、縦に重ねた動画やインセットの動画の最初と最後に見えてしまうためです。レイヤーの入力では、デフォルトは接続したものに従います。動画を接続すると、オンにしない限りフェードはオフです。

配置

位置とサイズは、すべて出力フレームに対するパーセントです。

配置レイヤーの位置
カード中央揃えで、中心より 4% 上に置かれ、フレームの 78% × 60% の範囲内に収まります。画像または動画のアスペクト比は保たれます。
コーナーバッジフレームの幅の 18% の大きさで、選んだ隅から 4% 内側に配置されます。
全画面フレーム全体を覆います。画像または動画は、フレームを埋めるように切り抜かれます。
カスタム自分で指定したボックスです。

カードはフレームの中央に重なるため、9:16 の自撮り動画では話し手の顔の上に来ます。これは意図的なもので、話している人の上に商品カードがポップアップするようにしています。被写体を隠してはいけないロゴやバッジは、コーナーバッジかカスタムのボックスに配置します。

カスタムのボックス

  • アンカーは、フレーム上でレイヤーを固定する 9 つの位置のいずれかです。
  • オフセット X とオフセット Y は、レイヤーをアンカーから移動させます。範囲は、フレームの幅と高さの −100〜100% です。右または下のアンカーでは、オフセットを負の値にするとレイヤーが内側に移動します。
  • 幅は、フレームの幅の 1〜100% です。
  • 高さ(フレームに対する %、任意)は、フレームの高さの 1〜100% です。指定しない場合、高さは画像または動画のアスペクト比に従います。
  • フィット(高さを指定した場合)は、レイヤーでボックスをどう埋めるかを決めます。全体を収めるは、画像または動画の全体を中央に表示します。領域を埋めるは、ボックスを埋めるように切り抜きます。

ボックスの項目を 1 つでも設定すると、プリセットの配置を使っているレイヤーはカスタムに変わります。プレビューでプリセットの配置のレイヤーをドラッグしたり、サイズを変えたりした場合も同じです。高さがアスペクト比に従う縦長の画像は、常にフレーム内に収まるように調整されます。たとえば、1080×1920 の動画で幅 60% に設定した 1:10 の画像は、192×1920 で描かれます。描画サイズは偶数ピクセルに切り下げられ、最小でも 2×2 です。

タイミングのルール

  • 時間は、動画の先頭からの秒数で、0〜3,600 です。入力した精度のまま保持されますが、レンダリングでは動画のフレームの区切りに合わせて配置されるため、レイヤーが最大 1 フレーム早く、または遅く表示されることがあります。
  • 終了(秒)が動画の終わりより後のレイヤーは、動画の終わりで切り詰められます。
  • 動画の終わりと同時か、それより後に始まるレイヤーはスキップされ、そのファイルはダウンロードされません。
  • 0.3 秒より短いレイヤーでは、フェードインとフェードアウトに、それぞれレイヤーの長さの半分が使われます。

パネルは、ブラウザーが読み取った長さを使って、切り詰められるレイヤーやスキップされるレイヤーについて入力中に警告します。この長さは、動画本来の長さと数百分の 1 秒ずれることがあるため、最終的な判断は実行時の警告に従ってください。

動画のレイヤー

レイヤーには画像か動画のどちらかを指定し、両方は指定できません。API では、レイヤーに imageUrl または videoUrl を指定し、両方を指定したレイヤーは拒否されます。1 回の実行で使える動画のレイヤーは最大 2 個です。それ以外は画像のレイヤーと同じように働きます。ボックス、開始(秒)、終了(秒)、不透明度、レイヤーの順序(z)です。画像を動画の上に置くこともでき、ベース動画は常に最も下です。

  • 動画のレイヤーは、レイヤーの開始(秒)から、その動画自体の最初のフレームから再生されます。
  • レイヤーの終了(秒)で止まります。レイヤーに終了がない場合は、ベース動画の終わりで止まります。
  • レイヤーの動画のほうが短い場合は、最後のフレームを表示し続けます。ウィンドウが終わるまでです。
  • フィットは、画像と同じように働きます。全体を収めるは動画全体をボックスに表示し、領域を埋めるはボックスを埋めるように切り抜きます。高さを指定しない場合、ボックスは動画自体の形に従います。
  • 出力は、ベース動画のフレームレートを保ちます。フレームレートの異なるレイヤーの動画は、ベース動画のフレームレートで描かれます。
  • レイヤーの入力では、接続したものによって、レイヤーが画像か動画かが決まります。

音声

  • デフォルトでは、再生されるのはベース動画の音声だけです。動画のレイヤーがない場合とまったく同じです。
  • 動画のレイヤーは、その音声をオンにしない限り無音です。キャンバスでは、レイヤーの音声セクションを開き、この動画の音声を再生をオンにしてから、音量を 0〜100% で設定します。API では、sound: { volume } を 0〜1 で設定します。1 は録音されたままの音量です。
  • レイヤーの音声は、レイヤーのウィンドウの間、ベース動画の音声とミックスされます。音量は設定した値です。ミックスはリミッターを通るので、大きな音源が 2 つ全音量で重なっても音割れしません。通常のレベルは上げも下げもされません。
  • ミックスしたサウンドトラックは AAC で、動画と同じ長さです。ベース動画が無音の場合、サウンドトラックはレイヤーの音声だけになり、残りは無音で埋められます。
  • 音声トラックのないレイヤーの動画は無音で描かれ、実行では layer_no_audio の警告が報告されます。
  • 音声は動画のレイヤー専用です。API では、画像と sound を指定したレイヤーは拒否されます。実行時に画像を受け取ったレイヤーの入力では、保存されている音声は飛ばされ、実行はそのまま進みます。

レイアウト

レイアウトは、1 つの選択で、ベース動画、最初の動画のレイヤー、またはその両方を配置します。最初の動画のレイヤーとは、レイヤーの順序で最も下にある動画のレイヤーです。画像のレイヤーは、配置した場所のままです。キャンバスでは、設定パネルの上部にあるレイアウトで選びます。カスタムはレイアウトなしを意味します。API、MCP、SDK、CLI では、リクエストの layout フィールドです。

レイアウトlayoutベース動画最初の動画のレイヤー必要なもの
動画を下にvideo-bottom全体を、全幅で下端に寄せる配置しない出力のアスペクト比
動画を上にvideo-top全体を、全幅で上端に寄せる配置しない出力のアスペクト比
縦に重ねる(全体)stack-whole全体を、最初の動画のレイヤーのすぐ上に置く全体を、ベース動画のすぐ下に置く出力のアスペクト比と動画のレイヤー
縦に重ねる(フィル)stack-filled上半分を、埋めるように切り抜いて置く下半分を、埋めるように切り抜いて置く出力のアスペクト比と動画のレイヤー
ピクチャー・イン・ピクチャーpipレイアウトがない場合と同じフレームの幅の 30% で、コーナーから 4% 内側(デフォルトは右下)動画のレイヤー
カスタムなし配置したとおり配置したとおりなし
  • 縦に重ねる(全体)は、両方の動画の全体を同じ幅で、接するように表示します。2 つは中央に配置され、上下の余白は同じになります。2 つの動画を合わせた高さがフレームより大きい場合だけ、2 つが一緒に縮小されます。1080×1920 のフレームでは、16:9 の動画 2 つがそれぞれ 1080×606 で描かれ、上下に 354 ピクセルの余白ができます。
  • 1080×1920 のフレームでの縦に重ねる(フィル)は、上半分(y 0〜960)をベース動画で、下半分(y 960〜1920)を動画のレイヤーで埋めます。どちらも切り抜かれます。
  • 1080×1920 のフレームで 16:9 のベース動画に動画を下にを使うと、ベース動画は y 1314〜1920 に、下端に寄せて描かれます。その上の画像のレイヤーは、配置した場所に置かれます。
  • 動画を下にと動画を上にには、動画のレイヤーは不要です。画像のレイヤーだけなら、実行は画像だけの料金のままです。
  • ピクチャー・イン・ピクチャーは、最初の動画のレイヤーのコーナーを使い、そのレイヤーが持っていたボックスを置き換えます。
  • ピクチャー・イン・ピクチャーと 2 つの縦に重ねるレイアウトでは、最初の動画のレイヤーのフェードがオフになります。動画を下にと動画を上にでは、すべてのレイヤーがそのままです。

次のリクエストは拒否されます:

  • 出力のアスペクト比が必要なレイアウトで、それがない場合:「layout video-bottom needs an outputAspect」(レイアウト video-bottom には outputAspect が必要です)。
  • 動画のレイヤーが必要なレイアウトで、それがない場合:「layout pip needs a video layer — set videoUrl on a layer or connect a video to a layer's handle」(レイアウト pip には動画のレイヤーが必要です。レイヤーに videoUrl を設定するか、レイヤーの入力に動画を接続してください)。
  • ベースのボックスを指定した、縦に重ねるレイアウト。縦に重ねるレイアウトは、ベース動画を自分で配置するためです:「A stack layout places the base itself — remove baseBox or choose Custom」(縦に重ねるレイアウトはベース動画を自分で配置します。baseBox を削除するか、カスタムを選んでください)。

自分で設定したベースのボックスは、動画を下にと動画を上により優先されます。

キャンバスでは:

  • 出力のアスペクト比が必要なレイアウトを、それが設定されていないときに選ぶと、出力のアスペクト比が 9:16 に設定されます。
  • どのレイアウトを選んでも、自分で配置したベースのボックスは削除されます。
  • レイヤーを動かしたりサイズを変えたりする、配置を変える、またはベース動画を動かすと、レイアウトはカスタムになります。すべてはその場所のままです。
  • ピクチャー・イン・ピクチャーまたは縦に重ねるレイアウトで、最初の動画のレイヤーのフェードを変えた場合も、レイアウトはカスタムになります。

ベース動画

デフォルトでは、ベース動画は出力の設定で説明するとおりに出力を埋めます。出力のアスペクト比を指定すると、ベースのボックスでベース動画を自分で配置することもできます。ベースのボックスは、レイヤーのカスタムのボックスと同じフィールドを使います。アンカー、オフセット X、オフセット Y、幅、任意の高さ、フィットです。API では baseBox で、anchor と width は必須、x と y のデフォルトは 0、fit のデフォルトは contain です。ベースのボックスは動画のフィットより優先されます。フレームのうちベース動画が覆わない部分には、余白の色が表示されます。出力のアスペクト比のないベースのボックスは拒否されます:「baseBox needs an outputAspect」(baseBox には outputAspect が必要です)。

設定パネルのベース動画のカードには、ベース動画の配置が表示されます:

  • 出力のアスペクト比がない場合、ベース動画を動かすにはそれが必要であることが表示されます。
  • 縦に重ねるレイアウトの場合、レイアウトがベース動画を配置していることが表示されます。2 つの動画の形が読み取られると、プレビューで移動が表示されます。
  • 動画のフィットで配置されている場合、プレビューで移動が表示されます。
  • 動画を下にまたは動画を上にで、独自のボックスがない場合、レイアウトのボックスがフィールドとして、プレビューで移動とともに表示されます。フィールドを編集すると、レイアウトはカスタムになります。
  • 独自のボックスがある場合、ボックスのフィールドとリセットが表示されます。リセットはボックスを削除するので、ベース動画は再び動画のフィットで配置されます。

プレビューで移動を押すと、ベース動画が選択されます。その後は、レイヤーと同じようにプレビューでドラッグやサイズの変更ができ、最初に動かしたときに独自のボックスが作られます。どのレイアウトでも、最初に動かすとレイアウトはカスタムになり、すべてはその場所のままです。ベース動画が選択されていない間は、プレビューでクリックを受け付けないので、ノードの本体をドラッグすると、これまでどおりノードが動きます。

出力の設定

設定説明
レイアウト動画を下に、動画を上に、縦に重ねる(全体)、縦に重ねる(フィル)、ピクチャー・イン・ピクチャー、カスタム(デフォルト)のいずれかです。レイアウトを参照してください。
出力のアスペクト比動画と同じ(デフォルト)、16:9(1920×1080)、9:16(1080×1920)、1:1(1080×1080)、4:5(1080×1350)のいずれかです。出力のアスペクト比を指定すると、レイヤーのパーセントはその新しいフレームに対する値になります。動画と同じを選ぶと、ベースのボックスと、アスペクト比が必要なレイアウトも削除されます。
動画のフィット出力のアスペクト比を指定した場合のみ。領域を埋める(デフォルト)は、フレームを埋めるように動画を切り抜きます。全体を収めるは、動画全体を表示し、余白を加えます。ベースのボックスやレイアウトがある場合は、それがベース動画を配置します。
余白の色全体を収めるの場合、またはベースのボックスの周り。余白の色です。デフォルトは黒です。

出力のアスペクト比を指定しない場合、結果は動画本来の表示サイズとフレームレートを保ちます。横向きに保存されたスマートフォンのクリップは正しい向きでレンダリングされ、正方形でないピクセルは補正されます。また、奇数の寸法は偶数に切り下げられるため、1079×1919 の元動画は 1078×1918 でレンダリングされます。

結果は H.264 の MP4 で、ダウンロードが完了する前に再生を始められます。ベース動画のオーディオトラックは最初の 1 本だけが残り、オーディオのない動画は無音のままです。ただし、音声をオンにした動画のレイヤーがある場合は別です。音声を参照してください。

制限

  • レイヤー:1 回の実行につき 1〜20 です。画像または動画があるレイヤーが 20 を超えるノードは、実行前に拒否され、実行ボタンにその旨が表示されます。レイヤーを削除して 20 以下に戻してください。残ったレイヤーの番号は変わりません。レイヤーが知らないうちに除外されることはなく、料金もかかりません。
  • 動画のレイヤー:1 回の実行につき最大 2 個です。それより多いリクエストは拒否されます。たとえば「At most 2 video layers (got 3)」(動画のレイヤーは最大 2 個です(3 個指定されました))です。
  • 動画のレイヤーがある場合のベース動画の長さ:最長 60 秒です。ベース動画は、API でもワークフローの実行でも、課金の前に計測されます。それより長いベース動画は、「The base video is 61 seconds. A Video Overlay with a video layer takes a base of up to 60 seconds — trim it first.」(ベース動画は 61 秒です。動画のレイヤーがある動画オーバーレイのベース動画は 60 秒までです。先にトリミングしてください)で拒否されます。読み取れないベース動画は、「Could not read the base video. The file may be corrupted or an unsupported format.」(ベース動画を読み取れませんでした。ファイルが壊れているか、対応していない形式の可能性があります)で拒否されます。キャンバスでは、60 秒を超えるベース動画について設定パネルが警告し、サーバーの計測で最終的に決まります。画像のレイヤーだけの実行には、長さの制限はありません。
  • 動画のリンク:リンクは、ストリーミングのプレイリスト(HLS や DASH)ではなく、通常の動画ファイルを指している必要があります。そのようなリンクは、何も請求される前に拒否されます。メディアのリンクを参照してください。
  • レイヤーの動画:1 本あたり 200 MB までです。それより大きいものは実行を失敗させます。たとえば「Layer 2: video is too large (over 200 MB)」(レイヤー 2:動画が大きすぎます(200 MB 超))です。ダウンロードできない動画は「Layer 2: video could not be fetched」(レイヤー 2:動画を取得できませんでした)で失敗します。画像、オーディオファイル、Web ページなど動画でないファイルは「Layer 2: not a video」(レイヤー 2:動画ではありません)で失敗します。
  • 画像:PNG、JPEG、WebP です。1 枚あたり 25 MB まで、合計 100 MB まで、長辺は 8,192 ピクセルまで、合計 400 メガピクセルまでです。カメラが記録した写真の向きが適用されます。
  • SVG は受け付けない:先に画像オーバーレイで SVG を PNG に変換してください。
  • アニメーション画像:アニメーション WebP や APNG などは、最初のフレームが表示されます。
  • ベースは動画であること:オーディオファイル、画像、.mp4 として保存された Web ページは、「The base input is not a video」(ベース入力が動画ではありません)というエラーで失敗します。
  • 開始が遅すぎる縦に重ねた動画:縦に重ねるレイアウトで、最初の動画のレイヤーがベース動画の終わりと同時か、それより後に始まる場合、課金の前に拒否されます。
  • レンダリング時間:レンダリングは 10 分で停止します。
  • API のレート:ユーザーごとに 1 分あたり 30 リクエストまでです。

警告

実行が成功しても、警告が報告されることがあります。設定パネルでは、警告が前回の実行の 1 行にまとめて表示されます。

警告API コード意味
切り詰めclippedレイヤーの終了が動画の終わりより後だったため、動画の終わりまで表示されました。
スキップskippedレイヤーの開始が動画の終わりと同時か、それより後だったため、描画されませんでした。
アニメーション画像animated_first_frame画像がアニメーション WebP だったため、最初のフレームが使われました。
オーディオの再エンコードaudio_reencoded動画のオーディオをそのまま MP4 にコピーできなかったため、AAC に再エンコードされました。
音声のないレイヤーlayer_no_audio動画のレイヤーの音声がオンでしたが、その動画に音声がなかったため、何もミックスされませんでした。

すべてのレイヤーが動画の終わりより後に始まる場合は、警告ではなく実行が失敗し、「Every layer starts after the video ends」(すべてのレイヤーが動画の終了後に始まります)というメッセージが表示されます。動画のレイヤーがある場合、これは課金の前に確認されます。レイヤーの画像をダウンロードできない場合も、実行は失敗します。たとえば「Layer 3: image could not be fetched」(レイヤー 3:画像を取得できませんでした)と表示されます。失敗した実行には料金がかかりません。

クレジット

  • 画像のレイヤーだけ:レイヤーの数や動画の長さにかかわらず、1 回の実行につき 22 クレジットです。
  • 動画のレイヤーが 1 つでもある場合:実行の料金は、ベース動画(出力の長さでもあります)の 5 秒(開始した単位)ごとに決まります。整数秒を 0.05 秒以内だけ超えた端数は無視されるので、10.01 秒のベース動画は 3 単位ではなく 2 単位として数えられます。長さはベース動画の映像の長さです。動画ストリーム自体の長さ、なければ DURATION タグ(WebM や MKV では、映像の長さはそこにしか書かれません)、それもなければ最後のフレームの終わりです。そのどれも読み取れない場合に限り、ファイル全体の長さから 0.15 秒を引いた長さが使われます。作られたクリップの音声で、ファイルが映像よりその分長くなることがあるためです。

料金を決めるのは、レイアウトではなく、動画のレイヤーがあるかどうかです。画像のレイヤーだけで動画を下にを使っても、画像だけの料金のままです。

実行ボタンには、実行前に料金が表示されます。動画のレイヤーがある実行では、実行ボタン、ノードの料金、ワークフローの見積もり(エディター、POST /v1/credits/estimate-workflow、MCP)が、すべて同じベースの長さを読み取ります。アップロードしたベースやライブラリから追加したベースは、記録された長さで見積もられます。同じ実行の中でほかのノードが作るベースは、そのノードが作る長さで見積もられます。生成では設定した長さ、自動ではモデルの最長のクリップの長さです。動画を延長では、元の動画に追加する秒数を足した長さです。途中で作られるクリップごとに、約 1 フレーム分が加わります。PixVerse V6 の延長では、映像が予定の長さをより大きく超えるため、代わりに 0.25 秒が加わります。吹き替えでは 1 フレームだけが加わります。吹き替えで長くなる分は音声で、このノードは音声には課金しないためです。長さがわからない場合、見積もりは 60 秒の上限を使うので、見積もりが請求額を下回ることはありません。動画を渡す可能性のあるノードに接続したレイヤーの入力と、レイヤーが実行時にしかわからないレイヤープランは、動画のレイヤーがある実行として見積もられます。UGC カードのレイヤープランはカードの画像だけを持つので、画像だけの料金のままです。

レンダリングでは、ベース動画がもう一度計測されます。リンクが、料金を計算したときより長い動画を返すようになっていた場合、実行は何かを描く前に拒否され、料金は返還されます。

API では、GET /v1/credits/model-cost?model=video-overlay が画像だけの料金を、GET /v1/credits/model-cost?model=video-overlay:video が 5 秒の 1 単位の料金を返します。

失敗した実行には料金がかかりません。セルフホスティングの Community エディションにはクレジットがなく、ノードは API キーなしで実行できます。

例:話している人の上に商品カードを表示する

9:16 の自撮り動画に 3 枚の画像を重ね、話し手がそれぞれに触れている間に表示します。

レイヤー画像開始(秒)終了(秒)配置
1pricing-page.png1.22.6カード
2dashboard.png3.04.4カード
3logo.png0最後までコーナーバッジ、右上

1080×1920 の動画では、各カードのボックスは、(119, 307) の位置にある 842×1152 ピクセルの領域です。アスペクト比 1:2 のスクリーンショットは、その中の中央に 576×1152 ピクセルで描かれます。

API で同じリクエストを送る場合は、POST /v1/video-overlay を使います。

{
  "videoUrl": "https://example.com/selfie.mp4",
  "layers": [
    { "imageUrl": "https://example.com/pricing-page.png", "start": 1.2, "end": 2.6, "preset": "card" },
    { "imageUrl": "https://example.com/dashboard.png", "start": 3.0, "end": 4.4, "preset": "card" },
    { "imageUrl": "https://example.com/logo.png", "start": 0, "preset": "corner-badge", "corner": "top-right" }
  ]
}

例:動画を組み合わせる

9:16 のフレームの下に 16:9 の動画を置き、その上にカードを表示する。ベース動画は 1080×606 で、y 1314〜1920 に描かれます。カードは、その上の黒い領域に置かれます。この実行は画像のレイヤーだけなので、画像だけの料金のままです。

{
  "videoUrl": "https://example.com/talk-16x9.mp4",
  "outputAspect": "9:16",
  "layout": "video-bottom",
  "layers": [
    { "imageUrl": "https://example.com/card.png", "start": 0, "anchor": "top", "x": 0, "y": 8, "width": 80 }
  ]
}

16:9 の動画 2 つを、全体のまま縦に重ねる。各動画は 1080×606 で描かれ、上下に 354 ピクセルの余白ができます。2 つ目の動画がベース動画より短い場合は、最後のフレームを表示し続けます。

{
  "videoUrl": "https://example.com/a.mp4",
  "outputAspect": "9:16",
  "layout": "stack-whole",
  "layers": [ { "videoUrl": "https://example.com/b.mp4", "start": 0 } ]
}

インセットの音声をオンにした、固定のピクチャーインピクチャー。インセットはフレームの幅の 30% で、右上の隅から 4% 内側に置かれます。その音声は、80% でベース動画の音声とミックスされます。

{
  "videoUrl": "https://example.com/main.mp4",
  "layout": "pip",
  "layers": [ { "videoUrl": "https://example.com/guest.mp4", "start": 0, "corner": "top-right", "sound": { "volume": 0.8 } } ]
}

AI アシスタントは overlay_images MCP ツールを使います。各レイヤーには、画像なら url か asset_id を、動画なら video_url か video_asset_id を指定します。このツールは layout と base_box も受け付けます。コマンドラインからは nodaro media video-overlay を使い、動画のレイヤーは --layers-file で、--layout と --base-box のオプションとともに指定します。

ヒント

  • カードは短く、重ならないようにする:カードの表示は 1〜2 秒にします。カード同士の表示時間が重ならないようにして、画面には一度に 1 枚だけを表示します。
  • 長く表示するレイヤーは隅に置く:長い時間表示し続けるロゴ、ハンドル名、価格は、話し手から離れたコーナーバッジかカスタムのボックスに配置します。
  • ロゴには透過 PNG を使う:不透明な JPEG は、長方形のまま配置されます。
  • 動画本来のフレームを保つ:出力のアスペクト比は、元の動画と異なるフレームが必要なときだけ設定します。
  • 2 つの動画では、先にレイアウトを選ぶ:そこから調整します。
  • 先にカットする:ベースの動画を短くするには、動画オーバーレイの前に動画のトリミングを使います。動画のレイヤーがある実行では、ベース動画は最長 60 秒です。
  • レイヤーの音声は、聞かせたいときだけオンにする:音の大きいベース動画の上で全音量にする場合は、どちらかを下げてください。
  • 字幕は後から付ける:結果を字幕を追加に接続します。レイヤーは字幕の下に表示されます。
  • バッジは先にデザインする:画像オーバーレイの結果をレイヤーの入力に接続すると、テキスト、QR コード、デザインしたバッジを動画に載せられます。

よくある質問

動画オーバーレイでは、1 本の動画にいくつのレイヤーを配置できますか?

1 回の実行につき最大 20 レイヤーで、そのうち動画は最大 2 個です。キャンバス上のノードには、レイヤーの入力が最大 12 個あります。レイヤー 13〜20 には、API、MCP、テンプレートで設定した画像または動画の URL を使います。

動画の上に別の動画を重ねられますか?

はい。レイヤーには画像も動画も使えます。「動画を下に」「縦に重ねる(全体)」「縦に重ねる(フィル)」「ピクチャー・イン・ピクチャー」などのレイアウトを選ぶか、動画のレイヤーを自分で指定したボックスに配置します。動画のレイヤーがある実行では、ベース動画は最長 60 秒です。

動画オーバーレイで、動画のオーディオは変わりますか?

デフォルトでは変わりません。再生されるのはベース動画の音声だけで、AAC、MP3、AC-3、Opus の場合はそのままコピーされ、それ以外の場合は AAC に再エンコードされます。動画のレイヤーは、その音声をオンにしない限り無音で、オンにするとベース動画の音声とミックスされます。

カードが話し手の顔に重なってしまうのはなぜですか?

「カード」の配置は、意図的にフレームの中央に重なるようになっています。話している人の上に商品カードがポップアップするようにするためです。被写体を隠してはいけないロゴやバッジには、「コーナーバッジ」か「カスタム」のボックスを使います。

レイヤーには、どの画像形式を使えますか?

PNG、JPEG、WebP を使えます。サイズは 1 枚あたり 25 MB まで、合計 100 MB までです。SVG は受け付けないので、先に「画像オーバーレイ」ノードで PNG に変換してください。アニメーション画像は、最初のフレームが表示されます。レイヤーの動画は 200 MB までです。

動画オーバーレイには何クレジットかかりますか?

画像のレイヤーだけの実行は、レイヤーの数や動画の長さにかかわらず 22 クレジットです。動画のレイヤーが 1 つでもある実行は、ベース動画の 5 秒(開始した単位)ごとに料金が決まります。セルフホスティングの Community エディションでは、クレジットも API キーも使わずにノードを実行できます。

最終更新

目次