# 動画の深度

> どんな動画も、近くが明るく遠くが暗い深度動画に変えます。Video Depth Anything またはフレームごとの Depth Anything で、グレースケールやカラーマップで出力します。

Source: https://nodaro.ai/ja/docs/nodes/video/video-depth

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

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

## クイックスタート
### ノードを追加する
キャンバス上で Tab を押し、**動画 › 延長とスタイル変更 › 動画の深度**を選びます。

### 動画を接続する
[**動画アップロード**](https://nodaro.ai/docs/nodes/video/upload-video)や[**動画生成**](https://nodaro.ai/docs/nodes/video/generate-video)などの動画ノードの出力から、**動画**入力までドラッグします。

### モデルと見た目を選ぶ
設定パネルを開きます。**プロバイダー**、**モデルサイズ**、**カラーマップ**を選びます。結果をほかのノードに渡すときは、**グレースケール**のままにします。

### 実行する
ノードの**実行**をクリックします。ノードのカードに深度動画が表示され、「深度マップ · Video Depth Anything」のように、モデルの名前を含むキャプションが付きます。

Workflow: アップロードしたクリップが、近くが明るく遠くが暗いグレースケールの深度動画になり、その深度動画が保存されます。

- 動画アップロード → 動画の深度 (動画)
- 動画の深度 → ストレージに保存

## 入力
| 入力 | 受け付けるもの | 役割 |
| --- | --- | --- |
| **動画** | 動画ノード | 深度動画に変えるクリップです。必須です。長さで料金が決まり、選んだモデルの上限以内である必要があります。 |

## 出力
| 出力 | 内容 |
| --- | --- |
| **動画** | MP4 の深度動画です。**グレースケール**では、近くが明るく遠くが暗くなります。**横並び**をオンにすると、元の動画と深度が 1 本の動画の中に並びます。 |

## 設定
| 設定 | デフォルト | 役割 |
| --- | --- | --- |
| **プロバイダー** | **Video Depth Anything** | モデルです。**Video Depth Anything** はフレーム間で一貫しています。**Depth Anything（フレームごと）** はフレームを 1 枚ずつ処理するため、ちらつくことがあります。 |
| **モデルサイズ** | **大（最高品質）** | **小（最速）**、**標準**、**大（最高品質）**。サイズが大きいほど細部まで表現でき、処理は遅くなります。 |
| **カラーマップ** | **グレースケール** | 深度の色付けです。Video Depth Anything では、**グレースケール**、**ターボ**、**インフェルノ**、**マグマ**、**ビリディス**を選べます。Depth Anything（フレームごと）では、**グレースケール**と**インフェルノ**を選べます。 |
| **解像度** | **自動** | Video Depth Anything のみ。**自動**、360p、480p、720p、1080p。 |
| **横並び** | オフ | Video Depth Anything のみ。元の動画と深度を、1 本の動画の中に並べます。 |

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

## モデル
| Model | Maker | Modes | Credits | Details |
| --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | Depth Anything | Video depth | 330 から | Temporally consistent depth video from any clip. Grayscale or colormapped, up to 2,400 frames or 300 seconds. |
| [Depth Anything (per frame)](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | Depth Anything | Video depth | 33 から | Depth Anything v1 run on each frame. Grayscale or inferno colormap; may flicker between frames. Up to 80 s. |

| モデル | フレーム間 | 設定 | 最長のクリップ |
| --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | 一貫している | 5 つすべて | 2,400 フレーム、かつ最大 300 秒 |
| [Depth Anything（フレームごと）](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | フレームを 1 枚ずつ処理し、ちらつくことがある | **モデルサイズ**と、**グレースケール**または**インフェルノ**の**カラーマップ** | 80 秒 |

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

| モデル | 15 秒 | 30 秒 | 1 分 | 2 分 | 5 分 |
| --- | --- | --- | --- | --- | --- |
| [Video Depth Anything](https://nodaro.ai/docs/models/video/video-depth-anything) | 330 | 660 | 1,320 | 2,640 | 6,600 |
| [Depth Anything（フレームごと）](https://nodaro.ai/docs/models/video/depth-anything-per-frame) | 33 | 66 | 132 | 264 | — |

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

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

## トラブルシューティング
| メッセージまたは問題 | 原因と対処 |
| --- | --- |
| クリップが長すぎるとして拒否される（`video_too_long`）。 | クリップが、選んだモデルの受け付ける長さを超えています。Video Depth Anything は、フレームレートに関係なく、最大 2,400 フレーム、かつ最大 300 秒まで受け付けます。フレームレートを持たないクリップは、30 fps として数えます。Depth Anything（フレームごと）は最大 80 秒までです。クリップをトリミングして、もう一度実行してください。クレジットは確保されません。 |
| クリップが読み取れないとして拒否される（`video_unreadable`）。 | Nodaro がクリップを読み取れず、長さを測定できませんでした。リンクが動画ファイルへの直接リンクかどうかを確認するか、ファイルをもう一度アップロードしてください。クレジットは確保されません。 |
| フレーム間で深度がちらつく。 | Depth Anything（フレームごと）は、フレームを 1 枚ずつ処理します。フレーム間で一貫している **Video Depth Anything** を選んでください。 |
| 選んだカラーマップが結果に反映されない。 | モデルがそのカラーマップを描画できないため、**グレースケール**で実行されました。Depth Anything（フレームごと）で選べるのは、**グレースケール**と**インフェルノ**だけです。 |

## 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` のいずれかです。

```http
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 では、ノードをそのタイプで実行します。

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

CLI では次のとおりです。

```bash
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` は省略できます。詳しくは、[単一ノードの実行](https://nodaro.ai/docs/developers/api/nodes)、[SDK のノードリファレンス](https://nodaro.ai/docs/developers/sdk/nodes)、[CLI のコマンド](https://nodaro.ai/docs/developers/cli/commands)、[MCP ツール](https://nodaro.ai/docs/mcp/tools)を参照してください。

## よくある質問

### 「動画の深度」ノードは何を作りますか？

「動画の深度」ノードは、動画を同じクリップの深度動画に変えます。近くのものは明るく、遠くのものは暗くなります。結果は MP4 で、ほかのノードに渡すことも、そのまま見ることもできます。

### 「動画の深度」ノードでは、どのモデルを選べばよいですか？

ほとんどの用途には Video Depth Anything を選んでください。フレーム間で一貫していて、すべての設定を使えます。Depth Anything（フレームごと）は安価ですが、フレームを 1 枚ずつ処理するため深度がちらつくことがあり、受け付けるクリップは最大 80 秒です。

### 動画の長さに上限はありますか？

Video Depth Anything は最大 2,400 フレーム、かつ最大 300 秒まで受け付けます。30 fps なら約 80 秒です。Depth Anything（フレームごと）は最大 80 秒までです。これより長いクリップは、クレジットを確保する前に拒否されます。

### 「動画の深度」の実行の料金は、どのように決まりますか？

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

### グレースケールとカラーマップのどちらを使えばよいですか？

深度動画をほかのノードに渡すときは、デフォルトのグレースケールのままにしてください。ターボやインフェルノなどのカラーマップは、深度を見るためのものです。