動画の深度

動画の深度ノードは、動画を深度動画に変えます。近くは明るく、遠くは暗く表示されます。すべてのフレームの深度を推定し、同じクリップの MP4 として深度をレンダリングします。グレースケールの結果を、深度に基づく生成、ライティングの変更、合成に渡せます。スタイルを付けた見た目にしたいときは、カラーマップを選びます。

使いどころ

• 合成のために、クリップの深度パスが必要なとき。たとえば、前景と背景のあいだにレイヤーを置く場合です。
• ほかの生成やライティングの変更のガイドとして、深度動画を使いたいとき。
• タイトルや SNS 用のクリップに、ターボやインフェルノのカラーマップなど、スタイルを付けた深度の見た目を使いたいとき。
• 元のクリップとその深度を、横並びで比べたいとき。

クイックスタート

入力

出力

設定

設定パネルには、選んだモデルが受け付ける設定だけが表示されます。モデルが受け付けない設定は無視され、モデルが描画できないカラーマップはグレースケールになります。どちらの場合も実行は拒否されないため、フィールドマッピングでモデルが切り替わっても実行できます。

モデル

クレジット

料金はモデルと入力クリップの長さで決まります。長さは、15 秒、30 秒、1 分、2 分、5 分のうち、次の段階に切り上げられます。

• 段階の決まり方。 5 秒のクリップも 15 秒のクリップも、15 秒の段階です。15.01 秒のクリップは 30 秒の段階、61 秒のクリップは 2 分の段階になります。
• クリップは実行前に測定されます。 読み取れないクリップは、クレジットを確保する前に拒否されます。推測した長さで料金が決まることはありません。
• ノードに表示される料金。 接続した動画の長さがわかるまで、ノードには 15 秒の段階が表示されます。長さのわかる動画を接続すると、料金が更新されます。
• Depth Anything（フレームごと）。 このモデルが受け付けるクリップは最大 80 秒なので、1 回の実行の料金は最大でも 2 分の段階です。

ヒント

• ほかのノードにはグレースケールを使います。 グレースケールは、ほかのノードの入力に最適です。カラーマップは見るためのものです。
• 小で確認し、大で仕上げます。 クリップをすばやく確認するには小（最速）を、最終版には大（最高品質）を使います。
• 先にトリミングします。 料金は入力クリップの長さで決まります。「動画の深度」の前に、動画のトリミングで必要な部分だけにクリップを切ります。
• 動きのあるショットには Video Depth Anything を選びます。 Depth Anything（フレームごと）はフレームを 1 枚ずつ処理するため、フレーム間で深度がちらつくことがあります。

トラブルシューティング

API から

POST /v1/video-depth は videoUrl を受け取り、provider、modelSize、colormap、resolution、sideBySide は省略できます。provider は video-depth-anything（デフォルト）または depth-anything-frames、modelSize は small、base、large（デフォルト）のいずれかです。colormap は grayscale、turbo、inferno、magma、viridis、resolution は auto、360p、480p、720p、1080p のいずれかです。

POST /v1/video-depth
Content-Type: application/json

{
  "videoUrl": "https://example.com/clip.mp4",
  "provider": "video-depth-anything",
  "modelSize": "large",
  "colormap": "grayscale"
}

応答は { jobId } で、完了したジョブの出力は { videoUrl, thumbnailUrl } です。モデルが受け付けない設定は無視され、モデルが描画できないカラーマップは grayscale になります。上の一覧にない値は 400 validation_error になります。クリップは何かが作られる前に測定され、400 video_too_long と 400 video_unreadable では何も確保されません。

SDK では、ノードをそのタイプで実行します。

const result = await client.nodes.run("video-depth", {
  videoUrl: "https://example.com/clip.mp4",
  colormap: "grayscale",
})

CLI では次のとおりです。

nodaro nodes run video-depth --param videoUrl=https://example.com/clip.mp4 --watch

AI アシスタントからは、MCP ツール video_depth を使います。video_url または video_asset_id を渡し、provider、model_size、colormap、resolution、side_by_side は省略できます。詳しくは、単一ノードの実行、SDK のノードリファレンス、CLI のコマンド、MCP ツールを参照してください。